Convertisseur TOML vers JSON

Qu'est-ce que le TOML et pourquoi le convertir en JSON ?

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Fonctionnalités clés

Exemples

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Comment l'utiliser

1. 1

   Collez votre TOML

   Saisissez ou collez votre TOML dans le champ de saisie ci-dessus. Vous pouvez aussi cliquer sur « Charger un exemple » pour essayer un vrai Cargo.toml, pyproject.toml ou une config de déploiement.

2. 2

   Voyez la sortie JSON en direct

   Le JSON apparaît instantanément dans le panneau de sortie. Ajustez l'option Indentation (2 ou 4 espaces) pour correspondre à votre format cible. Les dates, tables et tableaux de tables sont gérés automatiquement.

3. 3

   Copiez ou téléchargez

   Cliquez sur Copier pour placer le JSON dans votre presse-papiers, ou sur Télécharger pour l'enregistrer en fichier .json prêt pour votre programme, votre API ou votre outillage.

Pièges TOML courants

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Cas d'usage courants

Métadonnées Cargo de Rust

Convertissez Cargo.toml en JSON pour construire des tableaux de bord de dépendances, auditer les versions et fonctionnalités des crates, ou alimenter les données de manifeste dans des scripts et de la CI qui attendent du JSON plutôt que du TOML.

Configuration de projet Python

Convertissez pyproject.toml en JSON pour inspecter les métadonnées de projet PEP 621, extraire les listes de dépendances, ou piloter un outillage qui lit la configuration d'empaquetage de façon programmatique.

Inspection de config de déploiement

Convertissez netlify.toml, foundry.toml ou d'autres configurations de plateforme en JSON pour auditer les redirections, les en-têtes et les réglages de build, ou pour générer une configuration équivalente sur une autre plateforme.

Migration de format de configuration

Convertissez une configuration d'application TOML en JSON lors du passage à un système qui préfère le JSON, ou comme étape intermédiaire avant une transformation plus poussée avec des outils JSON comme jq.

Réglages de site statique

Convertissez le config.toml de Hugo en JSON pour migrer les réglages du site, comparer la configuration entre environnements, ou construire une interface de réglages adossée à du JSON.

Entrée d'API et de scripts

Transformez du TOML rédigé par des humains en JSON qu'une API REST, une fonction serverless ou un script d'automatisation peut consommer directement, reliant configuration lisible et entrée machine.

Détails techniques

Analyse TOML 1.0.0 via smol-toml

Le TOML est analysé avec la bibliothèque smol-toml, un analyseur sans dépendance et entièrement conforme à TOML 1.0.0. Il gère correctement les tables imbriquées, les clés pointées, les tables en ligne, les tableaux de tables, les chaînes multi-lignes et les quatre types de date-heure, et il signale les erreurs d'analyse avec des positions de ligne et de colonne.

Date-heures sans perte et gestion sûre des entiers

Les date-heures TOML sont sérialisées en chaînes JSON qui préservent leur type exact (date-heure avec décalage, date-heure locale, date locale, heure locale). Les entiers au-delà de la plage sûre de JavaScript (2^53 - 1) sont promus en BigInt lors de l'analyse, puis convertis au nombre JSON le plus proche avec un avertissement de précision, si bien qu'un TOML valide n'échoue jamais à la conversion.

100% dans le navigateur — aucun téléversement, aucun serveur

Tout le traitement se déroule dans le moteur JavaScript de votre navigateur. Aucune donnée n'est transmise à aucun moment. Les entrées de plus de 200 Ko passent du mode direct au mode manuel (un clic explicite sur Convertir) pour garder l'interface réactive.

Bonnes pratiques

Stockez les très grands entiers sous forme de chaînes

Si votre TOML comporte des entiers au-delà de 2^53 - 1 (identifiants Snowflake, horodatages à la nanoseconde, grands compteurs), mettez-les entre guillemets comme chaînes avant la conversion. Les nombres JSON dans le navigateur ne peuvent pas les contenir exactement, et l'outil vous avertira lorsqu'il devra arrondir.

Préférez l'indentation à 2 espaces pour la sortie JSON

L'indentation à deux espaces est la convention la plus répandue pour le JSON et produit une sortie propre et lisible qui s'accorde bien avec la plupart des formateurs et outils de comparaison. Réservez l'indentation à 4 espaces aux cas où un guide de style l'exige.

Validez la sortie JSON avant de l'utiliser

Après la conversion, si vous prévoyez de modifier le JSON à la main ou de l'alimenter dans un système strict, passez-le dans notre formateur JSON pour confirmer qu'il est valide et formaté de façon cohérente.

Conservez les commentaires TOML à part

JSON n'a pas de syntaxe de commentaire, les commentaires # de TOML sont donc supprimés à la conversion. Si les commentaires constituent une documentation importante, gardez le TOML d'origine dans le gestionnaire de versions à côté du JSON généré.

Utilisez des tableaux de tables pour les sections répétées

Lorsque vous avez plusieurs sections similaires (serveurs, redirections, binaires), écrivez-les comme des tableaux de tables ([[section]]) plutôt que de répéter [section]. Elles se convertissent en un tableau JSON d'objets propre au lieu de provoquer une erreur de table en double.

Questions fréquentes