Format Atlas

Comparer

JSON vs TOML

JSON est très utilisé pour les API et les échanges entre programmes. TOML vise les configurations applicatives modifiées par des personnes, avec clés, valeurs, tables et listes lisibles.

Quel format choisir ?

Utilisez JSON lorsqu’une API ou un outil l’exige. Envisagez TOML pour les réglages maintenus par des personnes qui profitent des commentaires et de tables claires, après vérification du parseur et de sa version.

Adapté pour JSON

API web, fichiers de configuration et échange de données

  • Transférer des données structurées

Adapté pour TOML

Configuration d’applications et d’outils

  • Réglages lisibles avec des valeurs structurées

Informations générales

ÉlémentJSONTOML
Extension.json.toml
Type MIMEapplication/jsonapplication/toml
Usages courantsAPI web, fichiers de configuration et échange de donnéesConfiguration d’applications et d’outils
Comment ouvrirOuvrez-le dans un éditeur de texte, un IDE ou un visualiseur compatible JSON.Ouvrez-le dans un éditeur de texte ou compatible avec les configurations. Consultez la documentation de l’application pour les fonctions TOML prises en charge.
Exporter ou convertirDes applications ou outils de conversion peuvent le convertir vers des formats tels que CSV.Lors d’une conversion depuis JSON ou YAML, vérifiez après l’analyse l’imbrication, les tableaux, les guillemets, les dates et les types de valeurs.

Choisir selon l’usage

Transférer des données structurées

API web, fichiers de configuration et échange de données

JSON

Réglages lisibles avec des valeurs structurées

Configuration d’applications et d’outils

TOML

Point clé 1

JSON est normalisé pour l’échange de données structurées et sa syntaxe standard ne prévoit pas de commentaires.

En savoir plus sur les différences

Point clé 2

TOML est un format texte de configuration dont tables et listes sont pensées pour être lues et modifiées.

En savoir plus sur les différences

En savoir plus sur les différences

Choisissez le format pris en charge par l’application destinataire et le flux. Validez le schéma et vérifiez que dates, nombres et listes gardent les types voulus après conversion.

  • JSON est courant dans les API et les échanges interopérables entre machines.
  • TOML peut clarifier les réglages maintenus à la main, mais tous les services attendant JSON ne l’acceptent pas.
  • Les deux nécessitent validation du parseur et du schéma lorsque la configuration influe sur l’application.

Questions fréquentes

Une configuration doit-elle toujours utiliser TOML plutôt que JSON ?

Non. Suivez les exigences des outils ; TOML facilite parfois la maintenance humaine, mais beaucoup d’API et d’outils exigent JSON.

JSON peut-il contenir des commentaires ?

JSON standard ne prend pas en charge les commentaires. Si nécessaire, choisissez un format et un parseur qui les autorisent explicitement.

En savoir plus

Usages et vérifications associés

Choisir un format de configuration

Références et spécifications