Cómo usarla
- Pega un objeto JSON o prueba el ejemplo.
- Activa «Omitir valores nulos» si tu JSON contiene nulos que no necesitas.
- Copia el TOML o descárgalo como archivo .toml.
Cómo funciona
El JSON se analiza estrictamente y luego se escribe como TOML 1.0 con la biblioteca de código abierto smol-toml. Los objetos anidados se convierten en [tablas], los arreglos de objetos se convierten en [[arreglos de tablas]], y las claves que no son palabras simples se ponen entre comillas.
TOML no puede expresar todo lo que JSON puede. La raíz del documento debe ser una tabla, por lo que se rechaza un arreglo JSON o un valor único. No existe null en TOML: de forma predeterminada, se informa el primer null con su ruta; puedes elegir omitir los miembros de objeto null en su lugar. Un null dentro de un arreglo siempre es un error, porque eliminarlo cambiaría las posiciones de los demás elementos. Los arreglos que mezclan tipos (por ejemplo, números y cadenas) son válidos en TOML 1.0 pero no en la versión anterior 0.5, por lo que se cuentan en una nota.
JSON no distingue 1 de 1.0, por lo que los números enteros se escriben como enteros TOML. Las cadenas que parecen fechas se mantienen como cadenas. La otra dirección es de TOML a JSON.
Ejemplos
Configuración de la aplicación
{"server": {"host": "0.0.0.0", "port": 8080}} se convierte en una tabla [server] con las claves host y port.
Lista de trabajadores
"workers": [{"queue": "mail"}, {"queue": "images"}] se convierte en dos bloques [[workers]].
Preguntas frecuentes
¿Por qué no se permite null?
TOML no tiene valor null. Omite la clave o usa un valor como una cadena vacía, según lo que espera el programa que lo lee.
¿Por qué un arreglo de números y cadenas muestra una nota?
Los arreglos de tipos mixtos están permitidos desde TOML 1.0, pero las herramientas que implementan TOML 0.5 los rechazan. La nota ayuda si tu herramienta de destino es más antigua.
¿Se mantendrá 1.0 como flotante?
No. JSON almacena 1.0 y 1 como el mismo número, por lo que se convierte en el entero 1. Escribe 1.5 o edita el TOML si el programa que lee necesita un flotante.
Privacidad
La conversión se realiza completamente en tu navegador. Tu JSON y tu TOML no se suben ni se almacenan.