Formateador JSON

¿Qué es un Formateador JSON?

Un formateador JSON (también conocido como "pretty printer") transforma datos JSON compactos en una representación legible con indentación adecuada, saltos de línea y estructura visual clara. JSON (JavaScript Object Notation) es el formato de intercambio de datos más utilizado en APIs web, archivos de configuración y comunicación entre microservicios. Aunque las máquinas procesan JSON compacto sin problemas, los desarrolladores necesitan formato legible para depuración, revisión de código y comprensión de estructuras de datos complejas.

Cómo Funciona el Formateo JSON

El proceso de formateo JSON consiste en parsear la cadena de entrada en una estructura de datos en memoria (árbol de objetos/arrays) y luego serializarla de vuelta con reglas de indentación. Internamente, esta herramienta usa JSON.parse() para validar y parsear, seguido de JSON.stringify(value, null, indent) donde indent controla los espacios de indentación (por defecto 2 espacios).

Durante este proceso, la herramienta también valida la sintaxis. Si el JSON de entrada contiene errores — como comas finales, comillas simples en lugar de dobles, o claves sin comillas — el parser genera un mensaje de error indicando la posición exacta del problema, facilitando la corrección rápida.

El formateo no modifica los datos: no altera valores, no reordena claves ni elimina campos. Solo añade espacios en blanco que son ignorados por cualquier parser JSON estándar, haciendo que el proceso sea completamente reversible mediante minificación.

Casos de Uso del Formateo JSON

• Depuración de APIs: Cuando una respuesta de API llega como JSON compacto en una sola línea, formatearla permite inspeccionar rápidamente campos, arrays anidados y relaciones entre datos.
• Revisiones de código: Los archivos de configuración JSON (package.json, tsconfig.json, terraform.tfvars.json) son más fáciles de revisar en diffs cuando mantienen formato consistente.
• Documentación: Incluir JSON formateado en documentación técnica, tickets de soporte o mensajes de Slack mejora la comunicación entre equipos.
• Aprendizaje: Los desarrolladores junior comprenden mejor la estructura de datos JSON cuando pueden ver la jerarquía visual con indentación.
• Validación rápida: Si el JSON se formatea correctamente, es válido. Un error de formateo indica un problema de sintaxis que necesita corrección.

Validación de Sintaxis JSON

La especificación JSON (ECMA-404 / RFC 8259) define reglas estrictas: las cadenas deben usar comillas dobles, los objetos y arrays deben estar correctamente anidados, no se permiten comas finales, y los valores solo pueden ser string, number, boolean, null, object o array. Cualquier desviación produce JSON inválido que será rechazado por parsers estrictos.

Los errores más comunes incluyen: comas después del último elemento de un array u objeto (trailing commas), uso de comillas simples en lugar de dobles, valores undefined o funciones (válidos en JavaScript pero no en JSON), y caracteres de control no escapados dentro de strings.

Esta herramienta detecta estos errores durante el formateo y muestra mensajes descriptivos con la posición del error para que puedas corregir el problema rápidamente sin necesidad de herramientas adicionales de debugging.

Code Examples

Formatear JSON con JavaScript nativo

// Format JSON with 2-space indentation
const compact = '{"name":"StrateCode","tools":["json-formatter","base64-encode"],"version":1}';
const formatted = JSON.stringify(JSON.parse(compact), null, 2);
console.log(formatted);
// {
//   "name": "StrateCode",
//   "tools": [
//     "json-formatter",
//     "base64-encode"
//   ],
//   "version": 1
// }

Standards & Specifications

• RFC 8259 — Especificación del formato de intercambio de datos JSON
• ECMA-404 — Estándar ECMA para la sintaxis de datos JSON