Formatador JSON: bonito, reduzido e realmente válido

Impressão bonita: para humanos e solicitações pull

O recuado JSON é revisável JSON. Dois espaços é a convenção na maioria das bases de código JavaScript e corresponde ao padrão em `JSON.stringify(value, null, 2)`; quatro espaços são adequados para editores configurados dessa forma. A escolha da formatação importa menos que a consistência, porque o recuo misto transforma cada diferença posterior em ruído. Se o seu JSON for gerado, defina o recuo no gerador uma vez e deixe o formatador aplicá-lo localmente para cargas coladas.

Minify: para cargas úteis na transmissão

O espaço em branco em JSON é opcional, então retirá-lo é uma economia gratuita. Em uma resposta API de 200 KB, a diferença normalmente é de 15 a 30 por cento de bytes, o que é importante quando o orçamento é uma conexão móvel ou um cabeçalho de cache que você está tentando respeitar. Minificar também é a medida certa antes de armazenar uma carga útil em uma coluna de banco de dados ou incorporá-la em um URL — apenas minificar como uma etapa de construção e não manualmente, já que JSON minificado manualmente é onde a depuração morre.

Validação: os erros que você realmente encontrará

JSON é uma gramática deliberadamente pequena, por isso seus erros são tão repetitivos. Quase todos os erros JSON inválidos remontam a um dos cinco hábitos adquiridos em JavaScript ou YAML:

• Vírgulas finais — `{"a": 1,}` é JavaScript válido e JSON inválido.
• Aspas simples ou chaves sem aspas — `{a: 'b'}` deve se tornar `{"a": "b"}`.
• Comentários — `// note` e `/* note */` não têm lugar em JSON.
• Caracteres de controle sem escape — novas linhas literais dentro de uma string devem ser `\n`.
• Objetos concatenados — dois objetos de nível superior lado a lado, geralmente de um arquivo de log com um documento JSON por linha.

Um formatador deve informar a linha, a coluna e mostrar o trecho. “Token inesperado” por si só deixa você rolando; “linha 84, coluna 17 – vírgula final antes de}” é uma correção.

Por que validar antes de depurar

Quando uma integração falha, o instinto é inspecionar o código. Mais frequentemente, a carga útil em si é malformada: um modelo emitiu uma vírgula perdida, um pipeline de log truncou uma linha ou um copiar e colar de um documento introduziu aspas inteligentes. Executar primeiro o formatador JSON separa “os dados estão errados” de “o código está errado” em segundos, e o número exato da linha geralmente aponta diretamente para o modelo que o produziu.

Arquivos grandes e privacidade

API respostas e exportações de banco de dados frequentemente contêm tokens, campos pessoais ou dados de clientes. Um formatador JSON do lado do servidor significa enviar essa carga útil a terceiros para que ela seja devolvida – uma questão de proteção de dados sem vantagens, já que a formatação é uma operação local trivial. O formatador YamlBox JSON analisa no navegador sem chamadas de rede, portanto funciona offline e mantém sua carga útil em sua máquina; a mesma página oferece opções de recuo, classificação de chaves para diferenças estáveis ​​e estatísticas ao vivo, como profundidade e contagem de chaves.