03 / GUIAS
Formate e inspecione o JSON antes de revisá-lo
Uma rotina de revisor para payloads de API e arquivos de configuração: formate primeiro, inspecione a estrutura como árvore e compare dois documentos de forma determinística — sem enviar os dados a lugar nenhum.
Tente uma verificação de precisão e ordem
Use esta entrada sintética para conferir o resultado real antes de usar dados privados.
Cole o exemplo no Visualizador de Árvore JSON e depois abra Minificado. A saída deve corresponder exatamente a este texto.
{"id":9007199254740993,"2":"b","1":"a"}
O inteiro termina em 993 e a chave 2 fica antes da chave 1. Com {"name":}, o erro está na linha 1, coluna 9. Limites: 256 KiB, profundidade 40, 10.000 nós; chaves duplicadas e reservadas são rejeitadas.
Visualizador de Árvore JSONPor que a formatação vem primeiro
JSON minificado é feito para máquinas: uma linha, sem indentação, chaves na ordem que o serializador produziu. Pedir aos seus olhos que revisem essa parede é como uma permissão removida, uma flag invertida ou um endpoint inesperado passa despercebido.
Um formatador também é a verificação de validade mais barata que você tem. Um documento que falha ao ser analisado nunca se comportaria em produção, e aprender isso numa aba de revisão é muito melhor do que aprender num log de deploy.
- Só legibilidadeA formatação preserva os valores JSON analisados, mas pode normalizar escapes e a escrita dos números. Compare o significado, não os bytes, e guarde o original quando houver assinatura ou dependência da representação exata.
- Profundidade é sinalA indentação consistente expõe a profundidade de aninhamento num relance, e é na profundidade que os erros de configuração se escondem — uma opção colocada um nível fundo demais é simplesmente ignorada.
- Entregue o formato esperadoRevise a cópia formatada, mas entregue o formato que o sistema espera; a impressão bonita é para humanos, não para a rede.
Inspecione a árvore, não só o texto
Uma visão em árvore responde às perguntas que um revisor realmente faz — quais chaves existem, qual o tipo de cada valor, quão fundo a estrutura vai — sem escanear colchetes. O texto bruto não responde rápido a nenhuma delas.
O Visualizador de Árvore JSON verifica texto colado imediatamente e texto digitado após uma breve pausa quando a Verificação automática está ativada. Você também pode usar Formatar e validar. Erros de sintaxe incluem localização e dica de correção; entradas válidas abrem uma árvore e visões formatada ou minificada.
O resumo informa contagem de nós e profundidade. Chaves reservadas de protótipo são rejeitadas, mas essa verificação não certifica a segurança da aplicação.
A árvore também nivela a conversa numa revisão: «o terceiro elemento de items tem price nulo» é um comentário que qualquer pessoa verifica em segundos, enquanto um deslocamento de byte numa linha minificada não é.
Abrir o Visualizador de Árvore JSONFaça o diff de dois documentos deterministicamente
Comparar dois documentos JSON a olho falha assim que a ordem das chaves muda. Um diff estrutural analisa os dois lados e relata o que realmente mudou — valores adicionados, removidos e modificados — independentemente de ordenação ou espaços em branco.
Text & JSON Diff tem dois modos: Texto e JSON. No modo Texto, escolha precisão automática, por linhas, palavras ou caracteres. O modo JSON analisa os documentos e compara valores; mudanças na ordem das chaves ou nos espaços são consideradas idênticas.
Para dados que não são JSON, o modo Texto oferece opções para ignorar espaços e normalizar quebras de linha; o resumo conta adições, remoções e alterações. Use Texto quando um lado não for JSON válido.
O determinismo importa além da conveniência. Quando dois revisores rodam a mesma comparação, precisam obter a mesma resposta — caso contrário a revisão vira uma negociação sobre ferramentas em vez de uma decisão sobre a mudança.
Abrir o Diff de Texto e JSONConheça os limites dos runtimes locais
Estes são runtimes locais com tetos explícitos, dimensionados para payloads de revisão, e não para processamento de dados em massa. Conhecer o teto diz quando buscar uma ferramenta de desktop.
Os tetos existem porque a análise e o diff rodam na mesma aba em que você está lendo; um limite honesto é melhor que uma página congelada, e o espaço de trabalho relata um limite excedido como erro explícito em vez de um truncamento silencioso.
- Teto do visualizadorO Visualizador de Árvore JSON aceita até 256 KiB de entrada, quarenta níveis de aninhamento e dez mil nós — de sobra para uma resposta de API ou um arquivo de configuração.
- Teto do diffO modo Texto aceita até 256 mil caracteres por lado; o modo JSON também impõe um limite de análise de 256 KiB UTF-8 por lado. Ambos limitam os registros de diferença a 10.000.
- Além do navegadorExportações maiores — dumps de banco de dados, arquivos de log, fixtures gerados — pertencem a um editor de desktop ou a uma ferramenta de linha de comando, não a uma aba de navegador.
Uma checklist de revisão de cinco minutos
Uma rotina curta que pega a maioria dos problemas de payload antes que cheguem à produção.
Rode a checklist nos dados de exemplo do produtor e também no payload real; um fixture que discorda da realidade invalida a revisão tão certamente quanto um bug.
- AnalisarFormate e analise primeiro: confirme que o documento é válido e dê uma olhada na contagem de nós e na profundidade contra as expectativas.
- InspecionarInspecione a árvore: verifique os tipos nas folhas — um identificador numérico chegando como string é um bug clássico de integração.
- DiffFaça o diff contra a última versão boa conhecida no modo JSON e leia cada mudança relatada antes de aprovar.
Mantenha o payload no seu dispositivo
Payloads de revisão muitas vezes contêm registros de clientes, tokens ou URLs internas. Um visualizador local mantém esse material na aba: o texto é analisado por código que roda no seu dispositivo e nunca é transmitido como parte da operação.
Esse limite é o que torna essas ferramentas utilizáveis com payloads reais de staging durante uma revisão. Ele não apaga suas próprias obrigações: exportações baixadas, conteúdo da área de transferência e capturas de tela da árvore ainda são seus para manusear com cuidado quando saem do espaço de trabalho.
Se precisar compartilhar um fragmento de payload na própria revisão, cole o menor trecho que mostra o problema e oculte os identificadores antes — a mesma disciplina que os canais de suporte pedem.
Especificação atual de execução
Revisão da descrição do contrato: 2026-09-26.1
O repasse na mesma página aceita no máximo 256 KiB de texto UTF-8 por 10 minutos. Este é o limite de transferência; cada ferramenta destinatária tem seus próprios limites de análise e exibição.
JSON Tree Viewer e Structured Data Converter enviam a saída para um único destino na mesma página. Tree aceita apenas JSON; Converter e Text & JSON Diff podem receber JSON, YAML ou CSV. Abrir o destino não executa uma conversão automaticamente.
O texto transferido permanece na memória da página. Ele fica fora de URLs, armazenamento e análises. Fechar o destino, substituir a origem, sair ou atualizar a página, ou a expiração, o descarta. Na expiração, o foco volta ao título da origem apenas se estava dentro do destino.
Por que a inspeção local é uma alegação crível.
Aprenda como runtimes de navegador mantêm os dados no dispositivo e como verificar o caminho de dados de qualquer ferramenta com que você revisa.