Formateador y validador de JSON

Qué hace este formateador de JSON

Esta herramienta toma cualquier texto JSON y lo presenta con una sangría uniforme, lo comprime en una sola línea minificada o simplemente comprueba si es válido. Cuando la entrada no es JSON válido, el validador señala la línea y la columna exactas donde falló el análisis y muestra los caracteres circundantes, para que arregles una coma que falta o una clave sin comillas en segundos en lugar de recorrer un muro de texto.

Todo ocurre de forma local en tu navegador usando el analizador de JSON nativo del motor de JavaScript. El texto que pegas nunca se envía a un servidor, lo que lo hace seguro para respuestas de API, archivos de configuración, registros o cualquier dato que contenga tokens, credenciales o información personal.

Cómo se usa

Pega o escribe tu JSON en el cuadro de entrada. El formateo se ejecuta automáticamente mientras escribes. Elige una sangría de 2 espacios, 4 espacios o tabuladores y, si quieres, activa Ordenar claves para ordenar alfabéticamente las claves de los objetos en todos los niveles de anidamiento, lo que facilita comparar dos documentos con una herramienta de diff. Haz clic en Minificar para eliminar todos los espacios en blanco cuando necesites la carga más pequeña posible para una petición HTTP o una variable de entorno. Usa Copiar para llevar el resultado al portapapeles o Descargar para guardarlo como archivo .json.

La barra de estado muestra el tamaño en bytes, el número de claves de objeto y la profundidad máxima de anidamiento, una forma rápida de revisar un documento grande antes de enviarlo a algún sitio.

Errores comunes de JSON que este validador detecta

Las comas finales después del último elemento de un arreglo o un objeto no están permitidas en JSON, aunque la mayoría de los lenguajes de programación las aceptan. Las comillas simples alrededor de cadenas o claves no son válidas: JSON exige comillas dobles. Los comentarios no forman parte de la especificación de JSON, así que un bloque // o /* */ fallará. Las claves sin comillas como {name: "x"} son literales de objeto de JavaScript, no JSON. Los valores especiales como NaN, Infinity y undefined no existen en JSON. Cada uno de estos casos produce un error claro con una posición a la que puedes saltar.

Contexto: de dónde viene JSON

JSON (JavaScript Object Notation) lo especificó Douglas Crockford a principios de los años 2000 como una alternativa ligera a XML, usando la sintaxis de literales de objeto que JavaScript ya tenía. Se estandarizó como RFC 4627 en 2006 y luego como ECMA-404 y RFC 8259 (2017), que es la definición actual: seis tipos de valor (objeto, arreglo, cadena, número, true/false, null), UTF-8 como codificación de intercambio y sin comentarios. Su auge acompañó al de las aplicaciones del lado del navegador: un formato que el navegador podía analizar de forma nativa con JSON.parse superó a cualquiera que necesitara un analizador aparte.

Dónde se usa

Casi todas las API web devuelven JSON, y por eso lo primero que haces con una respuesta desconocida es pegarla en un formateador para ver su forma. Los archivos de configuración (package.json, tsconfig.json, ajustes de VS Code), las definiciones de infraestructura (CloudFormation, el estado de Terraform), las bases de datos NoSQL (documentos de MongoDB, columnas jsonb de PostgreSQL), los pipelines de registros (un objeto JSON por línea en ndjson) y la carga útil de un token JWT son todos JSON; JSON también viaja dentro de los parámetros de consulta de una URL, donde primero debe codificarse con porcentajes. Hay formatos relacionados que lo extienden: JSON5 y JSONC añaden comentarios y comas finales para archivos de configuración, JSON Schema describe la estructura esperada y JSON Lines transmite muchos documentos en un solo archivo; este validador rechaza todos ellos como JSON estricto, a propósito.

Preguntas frecuentes