¿Odias los anuncios? Ir Sin publicidad Hoy 

Formateador y ordenador de claves de package.json

DatosDesarrollador

ANUNCIO · ¿ELIMINAR?

APORTE

Proceso automático

PROD.

Lado cliente

ANUNCIO · ¿ELIMINAR?

Guía

Formateador y ordenador de claves de package.json

Pegar cualquier package.json para obtener una versión limpia y ordenada de forma canónica de inmediato. Esta herramienta reordena las claves de nivel superior a la secuencia estándar del npm (nombre, versión, descripción, scripts, dependencias, etc.), valida los campos requeridos y recomendados, revisa los rangos de versión de tus dependencias y marca claves no estándar que enmascaran el manifiesto. Todo esto ocurre en tu navegador — nada se sube.

Cómo Usar

Pega tu package.json en el área de entrada (o haz clic en “Prueba un ejemplo” para ver la herramienta en acción).
Elige el estilo de sangría que prefieras: 2 espacios, 4 espacios o tabulador.
Opcionalmente habilita el orden alfabético para grupos de dependencias y el orden inteligente para scripts de ciclo de vida.
Alternar “Eliminar campos no estándar” si deseas eliminar claves de nivel superior desconocidas.
Revisa la salida formateada a la derecha más el informe de validación con errores, advertencias y notas.
Copiar el resultado o descargarlo directamente como package.json.

Características

Ordenación canónica de claves – Los campos de nivel superior reordenados a la secuencia estándar del npm para mantener la coherencia en diferencias y revisiones de código.
Verificación de campos requeridos y recomendados – Detecta faltantes name/version y entradas recomendadas como description, licensey repository.
Validación de rangos de versión – Verifica cada entrada en dependencies, devDependencies, peerDependenciesy optionalDependencies usa un rango válido de semver (caret, tilde, rangos, protocolos de espacio de trabajo, etc.).
Ordenamiento de dependencias – Opcionalmente ordena alfabéticamente cada grupo de dependencias para una salida predecible y amigable con los archivos de bloqueo.
Ordenamiento inteligente de scripts de ciclo de vida – Mantiene los scripts de ciclo de vida de npm juntos, luego ordena el resto alfabéticamente. preX/X/postX Los scripts del ciclo de npm se agrupan juntos, luego se ordenan alfabéticamente los demás.
Eliminar campos no estándar – Elimina claves de nivel superior desconocidas para mantener tu manifiesto ligero, o mantén las claves (se mueven al final).
Control de sangría – Salida con 2 espacios, 4 espacios o un carácter de tabulación para ajustarse a las reglas de formato de tu proyecto.
Solo del lado del cliente – La interpretación, validación y reordenación se realizan completamente en tu navegador. Nada se transmite.

 Preguntas frecuentes

¿Por qué importa el orden de las claves en package.json?

La especificación de JSON trata a los objetos como sin orden, pero en la práctica el orden de las claves afecta la legibilidad humana, la claridad de las diferencias en solicitudes de cambios y cómo presentan varias herramientas el archivo. Un orden canónico — popularizado por la CLI del npm y ampliamente adoptado por herramientas del ecosistema — coloca los campos de identidad (nombre, versión) primero, seguido de metadatos, puntos de entrada y finalmente bloques de dependencias y configuración. Un orden consistente reduce los conflictos de fusión y hace más fácil escanear los manifiestos.
¿Qué es semver y por qué importa la sintaxis de rangos de versión?

La versión semántica (semver) define versiones como triples MAJOR.MINOR.PATCH con reglas estrictas sobre lo que cada segmento indica. Los operadores de rango como caret (^), tilde (~) y comparadores (>=, <) indican a los gestores de paquetes qué versiones futuras estás dispuesto a aceptar sin romper tu contrato. Un rango inválido o ambiguo puede causar fallos reproducibles en compilaciones o actualizaciones inesperadas. Validar rangos desde el inicio detecta errores de escritura antes de que lleguen a un archivo de bloqueo.
¿Qué se considera un campo no estándar en package.json?

La especificación del manifiesto del npm define un vocabulario fijo de campos de nivel superior con significado documentado (nombre, versión, scripts, dependencias, motores, etc.). Las herramientas suelen añadir sus propios campos de nivel superior — configuración de ESLint, hooks de Husky, configuraciones de herramientas de compilación. Estos campos son técnicamente válidos JSON pero viven fuera de la especificación del npm. Algunos proyectos prefieren mantenerlos por comodidad, otros los mueven a archivos de configuración dedicados para mantener el manifiesto enfocado en preocupaciones de empaquetado.
¿Por qué agrupar los scripts de ciclo de vida de npm en lugar de ordenarlos simplemente alfabéticamente?

npm ejecuta los scripts de ciclo de vida en un orden definido: preinstall antes de install, prepublish antes de publish, etc. Cuando lees un bloque de scripts, agrupar trios relacionados de ciclo de vida (pre/principal/post) juntos hace que el flujo de ejecución sea evidente al instante. Un orden alfabético puro dispersaría estos pares — por ejemplo, colocando 'postbuild' lejos de 'build' — haciendo más difícil razonar sobre qué se ejecuta cuando.