JSON Formatter — Embelezar e Validar JSON

O que é o JSON Formatter?

O JSON Formatter é uma ferramenta baseada no navegador que pega texto JSON bruto ou malformado e produz uma saída limpa, indentada e legível em segundos. Desenvolvedores encontram JSON ilegível constantemente — de respostas de API comprimidas em uma única linha, a fragmentos de configuração copiados que perderam seus espaços em branco, a arquivos editados manualmente com erros de sintaxe sutis. Esta ferramenta resolve os três problemas de uma vez: formata com indentação configurável, valida a sintaxe e repara erros comuns automaticamente usando a biblioteca jsonrepair.

Ao contrário das alternativas do lado do servidor, o JSON Formatter roda inteiramente no seu navegador. Seus dados jamais saem da sua máquina. Não há conta, limite de taxa, nem custo.

Funcionalidades Principais

• Formatar com indentação personalizável (2 ou 4 espaços) — Escolha seu tamanho de indentação preferido no menu suspenso da barra de ações antes de clicar em Formatar. A seleção persiste entre sessões quando combinada com o salvamento de predefinições.
• Validar sintaxe JSON com mensagens de erro — A ferramenta executa JSON.parse após tentar a reparação automática e exibe a mensagem de erro exata se a entrada não puder ser analisada, exibida no painel de saída com um atributo role="alert" acessível.
• Reparar automaticamente JSON malformado — A biblioteca jsonrepair corrige strings entre aspas simples, vírgulas finais, chaves sem aspas e outros desvios comuns antes da análise. Se a reparação for aplicada, uma notificação toast distinta informa sobre isso.
• Minificar JSON (remover espaços em branco) — Produz uma saída de uma única linha com todos os espaços de formatação removidos, útil para incorporar JSON em arquivos de configuração ou reduzir o tamanho do payload.
• Copiar saída formatada para a área de transferência — Cópia com um clique usando a API Clipboard com um fallback para navegadores mais antigos.
• Baixar como arquivo .json — Salva a saída como formatted.json com o tipo MIME application/json.
• Aba Validador de Esquema — Cole dados JSON e um documento JSON Schema draft-07; a ferramenta relata cada violação com seu caminho exato (ex.: root.user.email).
• Aba Gerador de Esquema — Cole qualquer objeto JSON; a ferramenta infere um documento JSON Schema draft-07 incluindo formatos detectados (email, data, UUID, URI).
• Aba Visualizador de Árvore — Renderiza o JSON analisado como uma árvore interativa recolhível com tipos codificados por cores, destaque de busca, expandir/recolher tudo e cópia de caminho com um clique.

Como usar o JSON Formatter

Passo 1: Cole seu JSON

Abra a aba Formatar/Minificar (a visualização padrão). Cole seu JSON no painel de entrada no lado esquerdo. A área de texto aceita entrada de qualquer tamanho e pode ser redimensionada verticalmente arrastando a borda inferior. Se você estiver carregando um link compartilhado de um colega, a ferramenta lê a entrada da URL automaticamente e exibe uma notificação toast.

Passo 2: Escolha a Indentação

Na barra de ações abaixo dos painéis, abra o menu suspenso de indentação. Selecione 2 espaços (o padrão) ou 4 espaços. Isso controla quantos espaços são usados por nível de aninhamento na saída. Uma indentação de 4 espaços é comum em projetos Python e alguns guias de estilo; 2 espaços é o padrão nos ecossistemas JavaScript e Node.js.

Passo 3: Clique em Formatar

Clique no botão Formatar ou pressione Cmd+Enter (Mac) / Ctrl+Enter (Windows/Linux). O JSON formatado aparece no painel de saída somente leitura à direita. Se a entrada contiver problemas corrigíveis — como vírgulas finais ou chaves sem aspas — uma notificação toast exibe "JSON formatted and repaired" para confirmar que a reparação foi aplicada. Se o JSON for inválido além da reparação, uma mensagem de erro aparece abaixo do painel de saída com o erro de análise específico.

Exemplo de entrada (resposta de API comprimida):

{"user":{"id":4821,"name":"Maria Santos","email":"maria@example.com","roles":["admin","editor"],"active":true,"lastLogin":null}}

Saída com indentação de 2 espaços:

{
  "user": {
    "id": 4821,
    "name": "Maria Santos",
    "email": "maria@example.com",
    "roles": [
      "admin",
      "editor"
    ],
    "active": true,
    "lastLogin": null
  }
}

Passo 4: Minificar (Opcional)

Para reduzir o JSON de volta a uma única linha, clique em Minificar ou pressione Cmd+Shift+M / Ctrl+Shift+M. Isso é útil quando você tem JSON formatado que precisa ser incorporado em uma variável de ambiente ou uma string de configuração.

Passo 5: Copiar ou Baixar a Saída

Clique em Copiar para colocar a saída na sua área de transferência. Clique em Baixar para salvar formatted.json na sua pasta de downloads. O botão Copiar fica desabilitado até que exista uma saída, evitando operações acidentais de área de transferência vazia.

Usando o Validador de Esquema

Mude para a aba Validador de Esquema. Cole seus dados JSON no painel esquerdo e um documento JSON Schema no painel direito, depois clique em Validar. Os resultados aparecem abaixo com uma marca de verificação verde para dados válidos ou uma lista vermelha de violações. Cada violação mostra seu caminho em notação de pontos (ex.: root.addresses[0].postalCode) e uma descrição em linguagem simples do que falhou (ex.: "String does not match pattern: ^\\d{5}$").

Usando o Gerador de Esquema

Mude para a aba Gerador de Esquema. Cole um objeto JSON de amostra e clique em Gerar Esquema. A ferramenta produz um documento JSON Schema draft-07 inferido da amostra em segundos, incluindo dicas de formato para strings que parecem emails, datas (YYYY-MM-DD), datas-horas ISO, UUIDs e URIs.

Usando o Visualizador de Árvore

Mude para a aba Visualizador de Árvore. Cole JSON e a árvore se constrói automaticamente após um debounce de 500ms (sem necessidade de pressionar botão). Clique em qualquer nó de objeto ou array para expandi-lo ou recolhê-lo. Use a caixa de pesquisa para destacar nós cuja chave ou valor corresponda ao seu termo. Clique em Expandir Tudo para abrir toda a estrutura de uma vez, ou passe o cursor sobre qualquer nó para revelar um botão de cópia de caminho que copia o caminho em notação de pontos para esse campo.

Exemplos Práticos

Depurando uma Resposta de API

Uma API REST retorna um perfil de usuário comprimido para solução de problemas:

{"profile":{"id":"a3f8-bc21","created":"2025-11-03","tier":"pro","quota":{"used":14200,"limit":50000},"features":["export","api","webhooks"]}}

Cole-o e clique em Formatar com indentação de 2 espaços. A saída imediatamente mostra a hierarquia de aninhamento, tornando claro que quota é um objeto aninhado com dois campos e features é um array de três strings. Copie o resultado e cole no seu relatório de bug.

Validando um Arquivo de Configuração Contra um Esquema

Sua aplicação espera uma configuração com um inteiro port obrigatório entre 1 e 65535 e uma string host obrigatória. Cole o JSON de configuração no painel esquerdo do Validador de Esquema e um esquema como:

{
  "type": "object",
  "required": ["host", "port"],
  "properties": {
    "host": { "type": "string" },
    "port": { "type": "integer", "minimum": 1, "maximum": 65535 }
  }
}

Se port for "8080" (uma string em vez de um inteiro), o validador reporta: root.port — Expected integer, got string.

Gerando um Esquema para um Novo Contrato de API

Você tem uma resposta de amostra de uma nova API de terceiros e precisa escrever um JSON Schema para ela rapidamente. Cole a amostra na aba do Gerador de Esquema e clique em Gerar Esquema. A ferramenta produz um esquema draft-07 em segundos, que você pode refinar manualmente adicionando restrições como minLength, pattern ou valores enum.

Dicas e Boas Práticas

Use os atalhos de teclado. Cmd+Enter formata e Cmd+Shift+M minifica sem precisar alcançar o mouse. No YAML Formatter o atalho equivalente é Cmd+Shift+J para conversão JSON, mas nesta ferramenta Cmd+Shift+M sempre significa minificar.

Verifique a notificação de reparação. Se o toast de sucesso diz "formatted and repaired" em vez de "formatted successfully", revise sua fonte original. A reparação pode ter corrigido um erro genuíno em um arquivo de configuração que deveria ser corrigido na fonte.

O visualizador de árvore se constrói automaticamente. Você não precisa clicar em Construir Árvore — a árvore renderiza 500ms após você parar de digitar. Isso é útil para explorar rapidamente uma estrutura de dados desconhecida enquanto ainda está editando a entrada.

Copie caminhos para acesso em JavaScript. No Visualizador de Árvore, passe o cursor sobre qualquer nó e clique no ícone de cópia que aparece. O caminho copiado (ex.: root.users[2].address.city) é a notação exata de ponto-colchete que você precisa para acessar esse valor em JavaScript após JSON.parse().

O gerador de esquema marca todas as chaves existentes como obrigatórias. Após gerar um esquema, revise o array required e remova os campos que são genuinamente opcionais no seu modelo de dados.

Problemas Comuns e Solução de Problemas

Erro "Invalid JSON syntax" após colar — A entrada não pôde ser reparada automaticamente. Causas comuns são aspas com escape duplo durante a cópia (\\" em vez de \"), ou caracteres binários colados de um terminal. Tente selecionar o JSON em seu aplicativo de origem e copiar novamente, ou verifique se há caracteres invisíveis.

Saída está vazia após clicar em Formatar — O campo de entrada está vazio ou contém apenas espaços em branco. O botão Formatar é desabilitado quando a entrada está em branco, mas se de alguma forma for acionado, a mensagem de erro "Please enter JSON to format" aparece abaixo do painel de saída.

Validador de Esquema mostra "Invalid JSON data" — O texto no painel esquerdo do Validador de Esquema não é JSON válido. Ao contrário da aba Formatar, o Validador de Esquema não aplica reparação automática. Cole primeiro na aba Formatar, copie a saída corrigida e retorne ao Validador de Esquema.

Visualizador de Árvore mostra "Invalid JSON" — O visualizador de árvore analisa com JSON.parse sem reparação. Se seu JSON tiver problemas menores, formate-o primeiro na aba Formatar para obter uma cópia limpa, depois cole-o no Visualizador de Árvore.

Download produz um arquivo chamado formatted.json toda vez — Isso é por design. Renomeie o arquivo após baixar.

Privacidade e Segurança

O JSON Formatter processa tudo no seu navegador usando JavaScript. Nenhuma entrada — incluindo chaves de API sensíveis, tokens, senhas ou dados pessoais incorporados em JSON — é transmitida a qualquer servidor. A ferramenta funciona completamente offline após o carregamento da página. Não há hooks de análise na lógica de formatação em si. Você pode colar com segurança segredos de produção, credenciais de banco de dados ou PII nesta ferramenta sem que os dados saiam da sua máquina.

Perguntas Frequentes

O JSON Formatter é gratuito? Sim, o JSON Formatter é completamente gratuito sem limites de uso. As abas Formatar, Minificar, Validador de Esquema, Gerador de Esquema e Visualizador de Árvore estão todas disponíveis sem custo. Recursos premium dos apoiadores do Glyph Widgets como predefinições salvas, histórico de sessão e notas de ferramentas estão disponíveis para apoiadores, mas a funcionalidade de formatação principal não requer nada.

Funciona offline? Sim. Uma vez que a página foi carregada no seu navegador, todas as operações de formatação e validação são executadas localmente em JavaScript. Você pode se desconectar da internet e continuar usando a ferramenta sem nenhuma perda de funcionalidade.

É seguro colar meus dados aqui? Sim. Todo o processamento acontece no seu navegador. O texto de entrada nunca é enviado a um servidor, registrado ou armazenado em qualquer lugar fora da sua sessão do navegador. Você pode formatar com segurança JSON que contenha chaves de API, senhas ou dados pessoais.

Quais formatos JSON a reparação automática trata? A ferramenta usa a biblioteca jsonrepair, que trata strings entre aspas simples, vírgulas finais em objetos e arrays, chaves de propriedade sem aspas, comentários (// e / /), colchetes de fechamento ausentes e vários outros desvios comuns da especificação JSON.

Quais restrições o Validador de Esquema suporta? O validador suporta type, enum, required, properties, additionalProperties, minProperties, maxProperties, minLength, maxLength, pattern, format (email, uri, date, date-time, ipv4, ipv6, uuid), minimum, maximum, exclusiveMinimum, exclusiveMaximum, multipleOf, minItems, maxItems, uniqueItems e items.

Quais formatos o Gerador de Esquema detecta automaticamente? O gerador detecta endereços de email, datas ISO (YYYY-MM-DD), datas-horas ISO, UUIDs e URIs. Ele também distingue entre tipos integer e number para valores numéricos.

Posso validar um array em vez de um objeto? Sim. O validador de esquema e o gerador de esquema aceitam qualquer valor JSON válido no nível raiz — incluindo arrays, strings, números e booleanos, não apenas objetos.

Qual é o atalho de teclado para formatar? Pressione Cmd+Enter no macOS ou Ctrl+Enter no Windows e Linux para acionar Formatar. Pressione Cmd+Shift+M ou Ctrl+Shift+M para Minificar. Esses atalhos só são ativados quando a aba Formatar/Minificar está ativa.

A ferramenta consegue lidar com arquivos JSON muito grandes? A ferramenta armazena até 10.000 caracteres por entrada de histórico, mas a formatação em si não tem limite embutido além da memória do navegador. Arquivos muito grandes (vários megabytes) serão formatados corretamente, mas a área de texto pode parecer lenta em dispositivos de baixo desempenho.

Qual rascunho de esquema o esquema gerado tem como alvo? O gerador produz documentos JSON Schema draft-07, identificados por "$schema": "http://json-schema.org/draft-07/schema#" na saída.

Ferramentas Relacionadas

XML Formatter — Formate e valide documentos XML com os mesmos controles de indentação e suporte a minificação.

YAML Formatter — Formate arquivos YAML e converta-os diretamente para saída JSON com indentação configurável.

JSON Converter — Converta JSON de e para CSV, XML, YAML e outros formatos de dados.

Experimente o JSON Formatter agora: JSON Formatter