Formateador JSON

Qué hace este formateador de JSON

JSON (JavaScript Object Notation) es el formato más común para mover datos estructurados entre programas: respuestas de API, archivos de configuración, líneas de registro y más. Está diseñado para ser compacto, lo que también lo hace difícil de leer cuando los objetos se anidan varios niveles o llegan en una sola línea. Esta herramienta toma cualquier JSON que pegues y lo reescribe de dos formas: embellecido, con sangría uniforme para que la estructura se vea de un vistazo, o minificado, sin cada espacio opcional para que sea lo más pequeño posible al enviarlo.

También valida mientras formatea. Como analiza el texto antes de volver a serializarlo, un JSON inválido nunca produce una salida engañosa: en su lugar obtienes la línea y la columna exactas donde falló el análisis, para ir directamente al problema.

Embellecer vs. minificar: cuándo usar cada uno

Los dos modos tienen objetivos opuestos, y la mayoría de los flujos de trabajo usan ambos en distintas etapas:

• Embellece cuando lees o depuras: inspeccionar una respuesta de API, comparar dos payloads o revisar un archivo de configuración en un pull request. La sangría convierte un muro de texto en un árbol navegable.
• Minifica cuando envías: incrustar JSON en HTML, guardarlo en una cookie o caché, o mandarlo en el cuerpo de una petición donde cada byte cuenta. El JSON minificado es exactamente los mismos datos, solo que sin los espacios.

El selector de sangría (2 espacios, 4 espacios o tabulación) solo afecta a la salida embellecida. Dos espacios es la convención más común en JavaScript y en el tooling web; cuatro espacios o tabulaciones convienen a los equipos que las prefieren. Elijas lo que elijas, el resultado sigue siendo JSON válido: la sangría es puramente cosmética.

Leer los errores de validación

Cuando el JSON es inválido, la herramienta reporta la línea y la columna del primer problema en lugar de un mensaje vago de "inválido". Los mensajes de error de los motores difieren entre navegadores y a menudo omiten una posición, así que la ubicación se calcula de forma independiente y señala un buen punto por donde empezar. Corrige el primer error y vuelve a comprobar: un solo carácter suelto suele derivar en varios problemas aparentes.

Errores comunes de JSON

JSON es más estricto que los objetos literales de JavaScript a los que se parece. Estos son los errores que más confunden:

• Comas finales: una coma después del último elemento de un objeto o array es válida en JavaScript pero no en JSON.
• Comillas simples: las cadenas y claves de JSON deben usar comillas dobles. 'valor' es inválido; "valor" es correcto.
• Claves sin comillas: toda clave de objeto debe ser una cadena entre comillas, así que { name: "x" } debe pasar a { "name": "x" }.
• Comentarios: JSON no tiene sintaxis de comentarios. // y /* */ provocarán un error de análisis.
• Números especiales: NaN, Infinity y -Infinity no son números JSON válidos.
• Comillas equivocadas: las "comillas tipográficas" pegadas desde un procesador de textos parecen comillas pero son caracteres distintos y no se analizarán.