Comparar
JSON5 ou JSON
JSON5 mantém o modelo de dados do JSON e acrescenta facilidades para edição manual, como comentários, chaves identificadoras, aspas simples, vírgulas finais e números hexadecimais. JSON padrão usa sintaxe mais estrita e é amplamente aceito por APIs e parsers genéricos.
Qual formato você deve escolher?
Considere JSON5 para configurações editadas por pessoas somente quando todos os consumidores oferecerem suporte. Use JSON para APIs, parsers padrão e interoperabilidade ampla.
Indicado para JSON5
Arquivos de configuração editados manualmente · Dados estruturados com comentários
- Dados legíveis quando o analisador aceita JSON5
- Configurações de apps com suporte confirmado
Indicado para JSON
APIs web, arquivos de configuração e troca de dados
- Transferir dados estruturados
Informações básicas
| Campo | JSON5 | JSON |
|---|---|---|
| Extensão | .json5 | .json |
| Tipo MIME | application/json | application/json |
| Usos comuns | Arquivos de configuração editados manualmente · Dados estruturados com comentários | APIs web, arquivos de configuração e troca de dados |
| Como abrir | Exige ferramenta ou analisador compatível com JSON5 | Abra em um editor de texto, IDE ou visualizador compatível com JSON. |
| Exportar ou converter | Abra com um editor ou analisador que declare suporte a JSON5. Um analisador JSON padrão pode falhar com comentários, vírgulas finais e outros recursos exclusivos. | Aplicativos ou ferramentas de conversão podem convertê-lo para formatos como CSV. |
Escolha por finalidade
Dados legíveis quando o analisador aceita JSON5
Arquivos de configuração editados manualmente · Dados estruturados com comentários
JSON5Configurações de apps com suporte confirmado
Arquivos de configuração editados manualmente · Dados estruturados com comentários
JSON5Transferir dados estruturados
APIs web, arquivos de configuração e troca de dados
JSONPonto principal 1
JSON5 aceita comentários, aspas simples, chaves identificadoras sem aspas, vírgulas finais, valores hexadecimais e sintaxe Infinity/NaN. Isso não pertence à gramática JSON da RFC 8259 e pode ser rejeitado por parsers padrão.
Mais sobre as diferençasPonto principal 2
JSON5 é um superset sintático com o mesmo modelo básico de objeto, array, string, número, boolean e null, mas exige parser compatível. Não deduza compatibilidade pela extensão ou tipo de mídia.
Mais sobre as diferençasMais sobre as diferenças
Escolha JSON5 quando comentários e sintaxe flexível facilitarem configurações mantidas manualmente e todas as ferramentas o analisarem explicitamente. Escolha JSON para comunicação e intercâmbio geral. Na conversão, defina como representar números não JSON e valide a saída como JSON estrito.
- Um parser JSON padrão pode rejeitar texto JSON5 válido. Verifique o parser, editor, ferramenta de build ou consumidor de API exato.
- A conversão para JSON perde comentários e intenção de formatação. Infinity e NaN não têm representação numérica JSON direta; qualquer substituição depende da aplicação.
- Teste chaves duplicadas, faixa e precisão numérica, codificação de caracteres, limites do parser e conformidade final com JSON após a conversão.
Perguntas frequentes
Posso enviar um arquivo JSON5 para qualquer API JSON?
Não com segurança. JSON5 permite sintaxe fora do JSON padrão. Analise com ferramenta compatível com JSON5 e serialize JSON estrito se a API exigir RFC 8259.