Ontoom

Formatear JSON

Alinea (pretty), minifica y valida JSON en el navegador.

Importante: El JSON no sale de tu navegador.

Qué hace esta herramienta

Pegas un texto y el formateador lo pasa por el mismo analizador que usa tu navegador, JSON.parse. Obtienes uno de tres resultados: el JSON alineado con la indentación que elijas, el JSON minificado en una sola línea o la confirmación de que es válido. Cuando falla, se muestra el error del analizador, normalmente con la posición del carácter donde se rompió.

Todo ocurre en el navegador. El JSON no viaja a los servidores de Ontoom, algo importante cuando es la respuesta de una API interna o un archivo de configuración. Aun así, evita pegar tokens o contraseñas de producción en cualquier web, incluida esta.

Cómo usarla

  1. Pega el JSON en el campo de entrada. Valen objetos, arrays y valores sueltos como un texto entre comillas.
  2. Elige la indentación (2 o 4 espacios son lo habitual) y pulsa Formatear.
  3. Pulsa Minificar cuando necesites una sola línea, por ejemplo para una variable de entorno o el body de un curl.
  4. Pulsa Validar si solo quieres saber si el texto es JSON válido.
  5. Copia el resultado con el botón Copiar.

Las reglas que más errores causan

JSON está definido en la RFC 8259 y en ECMA-404. Se parece a JavaScript, pero es mucho más estricto. Casi todos los fallos vienen de alguno de estos puntos:

  • Claves y textos van con comillas dobles. {'nombre': 'Ana'} con comillas simples no es válido.
  • No se admiten comas finales: [1, 2, 3,] y {"a": 1,} fallan.
  • Los comentarios no forman parte de JSON. Archivos como tsconfig.json los permiten porque usan un dialecto (JSONC), no JSON puro.
  • Los únicos literales son true, false y null, en minúsculas. undefined, NaN e Infinity no existen en JSON.
  • Los números no pueden tener ceros a la izquierda (007) ni signo más (+5).
  • Los saltos de línea y tabulaciones dentro de un texto deben escaparse como \n y \t.

Ejemplo

Entrada minificada, tal como la devuelve una API, y la salida con 2 espacios:

{"id":42,"activo":true,"etiquetas":["qa","api"],"dueño":{"nombre":"Prueba","email":null}}

{
  "id": 42,
  "activo": true,
  "etiquetas": [
    "qa",
    "api"
  ],
  "dueño": {
    "nombre": "Prueba",
    "email": null
  }
}

Detalles que conviene saber

Formatear solo cambia espacios, pero JSON.parse tiene dos efectos que pueden sorprender. Si un objeto repite una clave, solo sobrevive el último valor. Y los enteros mayores que 9.007.199.254.740.991 (2^53 − 1) pierden precisión porque JavaScript los guarda como coma flotante. Por eso los IDs largos, como los de algunas bases de datos y redes sociales, deberían viajar como texto.

El orden de las claves se conserva tal como llegó. Para comparar dos documentos, formatea ambos con la misma indentación antes de hacer un diff.

Usos habituales

  • Leer la respuesta de una API durante pruebas manuales o tras lanzar una petición con cURL online.
  • Inspeccionar un token: el decodificador de JWT muestra el header y el payload, que son JSON.
  • Minificar un fixture antes de guardarlo en una variable o en una columna de la base de datos.
  • Encontrar la coma o la comilla que rompe un archivo de configuración.

Preguntas frecuentes

¿Mi JSON se sube a algún sitio?
No. El formateo y la validación usan el JSON.parse de tu propio navegador. El texto no sale de tu dispositivo.
¿Por qué falla un JSON con comentarios?
Los comentarios no forman parte de la especificación JSON. Quita las líneas // o /* */, o usa una herramienta pensada para JSONC o JSON5.
¿Qué diferencia hay entre formatear y minificar?
Formatear añade saltos de línea e indentación para leer mejor. Minificar elimina todos los espacios innecesarios y deja el texto más corto con los mismos datos.
¿Por qué cambió un número grande al formatear?
Los enteros por encima de 2^53 − 1 no se representan con exactitud como números de JavaScript. Pide al sistema de origen que envíe ese campo como texto.
¿La herramienta corrige el JSON sola?
No. Muestra el error del analizador para que lo corrijas tú. Una corrección automática podría cambiar tus datos sin que te dieras cuenta.

Escrito por Orlando Alves · revisado el · Política editorial

Ver también