Anúncios incomodam? Ir Sem anúncios Hoje 

Formatação e Validação de HJSON

DadosDesenvolvedor

ANUNCIADO Remover?

ENTRADA

Processo Automático

SAÍDA

Lado cliente

ANUNCIADO Remover?

Guia

Formatação e Validação de HJSON

Cole HJSON — a versão humana-amigável do JSON que permite comentários, chaves sem aspas e strings, valores multilinhas e vírgulas finais — e converta imediatamente para JSON estrito. A ferramenta também realiza a conversão no sentido inverso: cole um JSON estrito e obtenha uma versão mais limpa do HJSON com chaves sem aspas, facilitando a leitura e edição.

A validação ocorre linha por linha enquanto você digita, então erros de sintaxe são detectados imediatamente com dicas de linha e coluna. Tudo é processado localmente no seu navegador — sem upload de arquivos, sem viagem para o servidor, sem dados saindo da página.

Como usar

Cole HJSON ou JSON estrito no campo de entrada, ou carregue um arquivo.
Escolha uma direção — HJSON → JSON para limpar uma configuração editada manualmente, ou JSON → HJSON para tornar um arquivo JSON gerado por máquina mais amigável para manutenção.
Escolha sua indentação (2 espaços, 4 espaços, tab, ou minificado para saída de JSON).
Opicionalmente, ordene as chaves de objetos alfabeticamente para diferenças estáveis.
Copie o conteúdo formatado ou baixe como um .json ou .hjson arquivo.

Características

Conversão bidirecional – HJSON para JSON estrito e de volta, com mensagens de erro que indicam a linha problemática.
Sintaxe completa do HJSON – #, //e, e /* */ comentários; chaves sem aspas; strings sem aspas em linha única; strings multilinhas com aspas triplas e dedentação inteligente; vírgulas finais e opcionais.
Objetos sem chaves – nível superior key: value pares sem uma estrutura externa { } são reconhecidos como um objeto raiz.
Saída limpa – escolha indentação de 2 espaços, 4 espaços, tab ou minificada; a saída do HJSON remove aspas das chaves para facilitar diferenças.
Ordem estável – ordenação alfabética opcional das chaves em objetos aninhados para que sua saída formatada difira de forma consistente em diferentes execuções.
Local e privado – a análise e formatação ocorrem totalmente no seu navegador; nada é enviado.

Quando usar HJSON em vez de JSON

O HJSON brilha para arquivos de configuração editados manualmente: pipelines de build, manifestos de implantação, configurações de ferramentas de linha de comando, configurações de jogos e em qualquer lugar onde você deseja a legibilidade do YAML sem os problemas de indentação do YAML. O HJSON é um superset estrito do JSON, então qualquer documento válido em JSON é válido em HJSON — você pode adotá-lo gradualmente, arquivo por arquivo.

ANUNCIADO Remover?

Para trocas de dados entre máquinas (APIs, armazenamento, protocolos de rede), mantenha o JSON estrito: ele tem suporte universal para analisadores e uma gramática menor e menos ambígua. Converta HJSON para JSON no momento da compilação ou carregamento e deixe os humanos editando o arquivo de origem mais amigável.

 Perguntas frequentes

O que é HJSON e como difere do JSON?

O HJSON, abreviação de Human JSON, é uma versão relaxada do JSON projetada para configurações editadas manualmente. Ele adiciona comentários (#, //, /* */), permite chaves sem aspas, strings sem aspas em linha única, strings multilinhas com aspas triplas e vírgulas finais ou opcionais. O JSON estrito proíbe tudo isso para garantir uma análise mecânica clara. Como todo documento válido em JSON é também válido em HJSON, o HJSON é um superset estrito — você pode adotá-lo de forma gradual.
Como o HJSON se compara ao JSON5, JSONC e YAML?

O JSON5 também adiciona comentários e vírgulas finais, mas mantém as strings entre aspas e exige chaves em formato de identificador do JavaScript. O JSONC (JSON com Comentários) adiciona apenas comentários // e /* */. O YAML é muito mais permissivo, mas depende de espaçamento significativo, o que é problemático para estruturas profundamente aninhadas. O HJSON está entre o JSON5 e o YAML: a maioria da legibilidade do YAML com estrutura delimitada por chaves, então um erro de indentação não altera o significado.
As strings multilinhas do HJSON e os escalares de bloco do YAML são equivalentes?

Eles servem ao mesmo propósito, mas diferem em mecanismos. As strings multilinhas do HJSON são delimitadas por aspas triplas ('''), e a indentação da fechamento ''' determina como todas as linhas internas são dedentadas — tornando o bloco portável em diferentes níveis de aninhamento. O YAML oferece escalares literais (|) e dobrados (>) com indicadores separados para linhas finais (-, +). O estilo único do HJSON é mais simples, mas com menos controle sobre espaços em branco no final.
O HJSON altera a forma como números, booleanos e nulos são interpretados?

Não. Números (incluindo inteiros, decimais e notação científica), booleanos e nulo seguem as mesmas regras léxicas do JSON. A regra de desambiguação é simples: se um valor sem aspas puder ser interpretado como um número, verdadeiro, falso ou nulo no JSON, será interpretado como esse primitivo; caso contrário, torna-se uma string sem aspas que se estende até o final da linha.
É possível preservar comentários ao converter HJSON para JSON?

Não no sentido padrão — o JSON estrito não tem gramática de comentários, então uma conversão fiel deve eliminá-los. Alguns fluxos de trabalho contornam isso mantendo o arquivo HJSON como a fonte de verdade e produzindo o JSON apenas como artefato de compilação, ou armazenando os comentários em uma chave irmã como _comment. Se a preservação de comentários for importante, trate o HJSON como sua fonte editável e gere o JSON conforme necessário, em vez de converter no sentido inverso.