Error de sintaxis JSON: lee el mensaje y encuentra la causa

PublicadoHerramientaFormateador y validador de JSON

Contenido
  1. Por qué aparecen tan a menudo estos errores
  2. Las reglas de la sintaxis JSON y cómo leer el mensaje de error
  3. Tipos de error de sintaxis que más confunden
  4. En resumen
  5. Preguntas frecuentes

Cuando pegas JSON y aparece el error "Unexpected token", significa que se ha incumplido una de las reglas de la sintaxis JSON. El propio mensaje de error ya incluye en qué carácter y en qué posición se ha producido el problema. Este artículo repasa los tipos de error de sintaxis más habituales y cómo leer ese mensaje para localizar la causa.

Resumen ① JSON no permite, por sintaxis, las comas finales, las comillas simples, los comentarios ni las claves sin comillas. ② El mensaje de error que lanza JSON.parse indica tanto el carácter problemático como su posición (position). ③ El valor de posición es el número de caracteres contados desde el principio de la cadena, así que mirar justo antes y después de ese punto permite acotar la causa.

Por qué aparecen tan a menudo estos errores

Es habitual copiar la respuesta de una API desde la consola y pegarla en un archivo de configuración, o ir uniendo varias respuestas a mano y dejar una coma de más detrás del último elemento. También ocurre con frecuencia que se extrae un objeto literal que estaba dentro de código JavaScript y se pega tal cual como si fuera JSON.

Ambas sintaxis se parecen a simple vista, pero las reglas son distintas. Expresiones que en un objeto literal de JavaScript son válidas (comillas simples, claves sin comillas, comas finales) son en JSON errores de sintaxis. Por eso, si trasladas tal cual un valor que funcionaba perfectamente en el código, JSON.parse lanza un error de inmediato.

El problema es que el mensaje de error parece código, algo como "Unexpected token } in JSON at position 42". Si no sabes qué regla de sintaxis se ha incumplido ni qué señala el número 42, puedes leer el mensaje y aun así no encontrar la causa.

Las reglas de la sintaxis JSON y cómo leer el mensaje de error

JSON es un formato estándar que sigue una sintaxis definida. En la práctica, las reglas que provocan errores se reducen a unas pocas.

  • Las cadenas y las claves deben ir siempre entre comillas dobles ("). Las comillas simples (') no existen en la sintaxis JSON.
  • No se pone coma detrás del último elemento de un objeto o de un array (las comas finales están prohibidas).
  • Las claves deben ser siempre cadenas entre comillas. Una clave sin comillas no es JSON, sino sintaxis de objeto literal de JavaScript.
  • Los comentarios (// o /* */) no forman parte de la sintaxis JSON.
  • En los números no se pueden poner ceros innecesarios delante (como 01), ni el signo +, ni valores como NaN o Infinity.
  • true, false y null se escriben solo en minúsculas.

Si se incumple cualquiera de estas reglas, el JSON.parse del navegador no devuelve el valor, sino que lanza un error (SyntaxError).

Cómo leer la información de posición (position) del mensaje de error

Este error contiene dos datos: el carácter problemático y la posición (position), que indica en qué lugar de la cadena se encuentra ese carácter. La posición es el número de caracteres contados desde el principio de la cadena (0), incluyendo los saltos de línea.

El formato del mensaje varía según el motor del navegador. Los de la familia Chromium muestran position (posición del carácter) y los de la familia Firefox, la forma line·column (línea y columna), pero el punto al que se refieren es el mismo.

Para localizar la causa basta con examinar los caracteres anteriores y posteriores a esa posición. Eso sí, cuanto más largo es el JSON, más engorroso resulta contar la posición a mano y más fácil es equivocarse.

Compruébalo con nuestra herramienta.

Formateador y validador de JSON

Pega tu JSON y pulsa el botón de formatear: verás al instante la posición y el mensaje de error. Todo se procesa dentro del navegador, sin enviar nada al servidor.

Tipos de error de sintaxis que más confunden

Aunque el resultado sea el mismo "da error", las causas son distintas entre sí. Estos son los tipos más frecuentes.

Tipo de errorEjemploPor qué es un error
Coma final{"a":1,"b":2,}No se pone coma detrás del último elemento
Uso de comillas simples{'a':1}Las cadenas y las claves solo admiten comillas dobles
Clave sin comillas{a:1}Las claves deben ser siempre cadenas entre comillas
Comentarios incluidos{"a":1} // 설명La sintaxis JSON no contempla comentarios
Valor undefined{"a":undefined}JSON no puede representar undefined (solo null)
Cero delante de un número{"a":01}Los números que empiezan por 0 solo se permiten si son el propio 0

De todos ellos, la coma final y las comillas simples son expresiones que se usan de forma natural en el código JavaScript, así que se cuelan con especial frecuencia al copiar valores del código a JSON.

En resumen

  • JSON es un formato que sigue una sintaxis definida (comillas dobles, reglas de comas, etc.) y su sintaxis es distinta de la de un objeto literal de JavaScript.
  • Las comas finales, las comillas simples, las claves sin comillas y los comentarios son, en la práctica, las causas de error más habituales.
  • El mensaje de error que lanza JSON.parse incluye el carácter problemático y la posición (position o line/column).
  • El valor de posición es el número de caracteres contados desde el principio de la cadena, así que revisar ese punto y sus alrededores permite acotar la causa.
  • En JSON largos, es más rápido y más exacto comprobar la posición directamente con una herramienta que contarla a mano.
Formateador y validador de JSON

Pega tu JSON y pulsa el botón de formatear: verás al instante la posición y el mensaje de error. Todo se procesa dentro del navegador, sin enviar nada al servidor.

Preguntas frecuentes

¿Qué significa exactamente el error "Unexpected token"?

Significa que JSON.parse ha encontrado un carácter que no puede aparecer según la sintaxis. El mensaje indica ese carácter y en qué posición (position) de la cadena se ha encontrado. Revisando alrededor de esa posición puedes localizar la causa de inmediato.

¿Qué significa el número que aparece después de position?

Es el número de caracteres (índice de carácter) contados tomando como 0 el principio de la cadena. También se cuentan los saltos de línea. Por ejemplo, si es position 42, significa que el problema se produce en el carácter número 43 desde el inicio de la cadena.

¿Por qué da error un JSON con comentarios?

Porque la propia sintaxis JSON no define ninguna forma de escribir comentarios. Los comentarios como // o /* */ se permiten en JavaScript o en formatos extendidos como JSON5 o JSONC, pero el JSON estándar los trata como un error.

¿Puedo usar un objeto de JavaScript tal cual como JSON?

No. Un objeto literal de JavaScript puede omitir las comillas en las claves, usar comillas simples o dejar comas finales, pero JSON considera todas esas expresiones como errores de sintaxis. Hay que envolverlo todo en comillas dobles y eliminar la última coma para poder usarlo como JSON.

Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano

Artículos relacionados

  1. JSON a TypeScript: cuándo aparecen ? y | en las interfacesCómo decide la conversión de JSON a TypeScript cuándo una clave lleva ? opcional y cuándo sus valores se unen con |, con ejemplos reales.
  2. Convertir JSON a YAML: reglas de listas e indentaciónDescubre cómo los arrays de JSON pasan a listas con guion y los objetos anidados a niveles de indentación, y evita errores de comillas en Kubernetes.
  3. Sintaxis JSONPath: qué selecciona cada símbolo con ejemplosRepasa qué selecciona cada símbolo de JSONPath ($, ., [n], [*], ..) con un JSON de ejemplo y por qué los filtros y slices no están soportados.
  4. Cómo decodificar un JWT: estructura y fecha de expUn JWT no está cifrado, solo codificado: aprende a leer el header y el payload, y a convertir exp e iat en fechas legibles.
  5. Verificar un JWT: cómo comprobar si la firma fue alteradaDescubre cómo se calcula y compara la firma HMAC-SHA256 de un JWT y por qué falla la verificación: clave distinta o token manipulado.
  6. line-clamp CSS: cómo usarlo y por qué no funcionaEntiende por qué line-clamp no funciona sin display: -webkit-box y qué propiedades necesita el truncado de una línea y de varias líneas.

Herramientas relacionadas