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

Formatação de package.json e Ordenação de Chaves

DadosDesenvolvedor

ANUNCIADO Remover?

ENTRADA

Processo Automático

SAÍDA

Lado cliente

ANUNCIADO Remover?

Guia

Formatação de package.json e Ordenação de Chaves

Cole qualquer package.json para obter uma versão limpa e ordenada de forma canônica instantaneamente. Esta ferramenta reorganiza as chaves no nível superior para a sequência padrão do npm (nome, versão, descrição, scripts, dependências, etc.), valida campos obrigatórios e recomendados, verifica os intervalos de versão das dependências e identifica chaves não padrão que engrossam o manifesto. Tudo acontece no seu navegador — nada é enviado.

Como usar

Cole o seu package.json no área de entrada (ou clique em “Tente um exemplo” para ver a ferramenta em ação).
Escolha seu estilo de indentação preferido: 2 espaços, 4 espaços ou tabulação.
Opicionalmente ative a ordenação alfabética para grupos de dependências e a ordenação consciente do ciclo de vida para scripts.
Ative a opção “Remover campos não padrão” se desejar remover chaves desconhecidas no nível superior.
Revise a saída formatada à direita e o relatório de validação com erros, avisos e notas.
Copie o resultado ou baixe diretamente como package.json.

Características

Ordem canônica de chaves – Campos no nível superior reorganizados para a sequência padrão do npm para manter consistência nas diferenças e revisões de código.
Verificação de campos obrigatórios e recomendados – Identifica campos faltantes name/version e entradas recomendadas como description, licensee, e repository.
Validação de intervalo de versão – Verifica cada entrada em dependencies, devDependencies, peerDependenciese, e optionalDependencies usa um intervalo válido de semver (cabeça, tilde, intervalos, protocolos de workspace e mais).
Ordenação de dependências – Opicionalmente alfanuméricamente ordenar cada grupo de dependências para uma saída previsível e amigável para arquivos de bloqueio.
Ordenação consciente de scripts de ciclo de vida – Mantém scripts de ciclo de vida do npm agrupados juntos, depois ordena o restante alfabeticamente. preX/X/postX scripts do ciclo do npm agrupados juntos, em seguida, organizam o restante alfabeticamente.
Remover campos não padrão – Remove chaves desconhecidas no nível superior para manter seu manifesto leve, ou mantenha-as (elas são movidas para o final).
Controle de indentação – Saída com 2 espaços, 4 espaços ou um caractere de tabulação para corresponder às regras de formatação do seu projeto.
Somente no lado do cliente – A análise, validação e reorganização ocorrem inteiramente no seu navegador. Nada é transmitido.

 Perguntas frequentes

Por que a ordem das chaves no package.json importa?

A especificação JSON trata objetos como desordenados, mas na prática a ordem das chaves afeta a legibilidade humana, a clareza das diferenças em solicitações de pull e a forma como várias ferramentas apresentam o arquivo. Uma ordem canônica — popularizada pelo CLI do npm e amplamente adotada por ferramentas do ecossistema — coloca os campos de identidade (nome, versão) primeiro, seguidos por metadados, pontos de entrada e, finalmente, blocos de dependências e configuração. Uma ordem consistente reduz conflitos de fusão e torna os manifestos mais fáceis de escanear.
O que é semver e por que a sintaxe de intervalo de versão importa?

A versão semântica (semver) define versões como trios MAJOR.MINOR.PATCH com regras rígidas sobre o que cada segmento indica. Os operadores de intervalo como caret (^), tilde (~) e comparadores (>=, <) indicam ao gerenciador de pacotes quais versões futuras você está disposto a aceitar sem quebrar seu contrato. Um intervalo inválido ou ambíguo pode causar falhas reprodutíveis na construção ou atualizações inesperadas. A validação de intervalos de forma antecipada detecta erros de digitação antes que eles cheguem a um arquivo de bloqueio.
O que conta como um campo não padrão no package.json?

A especificação do manifesto do npm define um vocabulário fixo de campos no nível superior com significados documentados (nome, versão, scripts, dependências, motores, etc.). Ferramentas frequentemente adicionam suas próprias chaves no nível superior — configuração do ESLint, hooks do Husky, configurações de ferramentas de construção. Essas chaves são tecnicamente válidas JSON, mas vivem fora da especificação do npm. Alguns projetos preferem mantê-las para conveniência, outros as movem para arquivos de configuração dedicados para manter o manifesto focado nas preocupações de pacotamento.
Por que agrupar scripts de ciclo de vida do npm em vez de apenas ordená-los alfabeticamente?

O npm executa scripts de ciclo de vida em uma ordem definida: pré-instalação antes da instalação, pré-publicação antes da publicação, etc. Quando você lê um bloco de scripts, agrupar trios relacionados de ciclo de vida (pré/principal/pós) juntos torna o fluxo de execução evidente de imediato. Uma ordenação puramente alfabética espalharia essas pares — por exemplo, colocando 'postbuild' longe de 'build' — tornando mais difícil entender o que é executado em cada momento.