Validar sintaxis JSON

El validador siempre devuelve un resultado estructurado: una entrada válida genera un indicador verdadero sencillo, mientras que una entrada no válida genera falso junto con el mensaje del analizador y la posición, línea y columna donde se detuvo el análisis. Esta respuesta predecible resulta útil en editores, formularios de carga, comprobaciones de despliegue, conjuntos de pruebas y cualquier flujo que deba explicar un documento JSON defectuoso sin interrumpirse.

Compruebe la sintaxis sin modificar el documento

Un validador de sintaxis debe responder una pregunta precisa: ¿puede un analizador compatible con el estándar leer exactamente esta cadena? Esta herramienta entrega el texto proporcionado directamente al analizador JSON de la plataforma. No recorta el contenido, sustituye comillas, elimina comentarios, inserta comas, reordena claves ni reinterpreta valores. Esta cautela es importante al probar configuraciones o cargas de API, porque una corrección automática podría ocultar el defecto que seguirá fallando en producción. Un resultado válido significa que se aceptó la cadena completa como un solo valor JSON, incluidos objetos, matrices, cadenas, números, booleanos y null. Un resultado no válido conserva el fallo en la salida normal en vez de convertirlo en una excepción. Por ello, usted puede mostrar la respuesta inmediatamente o evaluar el indicador de validez mediante código. El texto vacío, el contenido sobrante, los comentarios, las cadenas con comillas simples, las comas finales y los caracteres de control sin escapar siguen siendo inválidos porque no pertenecen a la sintaxis JSON.

Interprete la ubicación del error

Cuando el análisis falla, el resultado incluye un objeto de error con un mensaje y tres coordenadas. La posición es un desplazamiento de caracteres, iniciado en cero, desde el comienzo de la cadena JavaScript. La línea y la columna comienzan en uno, por lo que son prácticas para mostrarlas en un editor o aviso de validación. Cada salto de línea incrementa la línea y reinicia la columna. La ubicación señala el punto donde el analizador detectó que no podía continuar; el error real puede estar justo antes. Por ejemplo, una coma ausente entre dos propiedades suele señalarse en la comilla inicial de la segunda, pues allí el analizador descubre que la primera no terminó correctamente. Un objeto o una matriz incompletos se señalan al final del texto. La redacción del analizador puede variar entre entornos JavaScript; use los campos numéricos para navegar y muestre el mensaje a las personas, en vez de depender de su texto completo como categoría estable.

Utilice el resultado con seguridad en formularios y controles

En un formulario del navegador, ejecute la validación antes de enviar una configuración y desplace el cursor a la posición indicada cuando el resultado sea falso. En un flujo de API, trate la respuesta como datos: continúe únicamente cuando sea válida; de lo contrario, adjunte la línea, la columna y el mensaje a un informe de compilación, una incidencia de soporte o una carga rechazada. Un JSON mal formado es contenido esperado del usuario, por lo que produce un resultado correcto con el indicador en falso, no un fallo de entrada inválida. La solicitud solo se rechaza cuando falta el campo de texto obligatorio o este no es una cadena, ya que entonces no existe contenido JSON que examinar. El algoritmo es determinista, no usa red, modelos, valores aleatorios, reloj ni estado persistente. Su ejecución crece linealmente con el tamaño del documento en el análisis y el cálculo de la ubicación habituales. La API cuesta $0.002 por solicitud, mientras que la versión del navegador realiza la misma comprobación localmente.