JSON vs XML vs YAML: Memilih Format Data yang Tepat

Data yang sama, tiga cara

Di bawah ini satu object kecil ditulis dalam ketiga format. Dengan membandingkannya berdampingan, Anda bisa melihat apa yang dikorbankan tiap format.

{
  "user": {
    "name": "Ada Lovelace",
    "roles": ["admin", "editor"],
    "active": true
  }
}

user:
  name: Ada Lovelace
  roles:
    - admin
    - editor
  active: true

<user active="true">
  <name>Ada Lovelace</name>
  <roles>
    <role>admin</role>
    <role>editor</role>
  </roles>
</user>

Tiga field yang sama, jumlah tanda baca yang sangat berbeda. Perbedaan itulah seluruh ceritanya: JSON paling ramah mesin, YAML paling ramah manusia untuk ditulis tangan, dan XML paling ekspresif ketika dokumennya sendiri butuh struktur di luar data key/value sederhana.

Di mana JSON unggul

JSON memetakan langsung ke struktur data yang sudah dimiliki setiap bahasa utama (object/dict dan array/list), sehingga hasil parsing menjadi tipe native tanpa ambiguitas. JSON tidak punya komentar, hanya punya satu cara menulis setiap nilai, dan tidak peka whitespace. Batasan itu membuatnya cepat diurai dan aman dibuat oleh kode.

Gunakan JSON untuk apa pun yang mesin-ke-mesin: payload REST dan GraphQL API, data yang dilewatkan antar-layanan, apa pun yang disimpan di database dokumen (MongoDB, JSONB PostgreSQL), dan konfigurasi apa pun yang terutama dibaca dan ditulis oleh kode, bukan diedit tangan.

Di mana YAML unggul

YAML adalah superset ketat dari model data JSON dengan sintaks yang jauh lebih ramah bagi manusia: tidak ada closing bracket yang perlu dihitung, komentar memakai #, dan indentasi menggantikan tanda baca. Anda butuh itu untuk berkas yang diedit langsung oleh manusia dan dibaca ulang dalam diff: pipeline CI (GitHub Actions, GitLab CI), manifest Kubernetes, dan konfigurasi aplikasi.

Fleksibilitas itu juga jebakan terbesar YAML. Kesalahan indentasi menghasilkan struktur berbeda tanpa parse error, dan parser bisa mengubah nilai tanpa kutip seperti `no`, `yes`, `on`, dan tanggal menjadi boolean atau timestamp yang tidak Anda maksud ('Norway problem' yang terkenal, ketika kode negara NO berubah menjadi boolean false). Beri kutip pada string Anda setiap kali sebuah nilai bisa dibaca dua cara.

Di mana XML unggul

XML tampak seperti warisan yang membengkak di samping JSON, tetapi ia bisa melakukan hal yang tak bisa dilakukan JSON maupun YAML: atribut berdampingan dengan konten elemen, mixed content (teks dan elemen berseling, seperti HTML), namespace untuk menggabungkan kosakata dari sumber berbeda, serta validasi schema matang (XSD) dan tooling transformasi (XSLT) yang lebih tua satu dekade dari JSON.

XML bertahan di ranah yang berorientasi dokumen: API SOAP, SVG, DOCX/XLSX (berkas ZIP berisi XML), dan sistem enterprise di perbankan, kesehatan, dan pemerintahan dengan pipeline tervalidasi XSD yang tidak akan ditulis ulang. Jika data Anda berbentuk dokumen ('paragraf dengan span tebal di tengahnya') dan bukan record, XML sering kali lebih cocok.

Konversi antar-format

Ketiganya mendeskripsikan model data object/array/string/number/boolean/null yang sama (hanya atribut dan mixed content XML yang tidak terpetakan dengan bersih), jadi konversi data berbentuk record antara JSON, YAML, dan XML bersifat mekanis. Alat JSON to YAML, YAML to JSON, JSON to XML, dan XML to JSON milik JsonForge mengonversi di peramban. Ini berguna saat Anda memigrasi format berkas konfigurasi atau perlu menyerahkan ekspor JSON kepada rekan tim yang hanya memakai YAML.