Formateador JSON

Código

Introducción

Un formateador JSON es una herramienta esencial para cualquiera que trabaje con datos JSON — desarrolladores, testers de API, analistas de datos y redactores técnicos. El JSON sin procesar de APIs o archivos de configuración a menudo está minimizado o mal indentado, lo que dificulta su lectura y depuración. El formateador JSON convierte la entrada JSON desordenada en una salida limpia y bien estructurada con sangrías adecuadas y validación de sintaxis.

A diferencia de las herramientas de línea de comandos o extensiones de navegador que requieren instalación, el Formateador JSON de Toollect funciona completamente en su navegador. Cada pegado se analiza al instante, dándole retroalimentación inmediata sobre la validez y estructura de su JSON. Como no se envían datos a servidores externos, ofrece velocidad y privacidad.

Ya sea que esté depurando una respuesta de API REST, preparando archivos de configuración para despliegue, o enseñando sintaxis JSON, esta herramienta proporciona la precisión e inmediatez que necesita.

Cómo funciona

El formateador JSON está impulsado por los métodos nativos de JavaScript JSON.parse() y JSON.stringify(), el mismo motor que maneja JSON en todos los navegadores modernos y Node.js.

Analizar

La herramienta pasa su texto de entrada a JSON.parse(). Este método lee la cadena e intenta construir un objeto o array de JavaScript en memoria. El analizador es estricto — sigue exactamente la especificación ECMA-404 JSON y rechaza cualquier desviación de la sintaxis JSON válida.

Validar

Si JSON.parse() tiene éxito, la entrada es JSON válido. Si falla, el método lanza un SyntaxError con un mensaje descriptivo. La herramienta captura este error y lo muestra en el área de estado. Errores comunes en esta fase:

  • Unexpected token: Un carácter extra, una coma final o una clave sin comillas
  • Expected property name: Una coma faltante entre propiedades o comillas incorrectas
  • Unexpected end of input: La cadena JSON se truncó o tiene paréntesis sin cerrar

Formatear

Para JSON válido, la herramienta pasa el objeto analizado a JSON.stringify() con el parámetro space=2. Esto le indica:

  1. Re-serializar el objeto como una cadena JSON
  2. Insertar saltos de línea después de cada {, }, [, ] y coma
  3. Indentar cada nivel de anidamiento con dos espacios
  4. Preservar los tipos de datos originales

Salida

El resultado formateado aparece en el área de salida, mostrado con una fuente monoespaciada para mejorar la legibilidad. La salida es de solo lectura, pero se puede copiar al portapapeles con un clic.

Cómo usarlo

Usar el Formateador JSON de Toollect no requiere configuración ni registro. Siga estos pasos:

  1. Abra la herramienta — Abra la página del formateador JSON en su navegador.

  2. Pegue el JSON — Copie texto JSON de cualquier fuente y péguelo con Ctrl+V (Cmd+V en Mac) en el área de entrada.

  3. Vea el resultado — Después de pegar, la herramienta formatea automáticamente y muestra el resultado de inmediato.

  4. Revise el estado — Verifique el indicador de estado entre los campos:

    • Un mensaje verde confirma JSON válido
    • Un mensaje de error rojo muestra el problema del analizador
  5. Copie el resultado — Haga clic en "Copiar" para transferir el JSON formateado al portapapeles.

  6. Reinicie — Haga clic en "Limpiar" para vaciar ambos campos y restablecer el indicador de estado.

Tutorial

Este tutorial le guía a través del flujo de trabajo completo.

Escenario: Está depurando una respuesta de API REST y necesita inspeccionar la estructura JSON.

  1. Abra el Formateador JSON.

  2. Copie la respuesta JSON sin procesar:

{"status":"success","data":{"users":[{"id":1,"name":"Alice","email":"[email protected]","active":true},{"id":2,"name":"Bob","email":"[email protected]","active":false}],"total":2,"page":1},"timestamp":"2026-07-11T10:30:00Z"}
  1. Pegue y formatee automáticamente:
{
  "status": "success",
  "data": {
    "users": [
      {
        "id": 1,
        "name": "Alice",
        "email": "[email protected]",
        "active": true
      },
      {
        "id": 2,
        "name": "Bob",
        "email": "[email protected]",
        "active": false
      }
    ],
    "total": 2,
    "page": 1
  },
  "timestamp": "2026-07-11T10:30:00Z"
}
  1. Examine la estructura — La sangría revela inmediatamente la jerarquía de anidamiento.

  2. Pruebe JSON con errores:

{"status":"success","data":{"users":[{"id":1,"name":"Alice",}]}}

La herramienta muestra: Invalid JSON: Expected property name or '}' at position...

  1. Copie y use — Haga clic en "Copiar" para transferir el resultado al portapapeles.

Consejos avanzados

  • Cuidado con las comas finales: JSON no permite comas después del último elemento
  • Diagnóstico con comillas: Si no está seguro, péguelo en el formateador — el mensaje de error muestra exactamente dónde falló el análisis
  • Valide respuestas de API durante el desarrollo: Mantenga el formateador abierto y pegue respuestas para validación rápida
  • Verifique caracteres BOM: Si una cadena aparentemente válida no se analiza, puede contener caracteres Unicode invisibles
  • Comparación antes/después: Use la vista lado a lado para comparar JSON minimizado vs formateado
  • Combine con otras herramientas: Copie la salida formateada a una herramienta diff para rastrear cambios entre versiones de API

Alternativas

Herramienta / Método Ideal para Limitaciones
Toollect Formateador JSON Formateo en navegador, privacidad Primera carga requiere internet
JSONLint Validación JSON rápida Solo servidor, sin modo offline
Formateador integrado VS Code Formateo en editor Requiere VS Code instalado
jq (línea de comandos) Procesamiento JSON programático Solo línea de comandos
JSON Formatter de Chrome DevTools Ver JSON de respuestas de red Solo respuestas ya cargadas

Solución de problemas

Problema Causa Solución
Error "Unexpected token" Coma extra o clave sin comillas Revisar comas finales; usar comillas dobles
Error "Expected property name" Coma faltante o comillas simples Añadir comas entre pares clave-valor
Error "Unexpected end of input" JSON truncado Verificar que todos los corchetes estén cerrados
Salida vacía tras formatear Campo de entrada vacío Asegurarse de haber pegado texto JSON
Formateo lento en archivos grandes Entrada muy grande Dividir JSON en partes más pequeñas
Botón copiar no responde Permisos de portapapeles Verificar permisos del navegador

Especificaciones técnicas

Rendimiento

Tamaño de texto Tiempo de proceso Uso de memoria
1 KB (API típica) < 1 ms < 1 MB
100 KB (config grande) < 5 ms < 5 MB
1 MB (exportación datos) < 50 ms < 50 MB

Detalles técnicos

  • Motor de validación: JSON.parse() nativo (especificación ECMAScript)
  • Motor de formateo: JSON.stringify() nativo con space=2
  • Modelo de eventos: La entrada activa el formateo automático (300ms debounce)
  • Compatibilidad: Chrome 80+, Firefox 75+, Safari 13+, Edge 80+, Samsung Internet 13+, Opera 67+

Privacidad

  • Cero transferencia de datos: todo el procesamiento en la memoria del navegador
  • Sin cookies, localStorage ni sessionStorage
  • Sin scripts de análisis o rastreo
  • Utilizable sin conexión después de la carga inicial
  • Sin registro, inicio de sesión ni claves API

Características

  • Formateo y embellecimiento instantáneo de JSON con sangría automática
  • Validación JSON en tiempo real con mensajes de error detallados
  • Detección de errores de sintaxis con localización automática
  • Copia del JSON formateado con un clic
  • Borrado de entrada y salida con un clic
  • Se ejecuta completamente en el navegador — sin envío de datos a servidores

Preguntas frecuentes

¿Qué es un formateador JSON?
Un formateador JSON (también llamado JSON beautifier o pretty printer) toma JSON sin procesar, minimizado o con formato deficiente y lo convierte en una estructura limpia y legible con sangrías y saltos de línea adecuados, además de validar que la sintaxis JSON sea correcta.
¿Esta herramienta es gratuita?
Sí, es completamente gratuita y se ejecuta en su navegador. No se envían datos a ningún servidor, no hay límites de uso ni necesidad de registro.
¿Cómo formateo mi JSON?
Simplemente pegue su JSON en el área de entrada. La herramienta lo validará y formateará automáticamente. Si hay errores de sintaxis, se mostrará un mensaje de error claro.
¿Qué sucede con mis datos?
Nada. Todo el procesamiento se realiza localmente en su navegador usando el analizador JSON integrado de JavaScript. Sus datos nunca abandonan su dispositivo.
¿Funciona con archivos JSON grandes?
Sí, aunque el rendimiento depende de su navegador y dispositivo. La herramienta usa los métodos nativos JSON.parse y JSON.stringify, que están altamente optimizados. Archivos extremadamente grandes (megabytes) pueden tener una breve demora de procesamiento.
¿Puedo usarlo sin conexión?
Sí. Después de la carga inicial de la página, todo el procesamiento se realiza localmente. Puede desconectarse de internet y la herramienta seguirá funcionando mientras la página permanezca abierta.
ESC