Código

Formatar JSON: validar, indentar e conferir a estrutura

·

Uma resposta de API compacta pode ser válida e ainda difícil de conferir. Use a formatação para ler a estrutura ou a minificação para retirar espaços de apresentação; depois examine os avisos e recupere o resultado completo.

Este guia mostra como validar JSON sem confundir sintaxe com regras de um esquema. Também explica a preservação de números e escapes, a ordenação de chaves e os limites que podem impedir a árvore sem cortar o texto de saída.

Formatar JSON

Carregar, escolher e processar

Cole o documento inteiro em «Entrada», use «Abrir arquivo de texto» para um arquivo local ou comece com «Testar um exemplo». Escolha a «Indentação» e a ordem das chaves antes de acionar «Formatar JSON» ou «Minificar».

As ações usam toda a entrada, independentemente da seleção. Formatar adiciona espaços para facilitar a leitura; minificar remove espaços desnecessários fora das strings. Confira «Resultado» e os avisos antes de copiar ou baixar.

  • Carregue o documento completo, independentemente da seleção.
  • Escolha indentação de 2 ou 4 espaços e a ordem das chaves.
  • Formate para ler ou minifique para retirar espaços de apresentação.
  • Corrija a sintaxe e confira as propriedades duplicadas.
  • Explore a árvore e seus ponteiros para localizar valores.
  • Copie ou baixe toda a saída e guarde uma cópia fora da aba.

node-jsonc-parser: análise e formatação

Validar a sintaxe de JSON estrito

O formatador JSON aceita um único valor completo: objeto, array ou escalar. Nomes de propriedades e strings precisam de aspas duplas. Comentários, vírgulas finais e conteúdo adicional depois do primeiro valor são rejeitados.

A ferramenta não corrige JSON inválido, não converte JSON5 e não reúne registros NDJSON. Para processar registros separados, prepare antes um documento JSON válido; mudar apenas a indentação não resolve um erro de sintaxe.

Validar a sintaxe de JSON estrito
Exemplo de entradaAceito aqui?Significado
{"ready":true}SimObjeto JSON com nome entre aspas e valor booleano.
[3,2,1]SimArray cuja sequência de elementos é preservada.
"hello", 42, true, nullSimQualquer um deles pode ser um valor completo na raiz.
Editor vazio ou contendo apenas espaçosNãoNão existe um valor JSON.
{"a":1,} ou [1,]NãoVírgulas finais são rejeitadas.
{/* note */"a":1}NãoComentários são rejeitados.
{a:1}, {'a':1}, NaN, InfinityNãoEssas formas não são sintaxe de JSON estrito aceita.
{"a":1} {"a":2}NãoDois registros separados não formam um único documento JSON.

RFC 8259: sintaxe e interoperabilidade de JSON

Interpretar o primeiro erro

A mensagem aponta o primeiro problema com linha e coluna contadas a partir de 1. A coluna usa unidades UTF-16: um caractere fora do plano multilíngue básico ocupa duas unidades, mesmo que pareça um único símbolo.

Em { "a": }, o fechamento inesperado está na linha 2, coluna 8. Corrija a entrada e processe novamente para revelar eventuais erros seguintes. A validação verifica a sintaxe, sem aplicar JSON Schema ou regras de negócio.

node-jsonc-parser: análise e formatação

Preservar inteiros grandes e escapes de JSON

A formatação constrói a saída com trechos originais para números e strings, em vez de serializar os valores JavaScript Number do analisador. Inteiros grandes, notação científica, zeros decimais, zero negativo e a escrita dos escapes continuam como estavam.

Essa preservação vale para o texto produzido aqui. Outro programa pode arredondar números, interpretar um expoente como infinito ou serializar uma string com outra grafia. Confira os literais importantes no aplicativo que vai consumir o documento.

Preservar inteiros grandes e escapes de JSON
Token ou propriedade originalO que permanece em ResultadoO que não é garantido
9007199254740993Os dígitos originais.Tratamento numérico exato por todos os aplicativos destinatários.
1e400O token original do expoente.Um valor finito em um destinatário que usa binary64.
1e+09 e 1.2300A escrita do expoente e das casas decimais.Uma única representação normalizada.
-0O sinal de menos e o zero.A mesma grafia em outro serializador.
"\u0061"A escrita original da string com escape.Que a pesquisa por valor decodificado busque o texto do escape.
"a":1,"\u0061":2As duas propriedades e suas grafias.Nomes decodificados ou ponteiros únicos.

RFC 8259: sintaxe e interoperabilidade de JSONECMAScript: JSON.parse

Identificar e preservar chaves JSON duplicadas

As propriedades duplicadas geram um aviso, mas continuam separadas no resultado. A comparação usa os nomes decodificados: "a" e "\u0061" representam a mesma chave, embora tenham grafias diferentes.

Nenhuma propriedade é removida e a ferramenta não escolhe qual valor deve prevalecer. Aplicativos que receberem o JSON podem manter apenas o último. Revise esses objetos antes de usar os dados em uma configuração ou integração.

RFC 8259: sintaxe e interoperabilidade de JSON

Ordenar chaves sem alterar a sequência dos arrays

Em «Ordenar chaves de objetos», escolha «Manter a ordem original», «Crescente (UTF-16)» ou «Decrescente (UTF-16)». Os nomes decodificados são comparados por unidades UTF-16, sem ordenação linguística nem comparação de números naturais.

A ordenação é recursiva nos objetos, inclusive dentro de arrays. A sequência dos elementos dos arrays é preservada, assim como a ordem relativa de nomes decodificados iguais. Na ordem crescente, "10" vem antes de "2". Isso não constitui uma canonicalização suficiente para assinaturas digitais.

Explorar a árvore JSON

Após processar, clique em «Explorar árvore JSON». Expanda ou recolha objetos e arrays para acompanhar seus níveis. Cada ramo mostra inicialmente até 100 filhos e permite revelar mais em grupos de até 100.

Folhas numéricas e strings mostram a grafia original; os contêineres resumem a quantidade de filhos. «Ocultar árvore JSON» volta ao texto sem alterar o resultado. «Redefinir árvore» limpa a pesquisa e restaura os ramos iniciais. Editar a entrada apaga o resultado anterior e fecha sua árvore; somente um novo processamento bem-sucedido gera outro resultado.

Copiar ponteiros JSON e entender ~0 e ~1

A raiz aparece com o rótulo $, mas seu ponteiro real é uma string vazia. As barras / separam níveis. Dentro do nome de uma chave, ~ vira ~0 e / vira ~1.

«Copiar ponteiro» copia esse caminho. Se a área de transferência falhar, um ponteiro não vazio pode ser selecionado manualmente; não há um marcador visível que substitua o ponteiro vazio da raiz. Propriedades com o mesmo nome decodificado compartilham um ponteiro: segundo a RFC 6901, sua avaliação fica indefinida e falha. A ferramenta mostra e copia caminhos, sem resolver essa ambiguidade.

Copiar ponteiros JSON e entender ~0 e ~1
Nó ou chaveExemplo de ponteiroComo interpretar
Raiz do documentoString vazia, representada aqui por ""Copiar ponteiro copia zero caracteres, não $ nem aspas.
Chave name no objeto raiz/nameUm nível de membro do objeto.
Chave a/b~c no objeto raiz/a~1b~0cA barra e o til da chave recebem escapes.
Primeiro elemento sob essa chave de array/a~1b~0c/0O zero final é um índice do array.
Duas propriedades na raiz decodificadas como a/a para ambasA chave duplicada torna o ponteiro ambíguo.

RFC 6901: ponteiros JSON

A pesquisa encontra trechos sem diferenciar maiúsculas e minúsculas nos rótulos, caminhos e valores de strings decodificados. Assim, "\u0061" pode ser encontrada por a. Nas outras folhas, a pesquisa usa a representação literal.

A consulta aceita até 1000 unidades UTF-16. A contagem inclui todas as correspondências, mas a lista mostra somente as primeiras 100; refine a consulta para reduzir os resultados. Essa pesquisa não muda o JSON e é diferente da busca no editor de entrada.

Separar os limites de entrada, arquivo e árvore

A entrada é medida em unidades UTF-16; o arquivo local, em bytes antes da leitura. Um caractere visível pode ocupar várias unidades e vários bytes. Por isso, passar no limite do arquivo não garante que o texto decodificado caiba na entrada.

A árvore tem orçamentos próprios de nós e texto. Um objeto com uma propriedade escalar usa quatro nós sintáticos: objeto, propriedade, nome e valor. Se a árvore ultrapassar seus limites, Resultado continua com a saída completa. Estar dentro dos limites não garante um prazo de conclusão.

Separar os limites de entrada, arquivo e árvore
LimiteRegra atualConsequência prática
Entrada e texto importado decodificadoNo máximo 1,000,000 de unidades UTF-16.O valor exato do limite é aceito; divida entradas maiores.
Bytes do arquivo localEstritamente menos de 4,000,000 bytes.Um arquivo com exatamente 4,000,000 bytes é recusado.
Aninhamento JSONNo máximo 256 contêineres aninhados.Uma profundidade maior é recusada antes da formatação.
Nós sintáticos da árvoreNo máximo 10,000 nós do analisador.Isso não equivale a uma cota de 10,000 propriedades.
Orçamento de texto da árvoreNo máximo 2,000,000 de unidades UTF-16 acumuladas em rótulos, caminhos e literais de folhas.A árvore pode faltar enquanto Resultado permanece completo.
Filhos visíveis por ramo100 inicialmente, depois grupos de até 100.Mostre os próximos itens para revelar mais filhos.
Pesquisa na árvoreConsulta de até 1,000 unidades UTF-16; primeiras 100 correspondências exibidas.O total pode ultrapassar a lista visível.
Histórico da entradaAté 20 estados anteriores e 4,000,000 de unidades UTF-16 combinadas entre passado e futuro, sem a entrada atual.O histórico antigo pode ser descartado; não é armazenamento permanente.

Abrir um arquivo de texto UTF-8 como JSON

«Abrir arquivo de texto» lê o arquivo local como texto UTF-8 e depois verifica o comprimento decodificado. Não há detecção automática de outras codificações nem leitura estruturada de PDF ou DOCX. O arquivo deve ter menos de 4000000 bytes e o texto, no máximo 1000000 unidades UTF-16.

Uma URL escrita no documento não é baixada pela ferramenta. Se a leitura falhar ou o arquivo for recusado, guarde o original fora da aba e prepare um arquivo de texto menor ou com a codificação adequada.

MDN: leitura de Blob como texto UTF-8

Copiar e baixar o resultado JSON completo

«Copiar resultado» e «Baixar» recuperam toda a saída, mesmo que exista um trecho selecionado. O download é texto UTF-8 com o nome toolmellow-result.json. Se a área de transferência não estiver disponível, selecione o texto e copie manualmente.

A indentação pode ampliar a saída para mais de 1000000 unidades UTF-16; esse limite da entrada não limita a saída. Você pode copiar ou baixar o resultado. «Usar resultado como entrada» recusa uma saída grande demais e preserva os dois editores; se aceitar, substitui a entrada e limpa o resultado, permitindo desfazer dentro do histórico disponível.

Localizar, substituir e desfazer na entrada

«Localizar e substituir na entrada» usa o texto inteiro. A busca é literal e «Diferenciar maiúsculas de minúsculas» começa desativado: . não é uma expressão regular e $& em «Substituir por» entra literalmente. A consulta aceita 1000 unidades UTF-16 e a substituição 10000; «Substituir tudo» é recusado se exceder o limite de entrada.

Uma colagem nativa grande demais é recusada por inteiro. O cálculo desconta a seleção que seria substituída e normaliza CRLF ou CR para LF antes de medir. «Desfazer» e «Refazer» mantêm até 20 estados anteriores e 4000000 unidades UTF-16 somadas entre passado e futuro, sem contar a entrada atual; estados antigos podem ser descartados.

Limpar, cancelar e entender o processamento local

«Limpar» apaga entrada, resultado, pesquisas e histórico, mas mantém as opções. Essa ação não pode ser desfeita. Não há salvamento automático nem restauração garantida ao fechar a aba: guarde os dados que quiser conservar.

«Cancelar» interrompe o trabalho pendente sem alterar a entrada original. O processamento usa um worker local com prazo de 60 segundos, incluindo sua inicialização. Falha ao iniciar, tempo esgotado ou erro do mecanismo pode exigir menos texto ou recarregar a página.

O processamento do JSON não envia seu conteúdo a um serviço de conversão e não executa os dados como código. Os recursos iniciais da página podem precisar de rede. Isso não promete uso offline, remoção de segredos ou certificação de segurança; URLs contidas no documento não são consultadas.

Conferir a apresentação antes de compartilhar

Ao manter a ordem original, a formatação escolhe a primeira quebra real CRLF, CR ou LF recebida; sem nenhuma, usa LF. Ao ordenar chaves, a reconstrução inicial é compacta, então a formatação seguinte usa LF. Os escapes escritos \r e \n dentro de strings não contam como quebras reais.

Os controles do navegador podem normalizar quebras, espaços externos são removidos e um escalar ou contêiner vazio pode não acrescentar linha alguma. «Quebrar linhas» muda a exibição do editor, sem modificar os bytes JSON. Confira os literais, os duplicados, a ordem e o arquivo final no aplicativo de destino.

RFC 8259: sintaxe e interoperabilidade de JSONRFC 6901: ponteiros JSON

Perguntas frequentes

Inteiros grandes e a escrita dos escapes são preservados?

Sim. Os tokens originais de números e strings são mantidos, incluindo 9007199254740993, 1e400, -0 e "\u0061". Outro aplicativo pode interpretá-los ou serializá-los de outra maneira.

As chaves JSON duplicadas são removidas?

Não. Os nomes decodificados repetidos geram avisos e todas as propriedades são preservadas. Um aplicativo destinatário pode manter apenas o último valor.

Posso processar somente uma seleção?

As ações usam toda a Entrada, e a cópia e o download usam todo o Resultado. Uma seleção serve para os comandos comuns de cópia do navegador.

Por que comentários e vírgulas finais são rejeitados?

Porque o processamento exige JSON estrito. Comentários, vírgulas finais, JSON5 e vários registros NDJSON não são corrigidos nem convertidos automaticamente.

Um escalar pode ser o documento inteiro?

Sim. Uma única string, número, valor booleano ou null pode estar na raiz, assim como um objeto ou array. Uma entrada vazia não é um valor JSON.

Como as chaves são ordenadas e a ordem dos arrays é preservada?

Os nomes decodificados são comparados por UTF-16 e os objetos são ordenados recursivamente. Arrays mantêm a sequência dos elementos, e nomes iguais mantêm sua ordem relativa.

Por que a árvore não aparece mesmo com o resultado completo?

A árvore tem orçamento de 10000 nós sintáticos e 2000000 de unidades UTF-16 de texto acumulado. A ausência da árvore por esse limite não corta a saída em Resultado.

Quais limites valem para entrada, arquivos e aninhamento?

A entrada aceita até 1000000 unidades UTF-16, incluindo o limite. Arquivos devem ter menos de 4000000 bytes, e o aninhamento não pode passar de 256 contêineres. Bytes e unidades UTF-16 são medidas diferentes.

Por que uma saída grande não pode virar entrada?

A indentação pode ampliar a saída além do limite de entrada. Copie ou baixe o resultado; Usar resultado como entrada é recusado sem alterar os dois editores quando a saída não cabe.

O validador JSON também verifica um JSON Schema?

Não. A ferramenta verifica a sintaxe de um único valor JSON, sem verificar tipos, campos obrigatórios ou outras exigências de um esquema.

Localizar e substituir aceita expressões regulares?

Não. A busca é literal, com diferenciação opcional entre maiúsculas e minúsculas. O ponto é procurado como ponto e $& é inserido literalmente na substituição.

O que significam ~0 e ~1 em um ponteiro JSON?

~0 representa um til e ~1 uma barra dentro de um nome. O ponteiro da raiz é vazio, não $. Com nomes duplicados, a avaliação do ponteiro fica indefinida e falha.

Uma URL escrita no JSON é aberta?

Não. O texto é processado como dado local, sem executar JSON nem buscar suas URLs. O carregamento dos recursos da página pode precisar de rede.

Posso desfazer Limpar e o texto fica salvo ao sair?

Limpar não pode ser desfeito: apaga também o histórico, mas mantém as opções. Não há salvamento automático ao sair; guarde sua própria cópia.

Referências principais

Coloque em prática.

Guias relacionados