YAML vers JSON

Qu'est-ce que la conversion YAML vers JSON ?

La conversion YAML vers JSON transforme des données écrites en YAML (YAML Ain't Markup Language) en JSON (JavaScript Object Notation). Les deux formats représentent des données structurées sous forme de paires clé-valeur, de séquences et d'objets imbriqués, mais leur syntaxe diffère. YAML utilise l'indentation et une ponctuation minimale, tandis que JSON s'appuie sur les accolades, les crochets et les guillemets obligatoires. Convertir entre les deux est une tâche courante lorsqu'on fait transiter des données de configuration entre des systèmes qui attendent des formats différents.

YAML a été conçu pour la lisibilité humaine. Il prend en charge les commentaires, les chaînes multilignes, les ancres et les alias, aucune de ces fonctionnalités n'existant en JSON. Lors de la conversion de YAML vers JSON, ces fonctionnalités propres à YAML sont résolues : les ancres sont développées en ligne, les commentaires sont supprimés et les blocs multilignes deviennent des chaînes échappées. La sortie est du JSON valide, lisible par n'importe quel parseur JSON.

La spécification YAML 1.2 définit explicitement JSON comme un sous-ensemble de YAML, ce qui signifie que tout document JSON valide est aussi un YAML valide. L'inverse n'est pas vrai. Les documents YAML qui utilisent des commentaires, des ancres ou des clés complexes n'ont pas d'équivalent JSON direct et doivent être simplifiés lors de la conversion. Cet outil gère cette conversion automatiquement, produisant un JSON propre et bien formaté à partir de n'importe quelle entrée YAML valide.

YAML 1.2 Specification — yaml.org →

Pourquoi utiliser un convertisseur YAML vers JSON en ligne ?

Convertir du YAML en JSON à la main est source d'erreurs, surtout avec des structures profondément imbriquées ou des valeurs multilignes. Un convertisseur dans le navigateur te donne le résultat instantanément et détecte les erreurs de syntaxe YAML avant qu'elles n'atteignent ton application.

Cas d'utilisation de YAML vers JSON

Référence de correspondance des types YAML vers JSON

Chaque type de données YAML se mappe à un type JSON spécifique lors de la conversion. Le tableau ci-dessous présente chaque construct YAML avec sa sortie JSON correspondante. Comprendre ces correspondances te permet d'anticiper l'aspect de tes données YAML après conversion et d'éviter les surprises avec des types comme les booléens ou les valeurs null.

Syntaxe YAML vs JSON

YAML et JSON représentent le même modèle de données mais avec des règles de syntaxe différentes. Les différences ci-dessous expliquent pourquoi certaines fonctionnalités YAML — comme les commentaires et les ancres — n'ont pas d'équivalent JSON.

Exemples de code

Voici des exemples fonctionnels pour convertir du YAML en JSON par programmation. Chaque exemple analyse une chaîne YAML et produit un JSON formaté.

import { load } from 'js-yaml'

const yamlStr = `
server:
  host: localhost
  port: 8080
  ssl: true
`

const json = JSON.stringify(load(yamlStr), null, 2)
console.log(json)
// → {
// →   "server": {
// →     "host": "localhost",
// →     "port": 8080,
// →     "ssl": true
// →   }
// → }

import yaml, json

yaml_str = """
database:
  host: db.example.com
  port: 5432
  credentials:
    user: admin
    password: s3cret
"""

data = yaml.safe_load(yaml_str)
print(json.dumps(data, indent=2))
# → {
# →   "database": {
# →     "host": "db.example.com",
# →     "port": 5432,
# →     "credentials": {
# →       "user": "admin",
# →       "password": "s3cret"
# →     }
# →   }
# → }

package main

import (
	"encoding/json"
	"fmt"
	"log"
	"gopkg.in/yaml.v3"
)

func main() {
	yamlData := []byte(`
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
`)

	var obj map[string]interface{}
	if err := yaml.Unmarshal(yamlData, &obj); err != nil {
		log.Fatal(err)
	}
	jsonBytes, _ := json.MarshalIndent(obj, "", "  ")
	fmt.Println(string(jsonBytes))
	// → { "services": { "web": { "image": "nginx:latest", "ports": ["80:80"] } } }
}

# Convert a YAML file to JSON with yq
yq -o=json config.yaml > config.json

# Pipe YAML into yq for one-off conversion
echo "name: demo" | yq -o=json
# → { "name": "demo" }

# Python one-liner (no extra install on most systems)
python3 -c "import yaml, json, sys; print(json.dumps(yaml.safe_load(sys.stdin), indent=2))" < config.yaml

Questions fréquentes