Respuesta rápida
- En el navegador: pega tu contenido en el formateador de JSON de FormatArc — se ejecuta completamente del lado del cliente, sin subir nada
- En la terminal:
echo '{...}' | jq .opython3 -m json.tool - En código:
JSON.stringify(data, null, 2)en JavaScript/Node.js
El resto de esta guía cubre estas tres vías con ejemplos, errores de análisis comunes y cuándo conviene elegir cada una.
¿Qué es el formateo de JSON?
JSON (JavaScript Object Notation) es uno de los formatos de datos más utilizados. Lo encuentras en respuestas de API, archivos de configuración e intercambios de datos entre servicios.
Sin embargo, el JSON minificado es difícil de leer para las personas, así que darle formato legible para revelar su estructura es una tarea habitual para quienes programan.
Errores de sintaxis comunes en JSON
La gramática de JSON está definida por dos especificaciones oficiales: RFC 8259 (el estándar de la IETF, "The JavaScript Object Notation (JSON) Data Interchange Format") y ECMA-404 (el estándar de ECMA, "The JSON Data Interchange Syntax"). Ambas definen la misma sintaxis, así que las reglas que siguen no son particularidades del formateador: provienen directamente de la especificación.
1. Comas finales
{
"name": "example",
"value": 42,
}
Una coma después de la última propiedad es JSON inválido. JavaScript la permite, pero la especificación de JSON no.
2. Comillas simples
{'name': 'example'}
JSON requiere comillas dobles ". Las comillas simples ' no son válidas.
3. Claves sin comillas
{name: "example"}
Toda clave en JSON debe ir entre comillas dobles.
Tabla de corrección de errores de sintaxis en JSON
La siguiente tabla relaciona los errores de sintaxis más comunes con la corrección que exige RFC 8259 / ECMA-404.
| Error | Ejemplo inválido | Corrección |
|---|---|---|
| Coma final | {"a": 1,} |
Elimina la coma después del último valor: {"a": 1} |
| Comillas simples | {'a': 'b'} |
Usa comillas dobles: {"a": "b"} |
| Claves sin comillas | {a: 1} |
Envuelve cada clave en comillas dobles: {"a": 1} |
| Comentarios | {"a": 1} // note |
JSON no tiene sintaxis de comentarios; elimina el comentario |
| Cero inicial | {"a": 01} |
Los números no pueden llevar un cero inicial: {"a": 1} |
| Signo más en un número | {"a": +1} |
Quita el + inicial: {"a": 1} |
| Número hexadecimal / octal | {"a": 0x1F} |
Solo se permite la notación decimal: {"a": 31} |
NaN / Infinity |
{"a": NaN} |
No son valores JSON válidos; usa un número o null |
| Valor undefined | {"a": undefined} |
undefined no es un valor JSON; usa null |
| Carácter de control sin escapar | salto de línea dentro de "..." |
Escápalo como \n dentro de la cadena |
| Barra invertida sin escapar | {"a": "C:\path"} |
Escapa la barra invertida: {"a": "C:\\path"} |
| Propiedad con comillas simples | {"key": 'value'} |
Los valores de cadena también requieren comillas dobles: {"key": "value"} |
Formatear JSON con JSON.stringify()
En JavaScript y Node.js, JSON.stringify() acepta un tercer argumento para la indentación. Esta es la forma más rápida de formatear JSON en código:
const data = { name: "Alice", age: 30, roles: ["admin", "editor"] };
// Pretty-print with 2-space indent
console.log(JSON.stringify(data, null, 2));
Salida:
{
"name": "Alice",
"age": 30,
"roles": [
"admin",
"editor"
]
}
El segundo argumento (null en este caso) es una función o un arreglo de reemplazo que filtra qué propiedades incluir. Pasa null para conservar todo.
También puedes usar un carácter de tabulación para la indentación:
JSON.stringify(data, null, "\t");
Formatear JSON en la terminal
Con jq
jq es un procesador de JSON ligero para la línea de comandos. Canaliza cualquier salida JSON a través de él para obtener resultados formateados:
echo '{"name":"Alice","age":30}' | jq .
Con Python
Python incluye un módulo JSON integrado que funciona como un formateador rápido:
echo '{"name":"Alice","age":30}' | python3 -m json.tool
Con curl y jq
Al depurar API, combina curl con jq para formatear la respuesta:
curl -s https://api.example.com/data | jq .
Formatear JSON en tu navegador
El formateador de JSON de FormatArc te permite formatear JSON enteramente en el navegador. Tus datos nunca se envían a un servidor, lo que lo hace seguro para cargas útiles de API y configuraciones internas.
Cómo usarlo
- Pega tu JSON en el área de entrada
- Haz clic en "Run"
- Copia la salida formateada
Tres pasos sencillos para obtener un JSON limpio y legible.
Validar el JSON antes de formatear
Si tu JSON está mal formado, el formateo fallará. Las causas más comunes son las comas finales, las comillas simples y las claves sin comillas (vistas arriba). Si necesitas comentarios en tus archivos de configuración, consulta JSONC, JSON5 y otras alternativas. Cuando te encuentras con un error de análisis, el mensaje de error suele incluir una posición de carácter, pero puede resultar difícil de mapear al problema real en un archivo grande.
El formateador de JSON de FormatArc muestra el número de línea aproximado donde ocurrió el error, lo que facilita saltar al lugar correcto. Para un recorrido más detallado de los errores de análisis comunes y cómo solucionarlos, consulta Cómo solucionar errores de análisis de JSON.
Formatear JSON automáticamente con una extensión de Chrome
Si abres con frecuencia endpoints de API directamente en el navegador, una extensión de Chrome puede formatear la respuesta automáticamente por ti. Consulta Comparativa de las mejores extensiones de Chrome para formatear JSON para un análisis de JSONView, JSON Formatter y otras opciones populares.
Trabajar con otros formatos de datos
El formateo de JSON suele formar parte de un flujo de trabajo más amplio que incluye convertir entre formatos:
- YAML vs JSON — comprende cuándo usar cada formato
- Convertir YAML a JSON — convierte configuraciones de Kubernetes y archivos de CI en JSON
- Convertir CSV a JSON — transforma exportaciones de hojas de cálculo en arreglos JSON
- Guía de sintaxis de JSON — los fundamentos para escribir JSON válido
- Usar formatarc como paquete de npm — formatea JSON desde la terminal con la CLI de formatarc
- Formatear respuestas JSON de curl — formatea respuestas de API directamente desde curl con jq o líneas únicas de python
Pruébalo ahora
¿Tienes JSON desordenado que necesita formato? Abre el formateador de JSON, pega tus datos y obtén una salida limpia al instante. Sin registro, sin servidor: todo permanece en tu navegador.
Resumen
- Dar formato legible al JSON es una tarea cotidiana en desarrollo y operaciones
- Usa
JSON.stringify(data, null, 2)para formatear JSON en JavaScript - En la terminal, canaliza el JSON a través de
jqopython3 -m json.tool - Los errores de sintaxis más comunes son las comas finales, las comillas simples y las claves sin comillas
- FormatArc formatea JSON de forma segura en el navegador sin intervención de ningún servidor