Formateador de JSON

Qué hace realmente el formateo

Formatear JSON es un análisis seguido de una nueva serialización. El documento se lee como un valor y se vuelve a escribir con un salto de línea tras cada coma y una sangría fija por nivel de anidamiento. El modelo de datos no cambia en nada: solo cambian los bytes entre los tokens.

Esa distinción importa porque dos cosas sí se normalizan en el viaje de ida y vuelta, y conviene saber cuáles:

• Los números se reimprimen en su forma más corta. 1.50 pasa a 1.5, 1e3 pasa a 1000 y -0 pasa a 0. El valor es idéntico; la escritura es canónica.
• Los escapes innecesarios desaparecen. "\u0041" pasa a "A". Los escapes que JSON exige — comillas, barras invertidas y caracteres de control — se conservan.
• Los enteros por encima de 2⁵³−1 pierden precisión. Es una propiedad del tipo numérico de JavaScript, no de esta herramienta. Lleva los identificadores grandes como cadenas.

Elegir el ancho de la sangría

El selector de sangría se aplica al instante y se recuerda para tu próxima visita. Como regla general:

• 2 espacios — respuestas de API, cualquier cosa que vayas a pegar en una revisión de código y todo lo que deba coincidir con la salida de JSON.stringify(v, null, 2).
• 4 espacios — archivos de configuración editados a mano, con poco anidamiento pero líneas largas.
• Tabulador — archivos versionados en un repositorio donde cada persona prefiere un ancho distinto.

El mismo trabajo en la línea de comandos

jq . input.json formatea con sangría de 2 espacios, que es la misma salida que produce esta página con su ajuste por defecto. La versión del navegador gana cuando el JSON está en el portapapeles y no en un archivo, cuando prefieres recorrer un árbol antes que leer 4.000 líneas, o cuando la carga contiene algo que preferirías no pasar por una herramienta que no has auditado.

Formatear un documento que no se analiza

Un formateador no puede indentar lo que no puede leer, así que un documento no válido te da un error en lugar de una salida. El panel muestra la línea, la columna, la línea de origen con un indicador justo debajo del carácter y lo que el analizador esperaba ahí. Ir al error coloca el cursor en ese carácter. Si el problema es uno de los casi-JSON habituales, Reparar lo corrige y formatea en un solo paso: consulta el validador para ver el catálogo completo de causas.