Qué significa que un JSON sea válido
Un texto es JSON válido cuando cumple la gramática del estándar RFC 8259: un único valor (objeto, arreglo, cadena, número, true, false o null), con las cadenas y las claves entre comillas dobles, los elementos separados por comas y sin comas sobrantes, comentarios ni valores como undefined o NaN. Basta un carácter fuera de lugar para que un analizador estricto lo rechace por completo.
Esta herramienta valida la sintaxis. Comprueba que el texto se pueda leer como JSON, pero no sabe qué significan sus datos: no verifica que exista una clave obligatoria ni que una edad sea un número positivo. Para eso se usa un esquema JSON (JSON Schema), que describe la forma que debe tener el documento.
Cómo usar el validador
- Pegue el texto en el cuadro, o abra un archivo .json de hasta 10 MB.
- El resultado aparece al instante: JSON válido o JSON no válido.
- Si hay un error, lea el mensaje, la posición (línea y columna) y la pista, y observe el fragmento de la línea con el cursor
^marcando el punto. - Si es válido, revise la estructura (tipo, profundidad, número de claves, objetos y arreglos) y las advertencias, si las hay.
Qué comprueba y de qué avisa
| Revisión | Tipo | Qué significa |
|---|---|---|
| Sintaxis completa (RFC 8259) | Error | Llaves, corchetes, comillas, comas, dos puntos, números, escapes y literales bien formados. |
| Texto sobrante | Error | Hay algo después del valor JSON (por ejemplo, dos objetos seguidos sin un arreglo que los contenga). |
| Anidamiento excesivo | Error | Más de 1000 niveles de objetos y arreglos, que los analizadores rechazan o desbordan. |
| Claves duplicadas | Advertencia | Un objeto repite una clave. La sintaxis es válida, pero JSON.parse conserva solo el último valor y los demás se pierden sin aviso. |
| Números con pérdida de precisión | Advertencia | Enteros mayores que 9 007 199 254 740 991 (253 − 1) o magnitudes que desbordan, como 1e999: JavaScript los redondea. |
| Marca BOM al inicio | Advertencia | Un carácter invisible (U+FEFF) que algunos editores añaden al guardar en «UTF-8 con BOM» y que JSON.parse rechaza. |
Cómo leer el mensaje de error
El analizador informa de la línea y la columna donde se dio cuenta de que algo estaba mal, que a veces es un poco después del descuido real. Estos son los casos más frecuentes:
| Error | Dónde lo señala | Cómo corregirlo |
|---|---|---|
Coma final ({"a": 1,}) | En la coma sobrante. | Quite la última coma antes de } o ]. |
Falta una coma ({"a": 1 "b": 2}) | Justo después del valor anterior. | Agregue la coma entre los dos elementos. |
Comillas simples ({'a': 1}) | En la primera comilla simple. | Use comillas dobles para claves y cadenas. |
Clave sin comillas ({a: 1}) | En el primer carácter de la clave. | Escriba la clave entre comillas dobles: "a". |
Comentarios (// nota) | Donde empieza el comentario. | Quite los comentarios; JSON no los admite. |
| undefined, NaN, Infinity | Al inicio de la palabra. | Use null o escriba el valor como cadena. |
| Cadena sin cerrar | En la comilla de apertura de la cadena. | Cierre la cadena; un salto de línea dentro de ella se escribe \n. |
| Objeto o arreglo sin cerrar | En la llave o corchete de apertura. | Agregue el } o ] que falta al final. |
Cero a la izquierda (007) | Al inicio del número. | Quite los ceros o, si es un código, escríbalo como cadena. |
Ejemplo con un error
Este documento tiene una coma de más al final del primer producto:
{
"empresa": "Karven",
"productos": [
{ "id": 1, "nombre": "SocialKor", },
{ "id": 2, "nombre": "Herramientas" }
]
}
El validador responde que no es válido y señala:
Línea 4, columna 37
Coma final: JSON no permite una coma antes de «}».
Quite la última coma.
{ "id": 1, "nombre": "SocialKor", },
^
Basta quitar esa coma para que el documento sea válido. Cuando un texto tiene varios errores, el analizador informa del primero que encuentra: corríjalo y vuelva a validar para ver el siguiente.
Qué dice el resumen de la estructura
- Tipo del valor raíz: si el documento es un objeto, un arreglo o un valor simple. Las API suelen devolver un objeto o un arreglo de objetos.
- Profundidad máxima: cuántos niveles de objetos y arreglos anidados hay. Un valor alto (más de 10 o 15) suele indicar un diseño de datos difícil de consumir.
- Claves, objetos y arreglos: una idea rápida del tamaño y de cuántos registros contiene el documento.
- Cadenas, números, booleanos y null: la distribución de los valores simples.
Sintaxis válida no significa datos correctos
Un JSON puede ser sintácticamente perfecto y aun así no servir: {"edad": "veinte"} es válido, pero si su programa espera un número, fallará. Para describir y comprobar la forma de los datos se usa JSON Schema, un vocabulario que indica qué claves son obligatorias, de qué tipo es cada valor, qué rangos admite y qué patrones deben cumplir las cadenas. Se valida con bibliotecas específicas de cada lenguaje.
Una buena práctica es combinar ambos pasos: primero confirmar que el texto es JSON (esta herramienta) y después comprobar que cumple el esquema acordado con quien lo produce. Para dar formato legible al documento, use el formateador JSON.
Preguntas frecuentes
¿Qué estándar usa el validador?
El RFC 8259 (equivalente a ECMA-404), el estándar vigente de JSON. Es el mismo que implementan JSON.parse y los analizadores estrictos de otros lenguajes.
¿Por qué JSON.parse acepta un texto que aquí aparece como válido pero con advertencias?
Las advertencias señalan cosas que el estándar permite pero que provocan sorpresas: una clave duplicada hace que se pierda un valor sin avisar, y un entero muy grande se redondea en JavaScript. El texto es válido, pero conviene revisarlo.
¿El validador comprueba el esquema o los tipos de mis datos?
No: valida la sintaxis. Para exigir claves obligatorias, tipos y rangos se necesita un esquema JSON (JSON Schema) y una biblioteca que lo aplique.
¿Por qué solo me muestra un error?
Un analizador se detiene en el primer error, porque lo que sigue puede interpretarse mal. Corríjalo y vuelva a validar para ver el siguiente.
¿Puedo validar JSON con comentarios o comas finales?
No como JSON estándar. Esos formatos se conocen como JSONC o JSON5 y requieren sus propios analizadores. Si el archivo es de configuración de una herramienta que los permite, quite los comentarios y las comas finales para validarlo aquí.
¿Se envía mi texto a algún servidor?
No. La validación ocurre en su navegador, así que puede comprobar datos internos sin que salgan de su equipo.