Cómo validar, formatear y minificar JSON

Reconoce errores de sintaxis y entiende qué conserva el analizador JSON del navegador.

Guía prácticaActualizado Lectura aprox.: 3 min
En esta página

JSON necesita sintaxis precisa

Los nombres de propiedades y las cadenas llevan comillas dobles. No se admiten comentarios, comas finales, undefined ni comillas simples para cadenas.

Un ejemplo válido es {"name":"Snipshed","local":true}. Formatearlo añade sangría y saltos de línea; minificarlo elimina el formato sin quitar los espacios dentro de una cadena.

Leer un error de validación

Si falla, revisa primero la zona indicada por posición, línea o columna cuando esté disponible. Una coma ausente puede hacer que el error aparezca en el siguiente elemento.

El formato no repara automáticamente un documento incorrecto. Corrige la entrada y vuelve a validar.

  1. Pega el contenido JSON sin envoltorios de Markdown.
  2. Elige 2 o 4 espacios si quieres formatear.
  3. Valida y comprueba la estructura del resultado.
  4. Minifica solo después de confirmar que los datos son correctos.

Precisión y claves duplicadas

Se usa JSON.parse y JSON.stringify del navegador. Los enteros fuera del rango de precisión de JavaScript pueden cambiar y una clave repetida conserva su última aparición.

Si necesitas preservar números muy grandes, conserva esos valores como cadenas o usa un flujo especializado. La herramienta es local; formatear tampoco cifra ni anonimiza los datos.

Ordenar claves sin ordenar las listas

Ordenar claves JSON cambia la representación de los objetos de forma recursiva. Puedes elegir orden ascendente o descendente por unidades UTF-16, sin reglas alfabéticas regionales. Los objetos que estén dentro de listas también se ordenan, pero las posiciones de la lista permanecen iguales. Ordenar claves no hace equivalentes dos documentos con valores diferentes.

Prueba el ejemplo: a aparece antes que z y el objeto interno queda ordenado, pero el número 1 sigue siendo el segundo elemento de la lista. Se admiten 80 niveles y 100000 caracteres de entrada; los enteros fuera del rango seguro se rechazan. Las claves repetidas conservan su última aparición. Guarda identificadores grandes como cadenas y conserva el original si necesitas preservar su representación exacta.

{"z":1,"a":[{"b":2,"a":3},1]}
→
{"a":[{"a":3,"b":2},1],"z":1}

Criterios para revisar y entregar el resultado

Prepara una muestra que refleje la estructura de tu aplicación: un objeto con campos, una lista y valores de distintos tipos. Revisa la sintaxis antes de modificar contenido para resolver un error. Comentarios, comillas simples y comas finales pueden pertenecer a otra representación, pero no a JSON estándar admitido por estas herramientas. Si la muestra se valida y la API la rechaza, compara sus campos y tipos con el contrato del receptor.

Formatear y minificar utilizan análisis y serialización, por lo que no debes esperar preservar todos los bytes de entrada. Claves repetidas y enteros fuera de la precisión ordinaria necesitan especial atención. Conserva la fuente si verificas una firma, un ejemplo con identificadores grandes o una representación exacta. Para una revisión práctica, compara cantidad de elementos, cadenas con espacios y valores importantes antes y después. La versión legible ayuda a inspeccionar; la compacta facilita ciertos campos técnicos. Ninguna de las dos certifica que los datos sean correctos para el negocio. Si utilizas el ejemplo en documentación pública, sustituye credenciales y datos reales por valores ficticios antes de compartirlo.

PONLO EN PRÁCTICA

Revisar una respuesta antes de compartirla

Pega {"ok":true,"n":2} y usa una sangría de dos espacios. Después abre contacts.json en un editor de texto y pega su contenido para probar una lista de varios objetos.

El objeto se valida y se muestra con una propiedad por línea. Los valores no se traducen ni se convierten al idioma de la interfaz.

Una coma después de la última propiedad o una clave sin comillas produce un error. El formateador no detecta si un campo es correcto para la API de destino: eso depende del esquema de esa API.

Ver captura de la herramienta
Ejemplo de Formatear y validar JSON con datos de prueba
Captura de Snipshed en Chrome con el ejemplo descrito. Los archivos descargables contienen datos ficticios.