Un formateador de JSON que te dice qué está mal
Este formateador de JSON gratuito convierte un bloque de datos minimizados en JSON legible y con sangría, y lo comprueba al mismo tiempo. Pega una respuesta de API, un archivo de configuración o una línea de registro y obtén tres cosas a la vez: un validador de JSON que señala la línea y columna exactas del primer error, un embellecedor de JSON con sangría de 2 espacios, 4 espacios o tabulaciones, y un minimizador para cuando necesites recuperar la versión compacta. La vista de árbol, la ordenación de claves, la validación con JSON Schema y la conversión de JSON a CSV están a un clic.
Todo se ejecuta en tu navegador. La herramienta utiliza su propio analizador pequeño en lugar de enviar tus datos a un servidor; por eso puede explicar los errores con palabras sencillas y los datos privados, como tokens, registros de clientes o configuraciones internas, nunca salen de tu dispositivo.
Cómo leer un mensaje de error de JSON
La mayoría de los errores de JSON no se encuentran donde se detiene el analizador, sino justo antes. Cuando el validador indica Línea 3, columna 9: Coma final antes de "}", muestra la línea con un cursor bajo el carácter problemático, para que puedas ver la coma que no debería estar allí. Unos pocos patrones abarcan la mayoría de los casos reales:
-
Coma final. JavaScript permite
[1, 2,]; JSON no. Elimina la última coma. -
Comillas simples o claves sin comillas.
{name: 'Ann'}es un objeto de JavaScript, no JSON. Las claves y las cadenas necesitan comillas dobles:{"name": "Ann"}. -
Comentarios. JSON no admite comentarios. Los archivos como tsconfig.json los aceptan porque sus herramientas utilizan un formato más flexible, pero un analizador JSON estricto rechaza
//y/* */. -
Falta una coma o un corchete. Si el error aparece al principio de una propiedad, revisa el final de la línea anterior. Si el error es «unexpected end of input», falta en algún lugar un
}o un]de cierre. -
Valores de Python o JavaScript.
True,None,NaNyundefinedno son JSON. Usatrue,nullo un número. -
Comillas curvas. El texto copiado de un procesador de textos o una aplicación de chat suele contener comillas tipográficas que se parecen mucho a
".
El botón «Corregir errores comunes» repara comentarios, comillas simples, claves sin comillas, comas finales, comillas curvas y valores al estilo de Python en una sola pasada, y enumera lo que cambió para que puedas revisar el resultado en lugar de confiar ciegamente en él.
Números grandes y claves duplicadas
JSON en sí no tiene un límite de tamaño para los números, pero JavaScript los almacena como números de coma flotante de 64 bits. Un ID como 12345678901234567890 se convierte en 12345678901234567000 después de uno normal JSON.parse. Este formateador conserva cada número exactamente como lo escribiste y te avisa cuando un valor supera 2^53, señal de que debería transmitirse como cadena. También marca las claves duplicadas: el estándar JSON no las prohíbe, pero la mayoría de los analizadores conserva silenciosamente solo la última, lo que oculta errores.
Validación de JSON Schema en pocas palabras
Un validador JSON comprueba la sintaxis. JSON Schema comprueba el significado: qué campos son obligatorios, qué tipo tiene cada uno y qué valores están permitidos. Un esquema pequeño tiene este aspecto:
{"type": "object", "required": ["id", "email"],
"properties": {"id": {"type": "integer", "minimum": 1},
"email": {"type": "string", "format": "email"}}}
La pestaña JSON Schema admite el núcleo del borrador 2020-12: tipos, enum y const, límites para números y cadenas, pattern, los formatos comunes (email, date, date-time, uri, uuid, ipv4, hostname), properties, required, additionalProperties, patternProperties, items y prefixItems, uniqueItems, contains, allOf, anyOf, oneOf, not, if/then/else y referencias locales $ref enlaces a $defs. Cada error muestra la ruta de la instancia, como $.users[1].email, y la ruta del esquema que produjo el error. Las palabras clave que la herramienta no evalúa, como unevaluatedProperties, se muestran en lugar de ignorarse silenciosamente. Si aún no tienes un esquema, genera un primer borrador a partir de un documento de ejemplo y ajústalo manualmente.
Escribir esquemas para una API completa es un trabajo mayor. Si también necesitas datos estructurados en páginas web, el validador de marcado de esquema comprueba el JSON-LD para los motores de búsqueda, que es un tipo de esquema diferente.
Convertir JSON a CSV y viceversa
Las hojas de cálculo necesitan filas y columnas. El convertidor toma una matriz de objetos, usa la unión de todas las claves como encabezado, aplana los objetos anidados en columnas con notación dot.notation y conserva las matrices como texto JSON en una sola celda. A los valores que empiezan por =, + o @ se les antepone un apóstrofo para que la hoja de cálculo no los ejecute como fórmulas. En la otra dirección, pega un CSV con una fila de encabezado: se detecta el delimitador, se gestionan los campos entre comillas con comas y saltos de línea, los números y true/false se convierten a sus tipos correspondientes, y los encabezados address.city vuelven a convertirse en objetos anidados. Para escribir las consultas que producen estos datos, prueba el constructor de consultas SQL o el generador de fórmulas de Excel.
Consejos para trabajar con JSON todos los días
- Valida antes de depurar. La mitad de los tickets de «la API está dañada» se deben a que falta una coma en el cuerpo de la solicitud.
- Ordena las claves antes de comparar dos documentos. Así, las herramientas de diferencias muestran cambios reales en lugar de campos reordenados.
- Minifica para el transporte y formatea para las personas. Los espacios en blanco no tienen significado en JSON, por lo que ambas versiones contienen los mismos datos.
- No incluyas secretos en formateadores compartidos. Las herramientas en línea que suben tus datos representan un riesgo para los tokens y los datos personales; esta no sube nada.
Hay más herramientas gratuitas para desarrolladores y equipos en la página de generadores y herramientas de AI gratuitos, incluido un generador de casos de prueba para el código que consume tu JSON.
Preguntas frecuentes
¿Este formateador de JSON es gratis y privado?
Sí. Es gratis, no requiere registrarse y no tiene límites. El formato, la validación y la conversión se ejecutan en tu navegador con JavaScript básico, por lo que tu JSON nunca se sube, registra ni almacena en un servidor.
¿Cuál es la diferencia entre un formateador de JSON y un validador de JSON?
Un formateador (o embellecedor) añade sangría y saltos de línea para que JSON sea fácil de leer. Un validador comprueba que el texto siga las reglas de JSON e informa del primer error. Esta herramienta hace ambas cosas al mismo tiempo y muestra la línea y la columna exactas de cualquier error.
¿Por qué mi JSON falla con una coma final o comillas simples?
JSON es más estricto que JavaScript. No permite una coma después del último elemento, cadenas entre comillas simples, claves sin comillas ni comentarios. Usa el botón Corregir errores comunes para repararlos automáticamente y, después, revisa los cambios.
¿El formateador cambia mis números o el orden de las claves?
No. Los números se conservan exactamente como están escritos, incluso los identificadores más grandes de lo que JavaScript puede almacenar, y las claves mantienen su orden original a menos que actives Ordenar claves de A a Z.
¿Qué versión de JSON Schema es compatible?
La herramienta valida el núcleo de JSON Schema draft 2020-12, incluidos tipos, propiedades requeridas, propiedades, enum, límites de cadenas y números, formatos, items, prefixItems, allOf, anyOf, oneOf, not, if/then/else y $ref locales. Las palabras clave que no evalúa se enumeran en lugar de ignorarse silenciosamente.