Convertir YAML a JSON: reglas y errores al pasar tu configuración

Contenido
Muchos archivos de configuración se escriben en YAML. La estructura se ve solo con la indentación y puedes añadir comentarios con total libertad, así que para leer y editar a mano YAML es mucho más cómodo. Pero en el momento en que quieres usar esos valores dentro de código JavaScript o pegarlos tal cual en el cuerpo de una petición a una API, te das cuenta de que YAML así como está no sirve.
Resumen ① YAML es fácil de leer y escribir para las personas, pero los objetos de JavaScript y los cuerpos de petición a una API esperan el formato JSON ② Si conoces las reglas para pasar de una estructura basada en indentación a una basada en llaves y corchetes, puedes hacer el cambio incluso a mano ③ En YAML con anidación profunda o listas mezcladas es fácil equivocarse al convertir a mano, así que conviene revisar el resultado con la vista
Por qué el YAML de configuración no funciona en el código
YAML representa la jerarquía con indentación y escribe el valor después de dos puntos, y por eso resulta cómodo de leer. También admite comentarios (#) sin restricciones, así que se usa mucho como formato de archivo de configuración.
El problema es que lugares como JSON.parse de JavaScript o el cuerpo de una petición con fetch no entienden la sintaxis de YAML. Esas funciones solo interpretan sintaxis JSON: llaves, corchetes y claves entre comillas dobles.
Por eso, si pegas tal cual en una petición de prueba a una API un valor que está en el archivo de configuración, o si intentas pasarlo como constante dentro del código del frontend, te salta un error de sintaxis. YAML en sí está perfectamente bien escrito, pero donde se espera JSON da error.
Cómo comprobarlo: reglas para convertir a mano y verificar
Al convertir a mano hay tres reglas. Primera: convierte key: value en la clave y el valor entre comillas dobles. Segunda: los subelementos expresados con indentación se agrupan entre llaves. Tercera: los elementos de lista que van al inicio de la línea se convierten en un array entre corchetes.
| Notación YAML | Notación JSON |
|---|---|
| host: localhost | Clave y valor entre comillas dobles |
| Subelementos agrupados por indentación | Se envuelven entre llaves |
| Elementos de lista al inicio de la línea | Se convierten en un array entre corchetes |
| true, false, null, números | Se mantienen igual, sin comillas |
Las reglas son sencillas, pero cuando la jerarquía pasa de dos o tres niveles no es fácil cuadrar las llaves y los corchetes a mano. Si dentro de una lista vuelve a haber objetos, los corchetes y las llaves se superponen y es aún más fácil equivocarse.
Compruébalo con el Conversor de YAML a JSON. Pega el YAML en el campo de entrada, el resultado en JSON aparece al momento justo debajo, y puedes elegir el ancho de indentación entre 2 espacios, 4 espacios o una sola línea (comprimido) para copiarlo tal cual y pegarlo en tu código.
Gratis · Sin registro · Convierte a JSON directamente en el navegador

Los puntos donde sueles atascarte
| Situación | Por qué te bloqueas |
|---|---|
| Estructura con objetos mezclados dentro de una lista | Las llaves quedan dentro de los corchetes y es difícil emparejarlos a mano |
| Cadenas que incluyen dos puntos o comillas | Si no las escapas, se produce un error de sintaxis |
| Indentación mezclando tabulaciones y espacios | La jerarquía se interpreta de otra manera y la conversión da una estructura equivocada |
| Dejar una coma después del último elemento | JSON no permite una coma después del último elemento |
Las situaciones de la tabla no se ven con solo echar un vistazo: hay que intentar el parseo de verdad para localizar el error. Después de convertir conviene tener la costumbre de comprobar una vez que la estructura es la misma que la del original.
En resumen
YAML es un formato cómodo para que las personas lean y editen la configuración, y JSON es el formato que entienden el código y las API. Si cambias los dos puntos por comillas, la indentación por llaves y las listas por corchetes, también puedes pasarlo a mano.
Eso sí, cuando la jerarquía se hace profunda o se mezclan listas y objetos, es fácil equivocarse cuadrando las llaves y los corchetes. En esos casos es más rápido usar una herramienta que te deje revisar el resultado de la conversión a simple vista.
Gratis · Sin registro · Convierte a JSON directamente en el navegador
Preguntas frecuentes
¿Se puede convertir toda la sintaxis de YAML a JSON?
Las estructuras que más se usan en un archivo de configuración, como pares clave-valor, mapas anidados y listas, se pueden pasar a JSON tal cual. Lo que no existe es un equivalente en JSON para la sintaxis propia de YAML, como los anchors y las referencias: primero tienes que dejar los valores expandidos y después convertir.
¿Puedo usar el JSON convertido tal cual en el cuerpo de una petición a una API?
Si ya es una estructura JSON estándar, puedes ponerlo tal cual en el cuerpo de una petición con fetch o axios. Eso sí, tienes que comprobar aparte si los nombres de campo y los tipos de valor que espera la API coinciden con las claves del YAML original.
¿Qué indentación elijo, 2 o 4 espacios?
Los datos ya parseados son idénticos sea cual sea el ancho de la indentación. Si vas a pegarlo en un código en el que colaboras, ajusta al espaciado que use ese proyecto; y en sitios donde los espacios no importan, como el cuerpo de una petición a una API, la opción de una sola línea (comprimido) es más cómoda.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano