YAML to JSON

Що таке конвертація YAML у JSON?

Конвертація YAML у JSON перетворює дані, написані в YAML (YAML Ain't Markup Language), у формат JSON (JavaScript Object Notation). Обидва формати представляють структуровані дані у вигляді пар ключ-значення, послідовностей і вкладених об'єктів, але відрізняються синтаксисом. YAML використовує відступи та мінімальну пунктуацію, тоді як JSON — фігурні дужки, квадратні дужки та обов'язкові лапки. Конвертація між цими форматами є поширеним завданням при перенесенні конфігураційних даних між системами, що очікують різні формати.

YAML розроблений для зручності читання людиною. Він підтримує коментарі, багаторядкові рядки, якорі та псевдоніми — нічого з цього не існує у JSON. При конвертації YAML у JSON ці специфічні можливості YAML вирішуються: якорі розгортаються вбудовано, коментарі відкидаються, а багаторядкові блоки стають рядками з екранованими символами. Результат — валідний JSON, який може прочитати будь-який JSON-парсер.

Специфікація YAML 1.2 явно визначає JSON як підмножину YAML, тобто кожен валідний JSON-документ є також валідним YAML. Зворотне не є правдою. YAML-документи з коментарями, якорями або складними ключами не мають прямого еквівалента у JSON і мають бути спрощені під час конвертації. Цей інструмент виконує конвертацію автоматично, формуючи чистий, добре відформатований JSON з будь-якого валідного YAML-вхідного документа.

YAML 1.2 Specification — yaml.org →

Навіщо використовувати онлайн-конвертер YAML у JSON?

Конвертувати YAML у JSON вручну — схильно до помилок, особливо при глибоко вкладених структурах або багаторядкових значеннях. Браузерний конвертер дає результат миттєво і виявляє синтаксичні помилки YAML ще до того, як вони потраплять у застосунок.

Сценарії використання YAML to JSON

Довідник відображення типів YAML у JSON

Кожен тип даних YAML відображається у конкретний тип JSON під час конвертації. Таблиця нижче показує кожну YAML-конструкцію поруч із її JSON-виводом. Розуміння цих відображень допомагає передбачити, як виглядатимуть ваші YAML-дані після конвертації, та уникнути несподіванок із типами на кшталт булевих значень або null.

Синтаксис YAML та JSON

YAML і JSON представляють однакову модель даних, але з різними синтаксичними правилами. Відмінності нижче пояснюють, чому деякі можливості YAML — як-от коментарі та якорі — не мають еквівалента у JSON.

Приклади коду

Нижче наведено робочі приклади програмної конвертації YAML у JSON. Кожен приклад розбирає YAML-рядок і виводить відформатований JSON.

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

Часті запитання