📋 Contenidos
Por Qué el JSON Sin Formatear Daña Tu Cerebro
JSON es el formato de datos universal de la web. Todas las API lo devuelven. Todos los archivos de configuración lo usan. Y la mitad de las veces, llega con este aspecto:
{"users":[{"id":1,"name":"Alice","email":"alice@example.com","roles":["admin","editor"],"metadata":{"lastLogin":"2026-07-28T09:14:00Z","loginCount":142,"preferences":{"theme":"dark","notifications":{"email":true,"push":false,"sms":null}}}},{"id":2,"name":"Bob","email":"bob@example.com","roles":["viewer"],"metadata":{"lastLogin":"2026-07-27T18:30:00Z","loginCount":7,"preferences":{"theme":"light","notifications":{"email":true,"push":true,"sms":null}}}}]}
Esto son solo dos objetos de usuario. Una respuesta real de API podría tener 500. Encontrar el campo que necesitas en un muro de texto de 50.000 caracteres no solo es molesto, sino propenso a errores. Leerás mal un nivel de anidamiento, te saltarás un corchete de cierre, o pasarás de largo el valor que realmente buscas.
El JSON formateado tiene este aspecto:
{
"users": [
{
"id": 1,
"name": "Alice",
"email": "alice@example.com",
"roles": ["admin", "editor"],
"metadata": {
"lastLogin": "2026-07-28T09:14:00Z",
"loginCount": 142,
"preferences": {
"theme": "dark",
"notifications": {
"email": true,
"push": false,
"sms": null
}
}
}
}
]
}
Los mismos datos. Pero ahora puedes ver la estructura: users es un array, cada usuario tiene roles y metadata, metadata.preferences.notifications tiene tres campos booleanos. La indentación es la documentación.
Los 3 Errores de Sintaxis JSON Que Lo Rompen Todo
Después de formatear, el siguiente paso es la validación. JSON parece simple — claves y valores, corchetes y llaves — pero las reglas estrictas de sintaxis significan que pequeños errores causan fallos completos de análisis. Estos son los tres errores que vemos con más frecuencia:
1. Comas Finales
Este es el asesino número 1 de JSON. Los objetos de JavaScript permiten comas finales. JSON no.
// ❌ JSON inválido — coma final después de "viewer"
{
"name": "Alice",
"roles": ["admin", "viewer",],
"active": true,
}
Esa coma extra después de "viewer" o true? Error de análisis instantáneo. La solución: elimina las comas finales de arrays y objetos. Un buen formateador/validador señalará la línea exacta.
2. Claves Sin Comillas
JavaScript permite escribir {name: "Alice"}. JSON requiere {"name": "Alice"}. Las claves deben ser strings con comillas dobles. Las comillas simples tampoco valen — {'name': 'Alice'} no es JSON válido.
3. Líneas de Comentario
JSON no soporta comentarios. Ni // inline, ni /* block */, nada. JSONC (JSON with Comments) existe para archivos de configuración como settings.json de VS Code, pero los analizadores JSON estándar rechazarán cualquier comentario. Si necesitas comentarios, usa un campo "_comment" o cambia a YAML.
| Error | Ejemplo | Cómo detectarlo |
|---|---|---|
| Coma final | {"a": 1,} | Coma antes de } o ] de cierre |
| Clave sin comillas | {name: "Alice"} | Clave sin comillas dobles |
| Comillas simples | {'name': 'Alice'} | Comillas simples alrededor de claves o valores |
| Comentarios | {/* user */ "name": "A"} | Cualquier // o /* */ en JSON |
| NaN/Infinity simple | {"score": NaN} | NaN, Infinity, undefined (usa null) |
Formatear vs. Validar — No Son Lo Mismo
La gente confunde estas dos operaciones. Son completamente diferentes:
Formatear (pretty-printing) toma JSON válido y añade indentación y saltos de línea. La entrada ya se puede analizar. La salida son los mismos datos, solo que legibles.
Validar comprueba si la entrada es sintácticamente correcta como JSON. Detecta comas finales, claves sin comillas, anidamiento roto. Un validador te dice si es JSON y dónde falla.
Una buena herramienta hace ambas cosas: primero valida (encuentra errores), luego formatea (lo hace legible). Nuestro JSON Formatter hace exactamente esto — pega, haz clic en Formatear, y aplica pretty-printing o muestra la línea y columna exactas del error de sintaxis.
Minificación: La Operación Inversa
A veces quieres lo contrario: tomar JSON formateado y eliminar todos los espacios para minimizar el tamaño del archivo. Esto es la minificación. Útil para:
- Reducir el tamaño de las respuestas de API
- Incrustar JSON en URLs (codificado en Base64)
- Almacenar JSON en columnas de bases de datos donde los espacios son bytes desperdiciados
La minificación elimina espacios, tabulaciones y saltos de línea entre tokens — pero conserva los espacios dentro de los valores de texto. Un archivo JSON formateado de 4KB suele reducirse a ~2.5KB minificado.
Un Flujo de Trabajo Real: Respuesta de API → Legible → Depurada
Aquí tienes un flujo de trabajo concreto para depurar cuando una respuesta de API no se ve bien:
- Copia la respuesta cruda desde la pestaña Red de tu navegador, la salida de curl, o los logs del servidor.
- Pégalo en un formateador JSON. Presiona Formatear. Si da error, tienes un problema de sintaxis — arréglalo antes de hacer cualquier otra cosa.
- Examina la estructura. Coincide el nivel superior con lo que esperabas?
dataes un objeto o un array? Los campos anidados están donde la documentación de la API dice que deberían estar? - Encuentra la anomalía. Usa la vista de árbol plegable del formateador (si está disponible) para profundizar en objetos anidados. Falta un campo? Un nulo inesperado? Tipo incorrecto (string en lugar de número)?
- Extrae y prueba. Copia el fragmento JSON relevante, modifícalo, vuelve a validar. Cuando tenga el aspecto correcto, actualiza tu código de análisis.
{\"name\":\"Alice\"}. Un formateador no solucionará esto — necesitas hacer JSON.parse() dos veces. Si tu salida formateada todavía muestra caracteres de escape, estás ante una doble codificación.Herramientas Gratuitas para Formatear JSON al Instante
No necesitas instalar nada. Estas herramientas funcionan en tu navegador:
- iluv.tools JSON Formatter — Valida, formatea (indentación de 2/4 espacios), minifica y vista de árbol. Copia y pega, listo. Sin necesidad de cuenta.
- Conversor de JSON a CSV — Si tu JSON es un array de objetos, conviértelo directamente a formato de hoja de cálculo.
- Conversor de CSV a JSON — Lo inverso: convierte exportaciones de hojas de cálculo en JSON estructurado.
Para usuarios de línea de comandos, python -m json.tool y jq son las herramientas estándar. Pero cuando estás depurando en un navegador, un formateador basado en web es más rápido — sin terminal, sin guardar archivos, solo pega y ve los resultados al instante.