Herramientas · Software

Validador de JSON

Compruebe si un texto es JSON válido según el estándar RFC 8259. Si no lo es, verá la línea y la columna exactas del error con una explicación en español; si lo es, obtendrá un resumen de su estructura y avisos sobre claves duplicadas y números que perderían precisión.

Texto a validar

La validación se hace en su navegador. También puede abrir un archivo .json (hasta 10 MB).

Resultado de la validación

Pegue un JSON a la izquierda para validarlo.

Estas herramientas se ejecutan en su navegador y no envían lo que usted escribe a nuestros servidores. Aun así, evite pegar secretos reales (contraseñas, claves privadas, tokens de producción) en cualquier sitio web. Consulte los Términos de uso.

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

  1. Pegue el texto en el cuadro, o abra un archivo .json de hasta 10 MB.
  2. El resultado aparece al instante: JSON válido o JSON no válido.
  3. 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.
  4. 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ónTipoQué significa
Sintaxis completa (RFC 8259)ErrorLlaves, corchetes, comillas, comas, dos puntos, números, escapes y literales bien formados.
Texto sobranteErrorHay algo después del valor JSON (por ejemplo, dos objetos seguidos sin un arreglo que los contenga).
Anidamiento excesivoErrorMás de 1000 niveles de objetos y arreglos, que los analizadores rechazan o desbordan.
Claves duplicadasAdvertenciaUn 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ónAdvertenciaEnteros mayores que 9 007 199 254 740 991 (253 − 1) o magnitudes que desbordan, como 1e999: JavaScript los redondea.
Marca BOM al inicioAdvertenciaUn 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:

ErrorDónde lo señalaCó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, InfinityAl inicio de la palabra.Use null o escriba el valor como cadena.
Cadena sin cerrarEn 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 cerrarEn 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.