Konverter JSON ⇄ YAML

Cara kerja

Konverter ini dua arah: JSON ke YAML dibaca dengan JSON.parse bawaan lalu ditulis dengan js-yaml, dan YAML ke JSON melakukan sebaliknya. Konversi berjalan otomatis saat Anda mengetik (dengan tunda seperempat detik), dan galat sintaks di arah mana pun menampilkan pesan parser di baris merah sambil mengosongkan keluaran.

Mengapa YAML

YAML adalah bahasa berkas konfigurasi: manifest Kubernetes, workflow GitHub Actions, playbook Ansible. Gaya bloknya jauh lebih enak dibaca daripada JSON yang setara: tanpa kurung kurawal, tanpa koma, dan kunci serta komentar bisa berada di tingkat teratas dokumen. Komentar boleh di YAML tetapi tidak ada padanannya di JSON, itulah sebabnya komentar tidak pernah selamat dari konversi.

Opsi penulisan

Keluaran JSON ke YAML memakai indentasi 2 spasi, gaya blok untuk sequence dan mapping, tanpa anchor atau alias (bawaan js-yaml), dan string hanya diberi tanda kutip bila memang perlu — teks biasa seperti hello tetap tanpa kutip.

Urutan kunci

Urutan kunci dipertahankan saat menulis YAML: js-yaml memunculkan properti sesuai urutannya di dokumen sumber, yang juga merupakan urutan penyimpanan JSON.parse di dalam object.

Yang hilang saat konversi

Komentar dibuang di kedua arah (JSON tidak dapat membawanya dan parser membuang komentar YAML). Berkas YAML multi-dokumen yang dipisah --- tidak didukung — alat ini membaca satu dokumen, jadi pisahkan alurnya dan konversi tiap bagian sendiri. Kunci ganda di JSON mengikuti nilai terakhir, sesuai aturan formatnya.

String mirip tanggal

YAML 1.1 zaman dulu mengubah nilai seperti 2024-01-01 menjadi objek tanggal native. Parser yang dipakai di sini mengikuti schema core modern: nilai mirip tanggal dimuat sebagai string biasa dan ditulis dengan tanda kutip (‘2024-01-01’), sehingga selamat saat dikonversi bolak-balik dan tidak pernah diam-diam berubah jadi timestamp.

Pertanyaan yang sering diajukan