Cómo formatear JSON
- Pega tu JSON en el cuadro de entrada. Puede ser una sola línea copiada de la respuesta de una API o un archivo completo.
- Elige Embellecer para sangrarlo (2 espacios, 4 espacios o tabulaciones) o Minificar para quitar todos los espacios. El resultado se actualiza mientras escribes.
- Activa Ordenar claves A–Z para ordenar alfabéticamente las claves de cada objeto; así es más fácil comparar dos documentos.
- Si el JSON no es válido, un mensaje en rojo explica qué falla y en qué línea y columna se detuvo el analizador.
- Pulsa Copiar para llevar el resultado al portapapeles.
Todo ocurre en tu navegador con las funciones integradas JSON.parse y JSON.stringify. No se sube nada, así que puedes pegar sin miedo archivos de configuración o respuestas de API con datos privados.
¿Qué es JSON?
JSON (JavaScript Object Notation) es un formato de texto ligero para guardar e intercambiar datos. Lo usan casi todas las API web, archivos de configuración como package.json y muchas bases de datos. Un documento JSON se construye con seis tipos de valores:
- Objetos: pares clave/valor entre llaves, por ejemplo
{"id": 7}. Las claves deben ir entre comillas dobles. - Arrays: listas ordenadas entre corchetes, por ejemplo
[1, 2, 3]. - Cadenas: texto entre comillas dobles. Los caracteres especiales se escapan con una barra invertida, como
\npara un salto de línea. Las tildes y la ñ se pueden escribir tal cual. - Números: enteros o decimales como
42o-3.14. El separador decimal es siempre el punto, nunca la coma. - Booleanos:
trueofalse, en minúsculas. - null: un valor vacío.
Embellecer o minificar: un ejemplo
El ejemplo del cuadro está minificado: son 68 caracteres en una sola línea.
{"name":"ToolHub","tools":["json","words"],"free":true,"users":1200}
Tras Embellecer con 2 espacios, cada clave queda en su propia línea y los valores anidados se sangran, de modo que la estructura se ve de un vistazo. El JSON embellecido es más fácil de leer, revisar en un pull request y depurar. El minificado ocupa menos: en archivos grandes, quitar los espacios suele reducir el tamaño entre un 10 % y un 20 %, algo que se nota cuando los datos viajan por la red miles de veces. Los datos son idénticos en los dos casos.
Errores frecuentes y cómo corregirlos
- Comas finales:
[1, 2,]es válido en JavaScript, pero no en JSON. Borra la última coma. - Comillas simples:
{'nombre': 'Ana'}falla. Claves y cadenas deben usar comillas dobles. - Claves sin comillas:
{nombre: 1}debe escribirse{"nombre": 1}. - Comentarios: el JSON estándar no admite
//ni/* */. - Coma decimal:
3,5no es un número JSON; escribe3.5. Es un error típico al copiar datos de una hoja de cálculo configurada en español. - Literales de otros lenguajes:
True,Noneoundefinedno existen en JSON; solotrue,falseynull.
Consejo: cuando el error señale una línea, revisa también el carácter anterior. Una coma o unas comillas que faltan en la línea previa suelen ser la causa real, porque el analizador solo detecta el problema un paso después.
Preguntas frecuentes
¿Se envía mi JSON a algún servidor?
No. El formateo y la validación se hacen por completo en tu navegador con el analizador JSON integrado de JavaScript.
¿Qué significa minificar JSON?
Minificar elimina los espacios y saltos de línea innecesarios para que el JSON ocupe menos al enviarlo por la red. Los datos no cambian.
¿Por qué mi JSON no es válido?
Las causas más comunes son comas finales, comillas simples en lugar de dobles, claves sin comillas y comentarios. El mensaje de error indica la línea y la columna del problema.