Formatar JSON

Tornando o JSON aninhado legível

Use esta direção quando uma resposta JSON compacta é difícil de inspecionar. O conversor analisa o documento e o grava novamente com recuo de dois espaços, colocando objetos aninhados e matrizes em linhas separadas. Isso torna mais fácil detectar campos ausentes ou inesperados em uma resposta de API, arquivo de configuração ou dispositivo de teste. A formatação não adiciona comentários, explica o significado comercial dos campos ou verifica se o esquema s de um endpoint está correto; ela apenas exige que a entrada seja sintaticamente válida JSON.

Se o analisador relatar um erro, procure aspas simples, vírgulas finais, nomes de propriedades sem aspas, comentários ou colchetes não combinados. Esses são comuns em trechos JavaScript, mas não são JSON válidos. Espaços dentro de valores de string permanecem significativos, enquanto a formatação fora deles muda. Como a operação analisa e serializa, chaves duplicadas, valores numéricos extremamente grandes ou um documento assinado podem precisar de cuidados especiais. Mantenha uma cópia intocada se bytes exatos forem importantes e compare os dados analisados ao invés de assumir que um documento mais bonito é semanticamente verificado.

O que um formatador JSON pode e não pode mudar

JSON é um formato de dados feito de objetos, arrays, strings, números, booleanos e null. Espaço em branco entre tokens geralmente não tem efeito sobre a estrutura representada, enquanto espaços dentro de uma string citada são parte de seu valor. Um formatador analisa a entrada e serializa o valor resultante novamente com recuo; um minifier executa a mesma etapa de análise e serialização sem recuo. Ambas as operações requerem sintaxe JSON válida, incluindo nomes de propriedade entre aspas duplas e cadeias de caracteres. Comentários JavaScript, vírgulas finais e valores indefinidos não são entradas JSON válidas aqui.

Revisão de um documento JSON formatado

Cole um valor JSON completo e deixe o analisador reconstruí-lo com recuo. A conversão ocorre neste navegador, portanto o texto não é enviado para um serviço de formatação. Leia as novas quebras de linha como ajudas visuais para o aninhamento de objetos e arrays, não como alterações em valores de string. Expanda sua atenção para cada colchete de fechamento, vírgula e nome de propriedade citado ao localizar um campo ausente. Use o resultado formatado como uma cópia de trabalho, mantendo a carga original para comparação. Se a fonte veio de uma API, verifique a documentação antes de assumir que um campo com um nome familiar tem o significado que você espera. Use o recuo para localizar uma propriedade ausente em uma resposta de API ou acessório de configuração. Compare valores dentro de aspas antes e depois da formatação e execute a validação do esquema separadamente se o destinatário exigir tipos exatos. Um layout limpo não repara JSON malformado. No exemplo, “{"nome":"Ada","ativo":true,"itens":[1,2]}” produz a prévia compacta “{ ⏎ "nome": "Ada", ⏎ "ativo": true, ⏎ "itens": [ ⏎ 1, ⏎ 2 ⏎ ] ⏎ }” (⏎ indica uma quebra de linha). O resultado visível é mostrado aqui na íntegra; compare pontuação e caracteres antes de aplicar a mesma operação ao seu próprio material. Inteiros sem aspas fora do intervalo de inteiros seguros de ±9.007.199.254.740.991 são rejeitados durante o processamento de JSON; coloque um identificador exato entre aspas para preservar todos os dígitos como string.