Formatador JSON

O que é o JSON?

O JSON (JavaScript Object Notation) é um formato leve de intercâmbio de dados que é fácil de ler e escrever para humanos, e fácil de analisar e gerar para máquinas. Apesar do nome, o JSON é independente da linguagem e é usado por praticamente todas as linguagens de programação modernas, APIs e sistemas de bases de dados.

O JSON suporta seis tipos de dados: strings (entre aspas duplas), números, booleanos (true/false), null, objetos (pares chave-valor entre chavetas) e arrays (listas ordenadas entre colchetes). A sua simplicidade e universalidade tornaram-no o formato dominante para APIs web, ficheiros de configuração e armazenamento de dados.

Como formatar JSON

Cole o seu JSON na área de entrada. O formatador valida a sintaxe, deteta erros e produz output com indentação correta. Se o JSON for inválido, a localização exata do erro é realçada para que possa corrigi-lo rapidamente. Pode alternar entre output embelezado (legível) e minificado (compacto).

O que faz o formatador JSON?

• Valida a sintaxe JSON e reporta a localização exata dos erros.
• Embeleza o output com indentação e quebras de linha consistentes.
• Minifica o JSON removendo todo o espaço em branco desnecessário para reduzir o tamanho do ficheiro.

Erros comuns em JSON

• Vírgulas a mais após o último item num objeto ou array — o JSON não permite vírgulas finais, ao contrário do JavaScript.
• Aspas simples em vez de aspas duplas — o JSON exige aspas duplas em torno de todas as chaves e valores de string.
• Nomes de propriedades sem aspas — cada chave deve ser uma string com aspas duplas.
• Vírgulas em falta entre pares chave-valor ou elementos de array.
• Comentários no JSON — a especificação JSON não suporta comentários de qualquer tipo.

Trabalhar eficazmente com JSON

Ao depurar respostas de API, formate primeiro o JSON para tornar a estrutura visível. Os objetos profundamente aninhados são muito mais fáceis de navegar com indentação correta. Para ficheiros de configuração, considere usar JSON5 ou JSONC (JSON com Comentários) se as suas ferramentas os suportarem.

Para ficheiros JSON grandes (acima de 1 MB), use parsers de streaming em vez de carregar o documento inteiro na memória. Ferramentas como jq (linha de comandos) ou pesquisadores de caminho JSON online podem extrair valores específicos de estruturas complexas sem reformatar o documento inteiro.

JSON vs. outros formatos

Comparado com XML, o JSON é mais conciso e mais fácil de analisar. Comparado com YAML, o JSON é mais rigoroso e menos propenso a erros de indentação. Comparado com CSV, o JSON lida naturalmente com dados aninhados e hierárquicos. Cada formato tem os seus pontos fortes, mas o equilíbrio do JSON entre simplicidade e expressividade torna-o a escolha padrão para APIs web.

O meu JSON está seguro?

Sim. Todo o processamento acontece no seu browser usando a função JSON.parse() nativa do JavaScript. Os seus dados nunca são enviados para um servidor. Pode formatar com segurança ficheiros de configuração sensíveis, chaves de API e dados privados.

Perguntas frequentes

Qual é o tamanho máximo de um ficheiro JSON?

A especificação JSON não define um limite de tamanho. Os limites práticos dependem do parser e da memória disponível. A maioria das APIs web lida com payloads JSON até 10–100 MB sem problemas. Esta ferramenta baseada em browser funciona bem com ficheiros até alguns megabytes.

O JSON pode conter funções ou datas?

Não. O JSON suporta apenas strings, números, booleanos, null, objetos e arrays. As funções não são valores JSON válidos. As datas devem ser representadas como strings (tipicamente no formato ISO 8601 como "2024-01-15T10:30:00Z") e analisadas pela aplicação recetora.