IA no seu dispositivo — profissional e privado.

Documentos

Como ordenar chaves JSON em ordem alfabética online (objetos aninhados também)

Ordene chaves JSON em ordem alfabética online, em todos os níveis ou só no primeiro. Por que uma ordem estável ajuda diffs e revisões, e o que acontece com arrays e números.

Atualizado em 8 de novembro de 20269 min de leitura

Para ordenar chaves JSON em ordem alfabética online, abra o ordenador de chaves JSON, solte um arquivo .json ou cole o texto, deixe a ordem em Alfabética e clique em Ordenar chaves. Cada objeto do documento, por mais aninhado que esteja, volta com as chaves de A a Z. Os arrays mantêm a ordem, a menos que você peça outra coisa, e os valores são copiados caractere por caractere, então só mudam a ordem das chaves e a indentação. O restante deste guia explica para que isso serve, quando ordenar apenas o primeiro nível e os poucos casos que surpreendem as pessoas.

Por que ordenar chaves JSON em ordem alfabética

Um objeto JSON é, por definição, um conjunto não ordenado de nomes e valores. O padrão deixa a ordem das chaves a critério de quem escreve o arquivo, então dois programas que exportam os mesmos dados podem gerar as chaves em ordens diferentes: a ordem em que o banco de dados devolveu as colunas, a ordem em que um desenvolvedor foi acrescentando campos ao longo dos anos ou a ordem que uma biblioteca usa internamente. Os dados são idênticos. O texto, não.

Essa diferença importa assim que uma pessoa ou uma ferramenta que trabalha linha a linha lê o arquivo. Ordenar as chaves dá a cada exportação uma forma previsível, o que ajuda em três situações do dia a dia:

  • Diffs no controle de versão. Quando um arquivo de configuração é gerado de novo com as chaves embaralhadas, um diff por linhas marca metade do arquivo como alterada. Com as chaves ordenadas, o diff mostra só as linhas cujos valores mudaram de verdade.
  • Revisões de código. Quem procura timeout num arquivo de configurações de 300 linhas o encontra sempre no mesmo lugar, e uma chave duplicada ou escrita errado fica bem ao lado da gêmea correta, onde chama a atenção.
  • Saída estável. Caches, somas de verificação e testes de snapshot que comparam arquivos byte a byte falham quando só a ordem mudou. Um arquivo ordenado e com indentação uniforme gera os mesmos bytes para os mesmos dados.

Se você só precisa ver o que mudou entre duas versões, não é preciso ordenar antes: uma comparação estrutural já ignora a ordem das chaves, como explicado em como comparar dois arquivos JSON. Ordenar serve quando o próprio arquivo precisa ser versionado, revisado ou entregue numa forma estável.

Ordenar chaves JSON passo a passo

1

Adicione seu JSON

Solte um arquivo .json, .jsonc, .ndjson ou .jsonl no ordenador de chaves JSON, procure-o pelo botão ou cole o texto na caixa abaixo da área de upload.

2

Escolha a ordem

Alfabética é o padrão e o que a maioria das ferramentas de diff e guias de estilo espera. Escolha Natural se as chaves forem numeradas, Comprimento da chave para colocar as curtas primeiro ou Por valor para ordenar os membros pelo que contêm. Em Direção, escolha A → Z ou Z → A.

3

Defina a profundidade

Deixe Profundidade em Todos os níveis para ordenar cada objeto aninhado, ou escolha Apenas o primeiro nível, 2 níveis ou 3 níveis para manter a ordem interna como foi escrita.

4

Abra Avançado se precisar

Fixe chaves no topo, decida o que acontece com chaves duplicadas, ordene arrays ou ative Aceitar comentários e vírgulas finais para arquivos JSONC.

5

Ordene e salve

Clique em Ordenar chaves, escolha 2 espaços, 4 espaços, tabulação ou saída minificada e baixe o arquivo ou copie o resultado. Se você mudar uma configuração depois, o resultado fica marcado como feito com configurações antigas, para que você possa aplicar de novo.

Quatro predefinições preenchem essas opções com um clique: Alfabética, package.json, Boa para diffs e Minificada. Boa para diffs usa a ordem natural, ignora maiúsculas, ordena arrays de valores simples e termina o arquivo com uma quebra de linha, uma escolha sensata para um arquivo que fica num repositório.

Ordem alfabética, natural ou por comprimento da chave, em todos os níveis ou só no primeiro, com os valores intactos. Grátis: um documento de até 25 MB, com todas as opções de ordenação incluídas. Pro: sem limite de tamanho além do que seu dispositivo aguenta e até 20 documentos de uma vez num único arquivo compactado. Tudo roda no seu dispositivo, não nos nossos servidores.

Ordenar chaves JSON

Recursivo ou só o primeiro nível?

A ordenação é recursiva por padrão: o objeto externo é ordenado, depois cada objeto dentro dele, depois os que estão dentro desses, até o fim. É o que você quer para respostas de API, dados exportados e a maioria dos arquivos gerados, porque o objetivo é uma forma previsível em todo lugar.

Alguns arquivos têm uma ordem com sentido dentro das seções. Um arquivo de configurações escrito à mão pode listar host antes de port e depois user porque é assim que se lê, enquanto as seções podem vir em qualquer ordem. Coloque Profundidade em Apenas o primeiro nível e as seções são ordenadas, mas tudo dentro delas fica como estava. As opções 2 níveis e 3 níveis ficam no meio do caminho.

Configuração de profundidadeO que muda de lugarBom para
Todos os níveisAs chaves de todos os objetos, em qualquer profundidadeRespostas de API, exportações, configuração gerada
Apenas o primeiro nívelSó as chaves externas (e as de cada registro de uma lista no primeiro nível)Seções ordenadas à mão, manifestos de pacotes
2 níveis / 3 níveisAs chaves até essa profundidade; objetos mais profundos ficam intactosConfigurações grandes cujo detalhe interno está ordenado de propósito

O que acontece com os arrays

Os arrays ficam na ordem original. Ao contrário das chaves de um objeto, as posições de um array costumam ter significado: os passos de uma sequência, a classificação de resultados de busca, as camadas de uma imagem. Reordená-los mudaria os dados, não só a apresentação. As chaves dos objetos que estão dentro de um array continuam sendo ordenadas pelas regras normais; só a posição dos elementos é protegida.

Duas opções em Avançado mudam isso quando você quer. Ordenar também arrays de valores simples reordena arrays que contêm apenas strings, números, booleanos ou null, como uma lista de tags. Os valores são agrupados primeiro por tipo e depois ordenados dentro de cada grupo. Ordenar listas de objetos por recebe o nome de uma propriedade, como id, e ordena uma lista de registros por ela; registros sem essa propriedade mantêm a ordem relativa no final. Qualquer uma das duas deixa intacto um array que não se encaixa totalmente na regra, então você nunca recebe uma lista ordenada pela metade.

O que acontece com números e outros valores

Muitas ferramentas ordenam chaves lendo o JSON para a memória e escrevendo-o de novo. Essa ida e volta muda em silêncio valores que estavam corretos. Este ordenador trabalha no próprio texto, então os valores saem exatamente como entraram:

No seu arquivoDepois de ler e reescreverCom este ordenador
123456789012345678901234567890123456700012345678901234567890
1.011.0
1e51000001e5
"caf\u00e9""café""caf\u00e9"
A mesma chave duas vezesSó a última é mantidaAs duas são mantidas e contadas

A primeira linha é a que causa estrago de verdade. Os números JSON comuns são guardados como ponto flutuante de precisão dupla, que só representa inteiros com exatidão até 9.007.199.254.740.991. IDs longos de banco de dados, números de pedido e carimbos de data e hora em nanossegundos muitas vezes passam disso, e ler e reescrever o arquivo troca os últimos dígitos sem aviso. Como aqui o texto não é tocado, um arquivo ordenado só difere do original na ordem das chaves e nos espaços.

Chaves que parecem números são outra armadilha. Quando um programa em JavaScript reconstrói um objeto, chaves como "10" ou "2" vão para o início em ordem numérica, seja qual for a ordem pedida. Aqui elas são ordenadas como qualquer outra chave: como texto na ordem Alfabética ou como números na ordem Natural.

Alfabética, natural ou ignorar maiúsculas: qual ordem escolher

A ordem Alfabética compara as chaves caractere por caractere pelo ponto de código Unicode. Isso tem dois efeitos que as pessoas notam. Maiúsculas vêm antes de minúsculas, então Zone fica acima de apple; e letras acentuadas vêm depois do alfabeto básico, então élan cai depois de zebra. Ative Ignorar maiúsculas se Name e name devem ficar juntas em vez de em dois blocos separados.

A ordem Natural lê os dígitos dentro de uma chave como números, então item2 vem antes de item10. Na ordem alfabética simples item10 vem primeiro, porque o caractere 1 é menor que 2. Use a ordem natural para chaves numeradas como step1 a step12; fique com a alfabética quando o arquivo precisar bater com o que outra ferramenta ou um schema espera, já que a maioria ordena assim.

A fixação funciona por cima de qualquer uma das ordens. Digite chaves em Fixar estas chaves no topo, separadas por vírgulas, e elas aparecem no topo nessa ordem em todos os níveis, com o restante ordenado abaixo. Um asterisco no final busca por prefixo, então x-* mantém juntos todos os campos de extensão. A predefinição package.json preenche a lista com os campos com que esse arquivo costuma começar, como name, version e description.

Quando a ordenação dá errado

  • O arquivo não abre. JSON inválido é indicado com a linha, a coluna e um sinal ^ apontando o problema. Uma vírgula faltando ou uma chave sem aspas costuma ser a causa; o validador JSON e o formatador JSON ajudam a corrigir.
  • Ele tem comentários. Arquivos como tsconfig.json ou as configurações de um editor têm comentários e vírgulas finais, que o JSON estrito proíbe. Ative Aceitar comentários e vírgulas finais; cada comentário fica preso à chave logo abaixo e se move com ela. A saída minificada não comporta comentários, então ali eles são omitidos.
  • Um documento por linha. Arquivos NDJSON e JSON Lines são detectados sozinhos e cada linha é ordenada separadamente. A configuração de indentação não se aplica, porque cada registro precisa continuar numa única linha.
  • O arquivo é grande demais. O plano grátis aceita um documento de até 25 MB. Se o arquivo for maior, minificá-lo antes muitas vezes o deixa abaixo do limite, porque a indentação pode ocupar boa parte de um arquivo formatado.
  • Chaves que você não quer de jeito nenhum. Ordenar só move chaves. Para tirar campos como IDs internos antes de compartilhar um arquivo, use primeiro Remover chaves JSON e depois ordene.

Perguntas frequentes

Como ordeno chaves JSON em ordem alfabética online?

Cole seu JSON ou solte o arquivo no ordenador de chaves JSON, deixe a ordem em Alfabética e clique em Ordenar chaves. Cada objeto de cada nível fica de A a Z, os arrays mantêm a ordem e você pode baixar ou copiar o resultado. O plano grátis cobre um documento de até 25 MB.

Ordenar chaves JSON também ordena objetos aninhados?

Sim, por padrão. Profundidade está em Todos os níveis, então objetos dentro de objetos e objetos dentro de arrays são todos ordenados. Escolha Apenas o primeiro nível, 2 níveis ou 3 níveis se quiser deixar os objetos mais profundos como estão.

A ordenação muda a ordem dos meus arrays?

Não, a menos que você ative. A ordem de um array costuma ter significado, então só as chaves dos objetos se movem. Em Avançado você pode ordenar arrays de valores simples ou ordenar uma lista de objetos por uma propriedade como id.

Ordenar chaves JSON pode mudar meus números?

Com esta ferramenta, não. Os valores são copiados do seu arquivo caractere por caractere, então 1.0, 1e5 e inteiros com mais de 16 dígitos ficam exatamente como estavam. Ferramentas que leem e reescrevem o JSON podem arredondar inteiros grandes e mudar o formato dos números.

Por que item10 aparece antes de item2 ao ordenar?

A ordem alfabética compara caracteres, e 1 vem antes de 2, então item10 fica primeiro. Mude a ordem para Natural, que lê os dígitos como números e coloca item2 antes de item10.

Posso manter algumas chaves no topo, como id ou name?

Sim. Abra Avançado e liste-as em Fixar estas chaves no topo, separadas por vírgulas. Elas aparecem nessa ordem acima das chaves ordenadas, em todos os níveis. Um asterisco no final, como em x-*, fixa todas as chaves com esse prefixo.

Continue lendo

Mais sobre Documentos →