Formatar JSON: validar, indentar e conferir a estrutura
Admin ·
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.
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.
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.
| Exemplo de entrada | Aceito aqui? | Significado |
|---|---|---|
{"ready":true} | Sim | Objeto JSON com nome entre aspas e valor booleano. |
[3,2,1] | Sim | Array cuja sequência de elementos é preservada. |
"hello", 42, true, null | Sim | Qualquer um deles pode ser um valor completo na raiz. |
| Editor vazio ou contendo apenas espaços | Não | Não existe um valor JSON. |
{"a":1,} ou [1,] | Não | Vírgulas finais são rejeitadas. |
{/* note */"a":1} | Não | Comentários são rejeitados. |
{a:1}, {'a':1}, NaN, Infinity | Não | Essas formas não são sintaxe de JSON estrito aceita. |
{"a":1}
{"a":2} | Não | Dois registros separados não formam um único documento 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.
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.
| Token ou propriedade original | O que permanece em Resultado | O que não é garantido |
|---|---|---|
9007199254740993 | Os dígitos originais. | Tratamento numérico exato por todos os aplicativos destinatários. |
1e400 | O token original do expoente. | Um valor finito em um destinatário que usa binary64. |
1e+09 e 1.2300 | A escrita do expoente e das casas decimais. | Uma única representação normalizada. |
-0 | O 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":2 | As 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.
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.
| Nó ou chave | Exemplo de ponteiro | Como interpretar |
|---|---|---|
| Raiz do documento | String vazia, representada aqui por "" | Copiar ponteiro copia zero caracteres, não $ nem aspas. |
Chave name no objeto raiz | /name | Um nível de membro do objeto. |
Chave a/b~c no objeto raiz | /a~1b~0c | A barra e o til da chave recebem escapes. |
| Primeiro elemento sob essa chave de array | /a~1b~0c/0 | O zero final é um índice do array. |
Duas propriedades na raiz decodificadas como a | /a para ambas | A chave duplicada torna o ponteiro ambíguo. |
Pesquisar chaves e valores na árvore 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.
| Limite | Regra atual | Consequência prática |
|---|---|---|
| Entrada e texto importado decodificado | No máximo 1,000,000 de unidades UTF-16. | O valor exato do limite é aceito; divida entradas maiores. |
| Bytes do arquivo local | Estritamente menos de 4,000,000 bytes. | Um arquivo com exatamente 4,000,000 bytes é recusado. |
| Aninhamento JSON | No máximo 256 contêineres aninhados. | Uma profundidade maior é recusada antes da formatação. |
| Nós sintáticos da árvore | No máximo 10,000 nós do analisador. | Isso não equivale a uma cota de 10,000 propriedades. |
| Orçamento de texto da árvore | No 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 ramo | 100 inicialmente, depois grupos de até 100. | Mostre os próximos itens para revelar mais filhos. |
| Pesquisa na árvore | Consulta de até 1,000 unidades UTF-16; primeiras 100 correspondências exibidas. | O total pode ultrapassar a lista visível. |
| Histórico da entrada | Até 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.
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
- Como formatar código HTML para leitura
- Como minificar ou formatar CSS
- Como remover linhas duplicadas e ordenar texto
- Como gerar um hash SHA-256 de um texto
- Como codificar e decodificar texto em Base64
- Como codificar e decodificar uma URL
- Como gerar um UUID: v4, v7 e GUID
- Como decodificar um JWT e ler as claims
- Como converter um timestamp Unix em data
- Como gerar texto de preenchimento Lorem Ipsum