Convertir un objeto JavaScript a JSON: errores y soluciones

PublicadoHerramientaConvertidor de Objeto JS a JSON

Contenido
  1. Cuándo te encuentras con este problema
  2. Cómo convertir a mano, sin herramientas
  3. Puntos que suelen confundir
  4. En resumen
  5. Preguntas frecuentes

Si pegas tal cual un literal de objeto JavaScript copiado de la consola del navegador o del código fuente en JSON.parse(), en la mayoría de los casos obtendrás un SyntaxError. La razón es que los literales de objeto de JS y el JSON estándar usan sintaxis distintas. En este artículo comparamos esas diferencias punto por punto y explicamos cómo hacer la conversión a mano y cómo leer los mensajes de error.

Resumen ① El JSON estándar solo admite comillas dobles en todas las claves y en los valores de cadena, y prohíbe las comas finales (trailing comma) y los comentarios. ② Los literales de objeto de JS permiten claves sin comillas, cadenas con comillas simples y comas finales, así que aunque se parezcan a simple vista, la sintaxis no es la misma. ③ El número de position en un error de JSON.parse indica en qué carácter de la cadena de entrada (contando desde 0) se detuvo el análisis.

Cuándo te encuentras con este problema

Las situaciones más habituales son estas. Ejecutas console.log(config) en la consola de las herramientas de desarrollo del navegador para revisar un objeto y después copias la salida tal cual y la pegas en el cuerpo de la petición de una herramienta de pruebas de API o en el campo de configuración de otro programa.

Lo que muestra la consola es la representación en pantalla de un valor de JavaScript, así que las claves no llevan comillas y las cadenas van entre comillas simples. Si en ese estado lo pasas a JSON.parse() o lo pegas en un campo que solo acepta JSON, el análisis falla.

El mismo problema aparece cuando trasladas a un archivo JSON un objeto de configuración definido en el código fuente. Son textos que a la vista se parecen, pero el analizador los interpreta con una sintaxis completamente distinta.

Cómo convertir a mano, sin herramientas

La sintaxis del JSON estándar la define el estándar de internet RFC 8259. Las reglas clave son estas.

  • Las claves de un objeto deben ir siempre entre comillas dobles.
  • Los valores de cadena solo admiten comillas dobles. Las comillas simples son un error de sintaxis.
  • No se puede poner una coma después del último elemento de un array u objeto (trailing comma).
  • No se pueden usar comentarios (// o /* */).
  • Valores como undefined, funciones o Symbol no se pueden representar en JSON.

Si el texto copiado es realmente sintaxis JavaScript válida —es decir, si es un literal de objeto copiado tal cual del código fuente— puedes convertirlo en la propia consola de las herramientas de desarrollo del navegador. El orden es este.

Pasos para convertir directamente en la consola

  1. Abre las herramientas de desarrollo (F12 en Chrome y Edge; Cmd+Option+I en Mac).
  2. En la pestaña Consola, envuelve lo que copiaste en una asignación a una variable. Por ejemplo, añade const obj = delante y un punto y coma al final, así: const obj = { name: 'kim', age: 20, };
  3. Pulsa Enter para crear la variable y, a continuación, ejecuta JSON.stringify(obj, null, 2).
  4. La cadena que aparece en la consola es el JSON estándar. Puedes comprobar que las claves y las cadenas van entre comillas dobles y que no queda ninguna coma final.

Este método equivale a ejecutar el código, así que si pegas en la consola código de origen desconocido puedes exponerte a riesgos de seguridad durante la ejecución. El riesgo es menor cuando se trata de registros que tú mismo has generado o de valores que vienen de código fuente fiable.

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

Si, al contrario, diste por hecho que el texto ya era JSON, lo pasaste a JSON.parse() y falló, el número de position del mensaje de error te ayuda a acotar la causa. position indica en qué carácter de la cadena de entrada se detuvo el análisis, contando desde el principio (el carácter 0).

Por ejemplo, en la cadena {name: 'a'}, el carácter 0 es { y el carácter 1 es n. Si el error aparece en ese punto, significa que se debe a la clave sin comillas dobles (name).

El texto exacto del mensaje cambia un poco según el navegador y la versión de Node.js, pero el significado del número que va detrás de position (la posición del carácter contada desde 0) es el mismo. Basta con contar desde el inicio de la cadena hasta ese número para ver en qué carácter se atascó.

Cuando hay muchos caracteres o los objetos están anidados, ir cambiando las comillas una por una y borrando las comas finales resulta engorroso y es fácil equivocarse. Puedes comprobarlo con nuestro Convertidor de Objeto JS a JSON, que es gratuito.

Convertidor de Objeto JS a JSON

Convierte al instante un literal de objeto JS con claves sin comillas y cadenas entre comillas simples en JSON estándar. Funciona en el navegador, sin instalar nada ni registrarte.

Puntos que suelen confundir

ElementoJSON estándarNotación habitual en literales de objeto JS
ClavesComillas dobles obligatorias ("name")Identificador sin comillas (name)
Valores de cadenaSolo comillas dobles ("kim")También se admiten comillas simples ('kim')
Coma tras el último elementoProhibidaPermitida (coma final)
ComentariosNo se admitenSe admiten // y /* */
Valores undefined y funcionesNo se pueden representarSe pueden usar como valores

Si ya tienes en el código en ejecución una variable de objeto JavaScript, este proceso de conversión no hace falta: basta con ejecutar JSON.stringify(obj). La conversión solo es necesaria cuando el objeto existe únicamente como texto (una salida de consola o un fragmento de código fuente) y no hay ninguna variable ejecutable.

Si el objeto JS original tiene claves con valor undefined o con funciones, esas claves desaparecen por completo del resultado al convertirlo a JSON. No es un error, es el comportamiento normal de JSON.stringify. Las claves con valor NaN o Infinity se convierten en null sin dar error.

También es arriesgado limitarse a sustituir comillas simples por dobles (buscar y reemplazar). Puede cambiar también las comillas simples (apóstrofos) que ya estaban dentro de los valores de cadena o descolocar los escapes, y crear así nuevos errores de sintaxis.

En resumen

  • El JSON estándar debe cumplir las reglas de claves y cadenas entre comillas dobles, prohibición de comas finales y prohibición de comentarios.
  • Los literales de objeto de JS permiten claves sin comillas, comillas simples y comas finales, así que aunque se parezcan a simple vista, el analizador los interpreta de otra manera.
  • Si el texto está copiado tal cual del código fuente, puedes convertirlo directamente en la consola del navegador asignándolo a una variable y usando JSON.stringify(). Este método equivale a ejecutar el código, así que el riesgo es menor cuando el código es de origen conocido.
  • El número de position en un error de JSON.parse es la posición del carácter contada desde el 0 de la cadena, así que si cuentas hasta ahí puedes acotar qué notación provocó el fallo.
  • El simple reemplazo puede generar errores por las comillas que hay dentro de las cadenas, así que en objetos largos o anidados los métodos que interpretan la sintaxis y convierten producen menos errores.
Convertidor de Objeto JS a JSON

Convierte al instante un literal de objeto JS con claves sin comillas y cadenas entre comillas simples en JSON estándar. Funciona en el navegador, sin instalar nada ni registrarte.

Preguntas frecuentes

¿Por qué aparece el error “Unexpected token” en JSON.parse?

Porque la cadena que introdujiste no cumple la sintaxis del JSON estándar. Las causas más frecuentes son que falten las comillas dobles en las claves, que los valores de cadena vayan entre comillas simples o que quede una coma final después del último elemento. Si cuentas hasta el número de position del mensaje de error, puedes comprobar exactamente en qué carácter se detuvo.

¿Basta con cambiar las comillas simples por comillas dobles?

Si los valores de cadena contienen comillas simples o dobles, un simple reemplazo puede estropear el resultado. El motivo es que puede cambiar también las comillas que están dentro de las cadenas o descolocar el tratamiento de los escapes. Los métodos que interpretan realmente la sintaxis y convierten no tienen este problema.

Si ya tengo un objeto JS, ¿es imprescindible hacer esta conversión para pasarlo a JSON?

Si tienes una variable de objeto JS en ejecución dentro del código, basta con ejecutar JSON.stringify(obj) y no necesitas ningún proceso de conversión aparte. La conversión solo es necesaria cuando el objeto existe únicamente en forma de texto (una salida de consola o un fragmento de código fuente) y no hay ninguna variable ejecutable.

¿Por qué no se pueden usar comentarios en JSON?

Porque la sintaxis del JSON estándar (RFC 8259) no define los comentarios. Los literales de objeto de JS siguen la sintaxis de JavaScript y por eso admiten comentarios // y /* */, pero si los trasladas a JSON esa parte provoca un error de sintaxis, así que hay que eliminarla.

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

Artículos relacionados

  1. Crear un JSON Schema: reglas de detección de tiposDescubre cómo se genera un esquema Draft-07 a partir de un JSON de ejemplo: cómo se deciden los tipos y qué significan required y anyOf.
  2. Error de sintaxis JSON: lee el mensaje y encuentra la causaQué indica la posición en un error de JSON y cómo reconocer los fallos más comunes: coma final, comillas simples, comentarios y claves sin comillas.
  3. 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.
  4. 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.
  5. 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.
  6. 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.

Herramientas relacionadas