Formatear JSON

Qué sobrevive al ida y vuelta

Formatear es analizar y volver a imprimir, y los números son la única parte que se conserva tal como la escribiste. Eso va más allá del caso de los enteros grandes que cuenta el aviso: cualquier número cuya escritura más corta en JavaScript difiera de la tuya se vuelve a emitir a partir del original, así que 1.10 conserva su cero final, 1e5 se mantiene en notación exponencial y un cero negativo sigue siendo negativo. En el aviso solo se cuentan los enteros no seguros, porque en esos la alternativa es una corrupción silenciosa y no una escritura más ordenada.

Las cadenas no se conservan como texto. Las secuencias de escape se decodifican al leer el documento y se escriben de nuevo al imprimirlo, así que \u0041 vuelve como A y una barra diagonal escapada vuelve sin escapar. El valor es idéntico y los bytes no, lo que solo importa en una situación, pero ahí importa mucho: si algo más adelante compara dos archivos JSON byte a byte, pasar uno de ellos por un formateador no es una operación neutra.

Antes de confiar en un reformateo conviene conocer dos comportamientos a nivel de objeto. Las claves duplicadas se resuelven sin avisar, y gana la última, exactamente como las resuelve el propio parser del navegador: un documento con dos campos "id" se formatea sin quejas y vuelve con uno solo, y nada te indica que existía el otro. Y el orden de las claves es el de tu archivo solo para las claves que no son números enteros: un objeto con "1", "2" y "name" vuelve con las claves numéricas primero, en orden numérico, porque así es como el propio JavaScript ordena las propiedades de un objeto. Las claves normales mantienen el orden en que las escribiste.

Si buscas otra cosa

Si lo que tienes es un tsconfig.json, una configuración de ESLint o un archivo de configuración de VS Code, esta página señalará los comentarios y las comas finales en lugar de formatear respetándolos: es la respuesta correcta para una herramienta de JSON y la herramienta equivocada para tu archivo. Esos archivos son JSONC, y tu editor ya los analiza; en la línea de comandos, json5 y dasel los leen sin fingir que son JSON.

Para cualquier cosa más allá de cambiar la sangría, un formateador no es el tipo de herramienta adecuado. jq hace en una sola expresión lo que un cuadro de texto no puede controlar: jq -S . ordena las claves de cada objeto para poder comparar dos respuestas, jq 'del(.token)' elimina un campo antes de mostrarle un payload a nadie, y jq -c compacta un array de objetos en el JSON Lines que espera un pipeline. Además, lee un archivo y no el portapapeles, lo que marca la diferencia cuando el documento es más grande de lo que puedes seleccionar cómodamente.