Ferramentas JSON

Quase toda ferramenta de JSON na web é um formulário que envia seu documento para um servidor. Para um trecho copiado de um tutorial, tudo bem. Para o payload real que você está depurando, raramente está tudo bem: JSON de produção tende a carregar tokens de acesso, registros de clientes, hostnames internos e identificadores de conta, e colar isso em um endpoint desconhecido entrega tudo isso para o log de acesso de outra pessoa. Em um ambiente regulado, não é uma decisão de julgamento, é um incidente que deve ser reportado.

As ferramentas aqui eliminam completamente a questão do servidor. A página que você carrega é HTML e JavaScript estáticos; quando você cola um documento, ele é analisado por código que já está rodando na sua aba. Não há requisição para inspecionar nem endpoint para confiar, o que é uma posição muito mais sólida do que uma promessa de não olhar.

Essa decisão também as torna mais rápidas. Não há envio, não há fila e não há ida e volta, então um documento de 2 MB é formatado no tempo de redesenhar a tela, e não no tempo de cruzar o Atlântico duas vezes. E isso significa que elas funcionam dentro de um avião, em uma rede corporativa travada e dentro de uma VPN que bloqueia tudo o que não reconhece.

Os motores são escritos à mão em vez de montados a partir de pacotes, o que importa mais do que parece. O parser é iterativo em vez de recursivo, então um documento profundamente aninhado reporta um erro em vez de estourar a pilha de chamadas do JavaScript — há um teste na suíte que alimenta o parser com vinte mil níveis de aninhamento. Toda chave que vem do seu documento é atribuída por meio de uma verificação de propriedade própria, então um payload contendo __proto__ não consegue alterar o comportamento da página que o está inspecionando. Não são preocupações teóricas; são as duas maneiras pelas quais ferramentas de JSON realmente quebram.

Onde existe um padrão, ele é seguido à risca: RFC 8259 para a gramática, RFC 6902 para documentos de patch, RFC 7386 para merge patches e JSON Schema Draft 2020-12 para inferência e validação. Quando a ferramenta precisa fazer uma escolha que o padrão deixa em aberto — como parear elementos de array ao comparar, se ordenar chaves na saída — isso é exposto como uma opção em vez de vir fixo no código, e a tabela de referência de cada página explica o que a opção faz nos casos extremos.

Se você não sabe por onde começar: Validar JSON para um documento que não faz parse, Comparar JSON para dois documentos que deveriam ser iguais e não são, Formatar JSON para algo ilegível, e Gerar JSON Schema quando você precisa descrever a estrutura de uma resposta que não foi você quem escreveu.