Cómo formatear JSON sin romper la estructura

Qué cambia al formatear JSON

Formatear JSON consiste en convertir un texto compacto en una versión fácil de leer. Las claves, los valores, las llaves y los corchetes siguen describiendo los mismos datos si la entrada es válida. Lo que cambia es la presentación: cada nivel aparece separado y con sangría.

JSON se usa para intercambiar datos entre aplicaciones y también para guardar configuraciones sencillas. Un listado de productos, una respuesta de una API o los datos de un formulario pueden llegar sin saltos de línea. Antes de modificar nada, tener el contenido ordenado reduce la posibilidad de tocar una coma o una llave equivocada.

Conviene distinguir el texto de los datos que representa. Dos textos JSON pueden tener un aspecto distinto y describir la misma información, porque los espacios fuera de las cadenas no cambian el significado. Sin embargo, un espacio dentro de un texto sí forma parte del valor.

Cómo funciona el Formateador JSON

El Formateador JSON de Nítido Tools analiza primero lo que pegas mediante JSON.parse. Si el contenido es válido, lo vuelve a imprimir con JSON.stringify y una indentación de dos espacios. Así obtienes líneas separadas para objetos y arrays, con un nivel visual claro para cada bloque.

La herramienta no intenta adivinar qué querías escribir. Si falta una comilla, sobra una coma o el texto no cumple la sintaxis JSON, muestra un mensaje genérico para que revises la entrada. Eso evita presentar como correcto un contenido que no se ha podido interpretar.

El resultado es una representación formateada del valor que el navegador ha podido analizar. Puede servir para leer un objeto, una lista, un número, una cadena, true, false o null que sean JSON válidos. No añade campos, no verifica reglas propias de una aplicación y no conoce cuál era tu intención de negocio.

Un ejemplo realista: revisar un pedido

Imagina que una pequeña tienda de Valencia recibe de su sistema de pedidos una respuesta JSON en una sola línea. Dentro hay un número de pedido, la dirección de entrega, una lista de artículos y un importe. Al pegarla en el Formateador JSON, cada artículo queda dentro de su propio bloque y es más sencillo comprobar dónde empieza y termina. También puedes ver con rapidez si el campo de provincia está junto a la dirección o en otra parte del objeto.

No uses el formato para deducir que los datos son correctos. Que el texto se imprima con dos espacios significa que el navegador ha podido leer su sintaxis, pero no demuestra que el código postal corresponda a la dirección ni que el importe sea el esperado. Revisa el pedido con la información de origen antes de preparar un envío o una factura. La legibilidad facilita esa revisión, pero no la sustituye.

Un consejo comprobable es hacer una prueba de ida y vuelta con una copia pequeña. Formatea un objeto que contenga una dirección con tilde, una cantidad y una lista de dos artículos; después pega la salida en el Validador JSON de Nítido Tools. Si no has cambiado el resultado, el validador debería aceptarlo porque vuelve a analizar la misma sintaxis. Si falla tras una edición, revisa primero la zona que acabas de tocar.

Errores frecuentes al preparar la entrada

El error más habitual es dejar una coma después del último elemento de un objeto o de un array. En algunos lenguajes esa forma puede ser aceptada, pero JSON.parse no la acepta como JSON válido. También es frecuente usar comillas simples para un texto, copiar comentarios o dejar una clave sin comillas dobles. El Formateador JSON no puede arreglar esas variantes porque necesita interpretar una estructura válida antes de imprimirla.

Otro fallo aparece al pegar contenido desde un correo, una hoja de cálculo o una conversación. Pueden colarse comillas tipográficas, caracteres invisibles o texto antes y después del bloque JSON. Empieza por aislar desde la primera llave o el primer corchete hasta el cierre correspondiente. Si esperas una lista, el primer carácter debe ser un corchete; si esperas un objeto, normalmente será una llave.

Evita editar varias cosas a la vez cuando se muestra el mensaje de error. Elimina una sola coma final, sustituye una comilla o quita el comentario, y procesa de nuevo. Ese método permite saber qué cambio resolvió el problema y evita crear un error nuevo en otra línea. Mantener una copia sin cambios te da un punto seguro al que volver.

Límites que conviene tener claros

Dar formato no equivale a validar el contenido contra las reglas de una aplicación. Una estructura puede ser JSON válido y aun así tener un campo obligatorio ausente, una fecha escrita con un formato no esperado o un precio como texto en lugar de número. La herramienta solo confirma que la entrada puede analizarse como JSON y, si puede, la muestra con dos espacios. Para requisitos concretos, consulta la documentación del sistema que recibirá esos datos.

El formato tampoco conserva necesariamente el aspecto literal del texto original. Los espacios fuera de las cadenas desaparecen y se sustituyen por una distribución uniforme; la salida es una nueva forma de escribir los datos analizados. Por eso no la uses como prueba de que dos archivos son idénticos carácter por carácter. Si necesitas comparar cambios, guarda el original y la versión formateada por separado.

Hay información que no debe copiarse sin necesidad, aunque trabajes en tu propio navegador. Tokens, contraseñas, datos personales o información comercial delicada siguen siendo sensibles cuando están dentro de JSON. Trabaja con una muestra anonimizada si solo necesitas entender la estructura. Y antes de compartir una captura o pegar el resultado en un chat, revisa qué valores aparecen.

Preguntas frecuentes

¿El Formateador JSON corrige un JSON inválido? No. Analiza la entrada con JSON.parse y solo imprime una versión con dos espacios cuando la sintaxis es válida. Si no puede analizarla, muestra un mensaje genérico para que revises el texto.

¿Formatear JSON cambia los datos? La finalidad es cambiar la presentación para hacerla legible. Aun así, la salida es una nueva representación textual, por lo que no debes usarla para comprobar igualdad carácter por carácter con el original.

¿Por qué falla una entrada que parece código correcto? JSON es más estricto que algunas formas de escribir objetos en código. Comillas simples, comentarios y comas finales son ejemplos frecuentes de texto que puede parecer válido en otro contexto y no ser JSON.

¿Puedo comprobar de nuevo el resultado? Sí. Copia la salida y pégala en el Validador JSON. Si no la has modificado, el validador puede volver a analizarla como JSON válido; después comprueba también las reglas que exija tu aplicación.

Prueba pequeña antes de usar el resultado

Empieza con un ejemplo controlado y corto antes de formatear una respuesta completa. Puedes crear un objeto con un cliente ficticio, una ciudad, dos artículos y un importe. Pégalo en la herramienta, procesa y comprueba que cada llave de apertura tiene su cierre y que los dos artículos siguen dentro del mismo array. Esta prueba te familiariza con la sangría sin arriesgar contenido real.

Después realiza una modificación mínima, por ejemplo cambia el nombre de un artículo sin tocar las comillas. Vuelve a procesar y observa que el valor cambia mientras la estructura mantiene sus dos espacios de indentación. A continuación añade una coma final a propósito y procesa otra vez. Debes recibir el mensaje genérico, lo que confirma que la herramienta no presenta como válida una sintaxis que JSON.parse rechaza.