JSON inválido: cómo leer el error y repararlo automáticamente

Contenido
Este artículo es para quienes han añadido comentarios para documentar un archivo JSON, o han olvidado borrar una coma después del último elemento, y se han topado con un error «Unexpected token». La gramática JSON estándar no define comentarios, comas finales (trailing comma) ni claves sin comillas desde el principio, así que no es un bug que aparezca por casualidad: es un error porque el formato no lo admite. Aquí explicamos, con hechos, cómo leer el mensaje de error y qué hace realmente por dentro la función de corrección automática.
Resumen ① La gramática JSON estándar no define comentarios, comas finales ni claves sin comillas, por lo que JSON.parse lanza un error de inmediato. ② La position del mensaje de error es la posición del carácter contada desde el principio del texto, y la line es el número de saltos de línea hasta esa posición. ③ Auto-Fix evalúa con new Function el texto sin comentarios como si fuera un objeto literal de JavaScript permisivo y, si la evaluación tiene éxito, lo vuelve a serializar como JSON estándar.
Por qué aparece este error: una situación habitual
Suele ocurrir lo siguiente. Archivos como settings.json o tsconfig.json de VS Code son formatos extendidos JSONC, que permiten escribir comentarios. Si copias una parte de ese archivo y la pegas tal cual en los valores de configuración de otro programa o en el cuerpo de una solicitud a una API, el JSON.parse de ese programa considera la sintaxis de comentarios un token que no existe en el estándar y se detiene en ese punto.
Otro caso frecuente se da al eliminar un elemento de un array o de un objeto. Si la coma permanece detrás del elemento que pasa a ser el penúltimo, la coma no tiene ningún valor después y el análisis falla. En ambos casos, la estructura parece natural a simple vista, pero no existe en la gramática JSON.
Cómo leer y corregir el error sin herramientas
Puedes comprobarlo directamente en la consola del navegador (F12). Si envuelves el texto problemático entre acentos graves y ejecutas JSON.parse(\...`)`, los motores basados en V8 como los de Chrome o Edge lanzan un SyntaxError y el mensaje incluye un número de position. Las versiones recientes de V8 incluyen también la línea y la columna, como en «(line 3 column 5)».
La position es el número de carácter contado desde el inicio del texto, donde el primer carácter es 0. La line es el número de línea que resulta de contar cuántos saltos de línea hay hasta esa posición. Si el mensaje no incluye line, puedes identificar la línea contando a mano los saltos de línea desde el principio usando solo la position.
Cuando hayas localizado la posición, revisa lo que hay antes y después de ese punto y comprueba si se trata de uno de estos tres casos. Los tres son estructuras que no existen en la gramática JSON estándar, por eso el motor se detuvo justo ahí.
- Que haya comentarios mezclados que empiecen por
//o/* */ - Que quede una coma innecesaria después del último elemento de un objeto o array
- Que alguna clave esté escrita sin comillas
Si eliminas a mano esos tres elementos o pones comillas donde haga falta, obtendrás JSON estándar. Eso sí, en archivos con anidación profunda o muchos elementos, puede que tengas que repetir esta tarea varias veces.
Compruébalo con nuestra herramienta gratuita.
Se ejecuta 100 % en el lado del cliente, en tu navegador: el JSON que introduces no se envía a ningún servidor.

Qué hace por dentro el botón Auto-Fix
El botón de recuperación automática de errores (Auto-Fix) es la versión en código de la tarea manual que acabamos de describir. Primero, elimina del texto los comentarios de línea // y los comentarios de bloque /* */ con expresiones regulares.
Después evalúa el texto restante con new Function. new Function es una forma de ejecutar una cadena como código JavaScript, por lo que acepta tal cual la gramática de los objetos literales de JavaScript, mucho más permisiva que JSON.parse. Las claves sin comillas (siempre que sean identificadores válidos), las cadenas entre comillas simples y las comas finales después del último elemento son estructuras que la gramática de ECMAScript permite de por sí, así que el motor de JavaScript las lee sin errores.
Si la evaluación tiene éxito, vuelve a serializar con JSON.stringify el objeto JavaScript obtenido. En ese proceso, las claves que no tenían comillas reciben comillas dobles y las comas finales no llegan a existir en el resultado, de modo que tanto el campo de entrada como el de salida muestran la forma de JSON estándar.
Ahora bien, para que este método funcione, el texto restante debe ser gramática JavaScript válida. Los errores que tampoco se pueden interpretar como gramática JavaScript, como llaves o paréntesis que no están emparejados o un valor que falta por completo, no se recuperan ni con Auto-Fix.
Qué cuenta el panel de estadísticas de resultados
Si hay texto en el campo de entrada, el panel de estadísticas se actualiza al instante, sin necesidad de pulsar otro botón. Intenta ejecutar JSON.parse y, si tiene éxito, muestra VALID; si falla, muestra INVALID como estado de validez.
El número de claves (Key) no cuenta solo el objeto de nivel superior: es la suma de las propiedades de todos los objetos anidados, recorriendo toda la estructura. El número de arrays (Array) tampoco cuenta solo el array de nivel superior: suma todos los valores que aparecen como array en cualquier parte de la estructura.
La profundidad (Depth) es el valor máximo que indica cuántos niveles de anidación tienen los objetos y arrays. Si un array contiene un objeto y ese objeto contiene a su vez un array, la profundidad aumenta un nivel por cada uno.
El tamaño en bytes no es la longitud de la cadena (.length), sino el número real de bytes que se obtiene al crear un objeto Blob y medirlo. Al crear un Blob a partir de una cadena, esta se codifica en UTF-8, así que cuantos más caracteres haya que ocupen varios bytes, como los caracteres coreanos, mayor será el tamaño en bytes en comparación con el número de caracteres.
Cosas que suelen generar confusión
La confusión típica de «¿esto no es JSON?» suele producirse cuando se mezclan estas tres cosas.
| Formato | Comentarios | Coma final | Claves sin comillas | Pasa por JSON.parse |
|---|---|---|---|---|
| JSON estándar | No | No | No | Sí (es su formato original) |
| Objeto literal de JavaScript | Sí | Sí | Sí (si es un identificador) | No |
| JSON5 | Sí | Sí | Sí | No (requiere un analizador aparte) |
Cuando imprimes un objeto con console.log en la consola de JavaScript, o cuando ves un texto con comentarios como un archivo de configuración de VS Code, puede parecer JSON a simple vista, pero para el JSON.parse estándar todo eso son errores. La razón por la que Auto-Fix funciona es que, en la mayoría de los casos, esos textos entran en la categoría de «objeto literal de JavaScript».
Hay otro punto que también genera confusión. Si un objeto de JavaScript tiene undefined o una función como valor, JSON.stringify elimina esa propiedad por completo del resultado (si está dentro de un array, se convierte en null). Si al recuperar un JSON con Auto-Fix ves que desaparece un elemento que estaba antes, puede deberse a esta regla.
En resumen
- JSON estándar no define comentarios, comas finales ni claves sin comillas; si aparecen, JSON.parse lanza un error.
- La position del mensaje de error se calcula contando caracteres desde el principio, y la line contando los saltos de línea hasta esa posición.
- Auto-Fix elimina los comentarios, evalúa el texto con new Function usando la gramática permisiva de JavaScript y, si tiene éxito, lo vuelve a serializar como JSON estándar.
- Los números de Key y Array del panel de estadísticas son la suma de toda la estructura anidada, y el tamaño se mide en bytes según Blob, no en número de caracteres.
- Los errores que ni siquiera se pueden leer como gramática JavaScript, como llaves que no coinciden, no se recuperan con Auto-Fix.
Se ejecuta 100 % en el lado del cliente, en tu navegador: el JSON que introduces no se envía a ningún servidor.
Preguntas frecuentes
¿Qué errores corrige Auto-Fix?
Detecta los comentarios de línea y de bloque (//, /* */) que no cumplen la especificación JSON estándar, las claves escritas sin comillas y las comas finales que quedan al final, y reconstruye el texto en formato JSON estándar aprovechando la interpretación permisiva de la gramática del motor de JavaScript.
¿El JSON que introduzco se envía a algún servidor?
No. Esta herramienta funciona únicamente dentro del navegador, así que los datos que introduces no se envían ni se recopilan en un servidor a través de la red.
¿Cómo se calculan la position y la line que aparecen en el mensaje de error?
No son valores que la herramienta vuelva a calcular por separado: son los números que extrae con una expresión regular del propio mensaje de error que genera el motor de JavaScript del navegador cuando JSON.parse falla. La position es la posición del carácter contada desde el principio del texto, y la line es el número de línea hasta esa posición.
¿Hay casos en los que Auto-Fix no corrige el error aunque lo pulses?
Sí. Auto-Fix evalúa como gramática JavaScript el texto sin comentarios, así que si el texto restante tampoco se puede interpretar como gramática JavaScript (por ejemplo, si las llaves no están emparejadas o falta un valor por completo), falla.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano