Cara memakai
- Tempel YAML Anda ke Teks YAML.
- Baca Validitas. Bila disebutkan baris dan kolom, perbaiki YAML di tempat itu.
- Bila YAML memuat beberapa dokumen, Teks JSON berupa satu larik dengan butir untuk setiap dokumen.
- Salin Teks JSON, atau unduh sebagai data.json.
Cara YAML dibaca
YAML 1.2 didefinisikan oleh spesifikasinya, yang menjelaskan cara membaca indentasi, nama, daftar, teks berkutip, dan blok. Alat ini membaca teks dengan pustaka yaml, yang mengikuti spesifikasi itu, lalu menuliskan hasilnya sebagai JSON.
- Pemetaan menjadi objek JSON, dengan namanya sesuai urutan penulisannya. Urutan menjadi larik. Kata true, false, dan null menjadi boolean dan null, sedangkan teks berkutip tetap teks.
- Bilangan bulat mempertahankan setiap digitnya. Nama yang berulang dalam satu pemetaan dilaporkan sebagai galat, karena JSON hanya akan menyimpan salah satu nilainya.
- Nilai seperti .inf atau .nan tidak punya bentuk JSON, sehingga ditolak alih-alih ditulis sebagai null atau sebagai angka yang berubah.
Beberapa dokumen dan alias
Berkas YAML bisa memuat beberapa dokumen, masing-masing dimulai dengan baris ---. Konverter membaca semuanya. Satu dokumen menghasilkan satu nilai JSON; beberapa dokumen menghasilkan larik JSON dengan satu butir untuk setiap dokumen, sesuai urutan kemunculannya. Alias (*nama) digantikan dengan nilai yang ditunjuknya. Berkas yang mengulang alias begitu banyak sehingga hasilnya membengkak ditolak.
Contoh: berkas dengan dua dokumen
Contoh 2.7 dari spesifikasi YAML 1.2, Two Documents in a Stream, memuat daftar pemukul home run, lalu baris ---, lalu daftar tim. Setelah diubah, hasilnya adalah larik JSON berisi dua larik, satu untuk setiap dokumen.
Larik pertama memuat ketiga pemain dan larik kedua memuat kedua tim, sesuai urutan penulisannya.
| Dokumen | Butir JSON |
|---|---|
| 1 | ["Mark McGwire", "Sammy Sosa", "Ken Griffey"] |
| 2 | ["Chicago Cubs", "St Louis Cardinals"] |
Pertanyaan yang sering diajukan
Mengapa galat menampilkan baris dan kolom?
Posisinya adalah tempat parser menyadari masalah, dihitung dari 1. Kesalahan sebenarnya bisa sedikit lebih awal, misalnya indentasi yang salah di baris sebelum baris yang disebut.
Apa arti catatan tentang beberapa dokumen?
Setiap baris yang diawali --- memulai dokumen baru. JSON-nya lalu berupa larik dengan satu butir untuk setiap dokumen, sesuai urutan. Bila Anda memaksudkan satu dokumen, hapus baris --- yang berlebih.
Mengapa .inf atau .nan memunculkan galat?
JSON tidak punya tak terhingga dan tidak punya bukan-angka, sehingga nilai seperti itu tidak bisa ditulis tanpa mengubahnya. Ganti dengan angka atau teks, lalu ubah YAML-nya lagi.
Apakah angka berubah dalam konversi?
Bilangan bulat mempertahankan setiap digitnya, sehingga 12345678901234567890 ditulis persis. Bilangan desimal ditulis sebagai angka JavaScript terdekat, sehingga 1.50 menjadi 1.5 dengan nilai yang sama.
Apakah JSON mempertahankan urutan nama?
Ya. Nama muncul sesuai urutan penulisannya dalam YAML. Objek JavaScript akan memindahkan nama seperti 2024 ke depan, dan konverter ini tidak melakukannya.
Apakah YAML saya diunggah ke suatu tempat?
Tidak. Konversi berjalan di peramban Anda, dan tidak ada yang Anda tempel yang dikirim ke server kami.
Sumber
- YAML Ain't Markup Language (YAML) revisi 1.2.2 (dalam bahasa Inggris)
- RFC 8259 (dalam bahasa Inggris): The JavaScript Object Notation (JSON) Data Interchange Format
- yaml (dalam bahasa Inggris): pustaka YAML JavaScript yang dipakai alat ini
Angka dan teks terakhir diperiksa pada Selasa, 10 November 2026.