Cara Mengubah YAML ke JSON: Kesalahan Umum yang Harus Dihindari
Mengapa YAML dan JSON Tidak Sepenuhnya Bisa Saling Menggantikan Seperti Kelihatannya
YAML dan JSON memang terlihat mirip, dan hubungan keduanya sangat erat. YAML 1.2 bahkan merupakan superset dari JSON, jadi semua JSON yang valid juga merupakan YAML yang valid. Kedengarannya bagus, kan? Memang, sampai kamu mencoba meng-convert file YAML sungguhan dan menemukan kerusakan data senyap pertama kamu. Kedua format ini punya tujuan desain yang berbeda. JSON dibuat untuk mesin: ketat, tidak ambigu, dan tanpa ruang untuk komentar. Sebaliknya, YAML dibuat untuk manusia. Ia menggunakan indentasi untuk struktur, mendukung string multi-baris, mengizinkan komentar inline, dan memiliki sistem inferensi tipe yang mencoba menebak maksud kamu. Tebakan yang 'membantu' inilah yang justru membuat proses konversi jadi berantakan. Parser YAML mungkin membaca string 'yes' dan menginterpretasikannya sebagai boolean `true`. Ia mungkin melihat '1.0' dan menghasilkan float, bukan string yang kamu ketik. Ini bukan bug; spesifikasi YAML memang bekerja sesuai desainnya. Masalahnya muncul karena JSON tidak memiliki ambiguitas semacam itu. Begitu nilai YAML kamu menjadi boolean dalam data yang di-parse, output JSON akan menulis `true`, dan string aslinya hilang selamanya. Saat kamu meng-convert file konfigurasi untuk klaster Kubernetes, spesifikasi OpenAPI, atau pipeline CI/CD, perubahan tipe yang senyap ini bisa merusak semua proses turunan tanpa satu pun pesan error. Untuk meng-convert file secara andal, kamu harus memahami perbedaan mendasar ini.
Cara Tercepat untuk Mengubah File: Menggunakan CocoConvert
Kalau kamu hanya perlu mengubah satu file, cara tercepat adalah menggunakan tool khusus daripada merakit skrip sendiri. [Konverter YAML ke JSON](/convert/yaml-to-json) dari CocoConvert menangani semua proses parsing dan serialisasi, memberikan kamu output berformat benar dengan encoding UTF-8 secara langsung. Prosesnya sangat simpel: tempel YAML kamu, unggah file .yaml atau .yml, dan klik Convert. JSON kamu akan muncul di panel output, siap untuk disalin atau diunduh. CocoConvert menggunakan aturan parsing YAML 1.2 modern, jadi kamu tidak akan terjebak 'Masalah Norwegia' yang lama di mana string 'NO' disalahartikan sebagai boolean `false`. Jika YAML sumber kamu memiliki kesalahan indentasi, kamu akan mendapatkan pesan error parsing yang jelas dengan nomor baris, bukan output yang rusak secara diam-diam. Tool ini juga menangani file YAML multi-dokumen (yang menggunakan pemisah `---`) dengan benar. File seperti ini akan diubah menjadi array JSON, di mana setiap dokumen menjadi elemen array. Ini adalah perilaku standar yang diharapkan, tapi ada baiknya diingat jika kamu melihat array yang tidak terduga di output karena file kamu dimulai dengan `---`. Ada satu batasan: tool ini tidak mendukung anchor dan alias YAML yang mereferensikan node di antara dokumen yang berbeda dalam file yang sama. Untuk kasus kompleks yang melibatkan anchor lintas-dokumen, kamu perlu menyelesaikannya terlebih dahulu, baik secara manual atau dengan skrip lokal, sebelum mengunggah file untuk konversi.
Pemaksaan Tipe YAML: Kesalahan yang Paling Sering Terjadi
Pemaksaan tipe (type coercion) adalah penyebab nomor satu hilangnya data saat mengubah dari YAML ke JSON. Sebelum kamu meng-convert file produksi apa pun, kamu mutlak harus mengaudit kesalahan-kesalahan spesifik ini. **Boolean dari string yang tidak terduga.** Parser YAML 1.1 lama (seperti PyYAML sebelum versi 6.0) akan menginterpretasikan `yes`, `no`, `on`, dan `off` sebagai boolean. YAML 1.2 modern hanya memperlakukan `true` dan `false` seperti ini, tetapi jika file sumber kamu dibuat oleh tool yang lebih tua, mungkin saja berisi 'yes' padahal yang dimaksud sebenarnya adalah string 'yes'. Jika kamu tidak tahu asal-usul file tersebut, kamu perlu memeriksa nilai-nilai ini secara manual. **Integer oktal.** Yang ini klasik. Dalam YAML, nilai seperti `0755` di-parse sebagai integer oktal 493. Ini adalah jebakan terkenal dalam manifest Kubernetes untuk mengatur izin file. Saat diubah, JSON kamu akan berisi angka `493`, bukan string `'0755'`. Jika proses turunan mencoba menggunakan angka itu dalam panggilan `chmod`, izinnya akan salah total, dan kamu tidak akan mendapatkan error. **Kasus-kasus khusus floating-point.** YAML memahami nilai float khusus seperti `.inf`, `-.inf`, dan `.nan`. JSON tidak. CocoConvert menanganinya dengan mengubahnya menjadi string 'Infinity', '-Infinity', dan 'NaN'. Ini adalah solusi yang masuk akal, tetapi jika aplikasi kamu hanya mengharapkan angka, aplikasi itu bisa gagal saat menerima nilai string ini, sehingga memerlukan pemrosesan tambahan. **Representasi null.** YAML fleksibel dengan nilai null, menerima `null`, `~`, atau bahkan nilai kosong setelah sebuah key. Semua ini akan menjadi `null` standar di JSON. Ini biasanya tidak masalah, tetapi ingat bahwa key tanpa apa pun setelah titik dua akan menjadi `null` di JSON, bukan string kosong `""`.
Menangani String Multi-Baris dan Komentar
YAML menawarkan dua sintaks string multi-baris yang kuat yang tidak memiliki padanan langsung di JSON: skalar blok literal (`|`) dan skalar blok terlipat (`>`). Blok literal (`|`) mempertahankan setiap baris baru. Blok terlipat (`>`) mengubah baris baru tunggal menjadi spasi tetapi mempertahankan baris baru ganda sebagai baris baru sungguhan. Kedua sintaks ini menghasilkan satu string JSON, tetapi perbedaan halus dalam penanganan baris baru ini sangat penting untuk konten yang disematkan seperti skrip shell, kueri SQL, atau sertifikat. Contohnya, YAML ini: ```yaml script: | echo hello echo world ``` menjadi JSON ini: ```json {"script": "echo hello\necho world\n"} ``` Perhatikan baris baru di akhir (`\n`) dipertahankan secara default dengan gaya literal `|`. Untuk menghapusnya, kamu harus menggunakan indikator chomping `|-`. Siapa pun yang pernah men-debug skrip CI yang gagal karena perbedaan spasi tipis pasti tahu betapa menyebalkannya ini. Kesalahan ini bisa merusak skrip atau API yang sensitif terhadap spasi. Komentar adalah masalah yang jauh lebih sulit. YAML mendukung komentar menggunakan `#`. JSON tidak. Titik. Ini berarti bahwa selama konversi, setiap komentar di file YAML kamu akan dihapus secara permanen. Semua konteks penting yang menjelaskan *mengapa* suatu nilai diatur—praktik umum dalam infrastructure-as-code—lenyap dari output JSON. Tidak ada solusi dalam spesifikasi JSON. Rekomendasi saya sederhana: selalu perlakukan YAML yang berkomentar sebagai sumber kebenaran (source of truth) dan JSON yang dihasilkan sebagai artefak build yang bisa dibuang. Beberapa tim menggunakan JSONC (JSON with Comments), tetapi itu hanya menunda masalah kompatibilitas.
Anchor, Alias, dan Merge Key
Anchor dan alias YAML adalah fitur fantastis untuk menjaga file kamu tetap DRY (Don't Repeat Yourself), tetapi mereka menambah kompleksitas selama konversi JSON. Kamu mendefinisikan anchor dengan `&anchor-name` dan kemudian mereferensikannya dengan `*anchor-name`. Parser YAML akan memperluas alias-alias ini saat membaca file, membangun struktur data akhir di memori. Oleh karena itu, output JSON akan berisi konten yang sepenuhnya diperluas dan diduplikasi, tanpa jejak anchor aslinya. Perhatikan pola umum ini: ```yaml defaults: &defaults timeout: 30 retries: 3 production: <<: *defaults host: prod.example.com staging: <<: *defaults host: staging.example.com ``` Sintaks `<<` adalah merge key YAML. JSON yang dihasilkan akan menjadi: ```json { "defaults": {"timeout": 30, "retries": 3}, "production": {"timeout": 30, "retries": 3, "host": "prod.example.com"}, "staging": {"timeout": 30, "retries": 3, "host": "staging.example.com"} } ``` Hasil ekspansinya benar, tetapi keringkasan YAML aslinya hilang. Jika ada 50 layanan yang mewarisi dari anchor `defaults` tersebut, maka JSON akan berisi 50 salinan data itu. Bagi mesin, ini tidak masalah. Bagi manusia yang mencoba membaca file, atau untuk sistem di mana ukuran file menjadi perhatian, ini adalah kelemahan yang signifikan. Perlu diketahui bahwa dukungan merge key (`<<`) secara teknis adalah ekstensi YAML, bukan bagian dari spesifikasi inti, jadi beberapa parser yang ketat akan menolaknya. CocoConvert menangani merge key tanpa masalah. Jika kamu membuat skrip konversi dengan PyYAML Python, kamu harus menggunakan `yaml.full_load()` atau `yaml.safe_load()`. Hindari `yaml.load()` yang lama tanpa argumen `Loader`, karena sudah tidak digunakan lagi sejak PyYAML 5.1 karena risiko keamanan yang besar.
Mengubah YAML ke JSON Secara Terprogram
Untuk konversi massal, integrasi pipeline build, atau pemrosesan otomatis apa pun, kamu akan memerlukan solusi command-line atau skrip. Tool web bagus untuk sekali pakai, tetapi otomatisasi menuntut kode. Berikut adalah cara-cara yang paling andal untuk melakukannya. **Python (opsi paling portabel):** ```python import yaml, json, sys with open(sys.argv[1], 'r') as f: data = yaml.safe_load(f) print(json.dumps(data, indent=2, ensure_ascii=False)) ``` Selalu gunakan `yaml.safe_load()`. `yaml.load()` yang lama adalah mimpi buruk keamanan yang dapat mengeksekusi kode arbitrer dari file YAML yang berbahaya. Argumen `ensure_ascii=False` juga merupakan kebiasaan yang baik, karena mempertahankan karakter Unicode alih-alih mengubahnya menjadi escape sequence. **Node.js:** ```javascript const yaml = require('js-yaml'); const fs = require('fs'); const data = yaml.load(fs.readFileSync(process.argv[2], 'utf8')); console.log(JSON.stringify(data, null, 2)); ``` Library `js-yaml` menggunakan aturan YAML 1.2 modern secara default (sejak v4.0). Jika kamu bekerja di proyek yang lebih lama, periksa kembali `package.json` kamu. Versi sebelum 4.0 menggunakan aturan YAML 1.1 dan akan salah memaksa string seperti 'yes' dan 'no' menjadi boolean. **yq (tool command-line):** ```bash yq -o=json eval '.' input.yaml > output.json ``` Jujur saja, `yq` adalah tool terbaik untuk pekerjaan ini di command line. Ini adalah prosesor YAML yang dibuat khusus yang menangani semuanya dengan benar—file multi-dokumen, anchor, merge key—dengan flag sederhana untuk output JSON. Instal dengan Homebrew di macOS (`brew install yq`) atau ambil binernya dari GitHub untuk Linux/Windows. Tentu saja, untuk konversi cepat tanpa menginstal apa pun, [tool YAML ke JSON dari CocoConvert](/convert/yaml-to-json) tetap menjadi cara tercepat untuk menyelesaikannya.
Memvalidasi Output Kamu Sebelum Menggunakannya
Mengubah file tanpa memvalidasinya adalah cara mudah untuk memasukkan bug tersembunyi ke dalam produksi. File JSON bisa jadi valid secara sintaksis tetapi berisi data yang salah secara semantik, seperti pemaksaan tipe yang telah kita bahas. Berikut adalah daftar periksa praktis untuk menyelamatkan kamu dari pusing di kemudian hari. **Validasi sintaks.** Minimal, jalankan output melalui linter JSON. Editor kode kamu (seperti VS Code atau JetBrains IDE) mungkin melakukannya secara otomatis. Dari command line, `json.tool` bawaan Python adalah andalan yang dapat diandalkan: `python3 -m json.tool output.json > /dev/null`. Perintah ini akan keluar dengan kode 0 untuk JSON yang valid dan memberitahu kamu di mana tepatnya letak kesalahannya jika gagal. **Validasi skema.** Untuk file-file penting, gunakan skema. Jika format target kamu memiliki Skema JSON (umum untuk spesifikasi OpenAPI, AWS CloudFormation, dan Kubernetes CRD), validasi dengan skema tersebut. Tool seperti `ajv-cli` (`ajv validate -s schema.json -d output.json`) akan menangkap ketidakcocokan tipe yang tidak bisa dilihat oleh pemeriksaan sintaks sederhana. **Bandingkan (diff) dengan versi yang sudah terbukti benar.** Ketika kamu memiliki file JSON referensi, melakukan diff sangat penting. Tapi pertama-tama, normalkan urutan key untuk menghindari perbedaan yang tidak berarti dan mengganggu. Tool `jq` dapat mengurutkan key secara deterministik: `jq --sort-keys . output.json > normalized.json`. Ingat, urutan key dalam JSON tidak penting, tetapi akan membuat kamu pusing saat mencoba membandingkan file. **Periksa langsung untuk tipe yang dipaksakan.** Jika kamu curiga YAML kamu memiliki nilai seperti '1.0' atau '0755', periksa output JSON secara langsung. `grep -n "0755" output.json` yang cepat akan memberitahu kamu secara instan apakah string oktal kamu selamat dari konversi atau diubah menjadi integer yang tidak berguna. Serius, meluangkan lima menit untuk memvalidasi output kamu sebelum melakukan commit atau deployment selalu lebih cepat daripada men-debug insiden produksi yang disebabkan oleh boolean yang seharusnya berupa string.