Cara memakai
- Tempel objek JSON ke Objek JSON. Seluruh teks harus berupa satu objek, dengan kurung kurawal di bagian atas.
- Baca Pemeriksaan. Hijau berarti objek berhasil dikonversi; merah menyebut nama tempat masalah dan alasannya.
- Salin keluaran TOML ke dalam berkas, atau unduh sebagai config.toml.
Tata letak TOML
Nilai setiap tabel ditulis lebih dulu, dan sub-tabelnya datang sesudahnya. TOML memerlukan urutan itu, karena nilai sebuah tabel harus datang sebelum judul yang membuka sub-tabelnya. Nama mempertahankan urutan JSON.
- Objek di dalam objek menjadi tabel dengan judulnya sendiri, seperti [owner], dan nilainya mengikuti judul.
- Daftar objek menjadi larik tabel: satu bagian untuk setiap objek, dengan judulnya dalam kurung siku ganda.
- Daftar angka atau teks tetap dalam satu baris di dalam kurung siku, yang diizinkan TOML.
- Angka dengan titik atau eksponen ditulis sebagai float, sehingga 1.0 tetap 1.0. Angka tanpa keduanya ditulis sebagai bilangan bulat.
Yang tidak dapat dimuat TOML
- Null. TOML tidak memiliki null, jadi nama dengan null menghentikan konversi dan disebutkan dalam pesan. Hapus nama itu atau berikan nilai.
- Bilangan bulat di luar rentang 64-bit bertanda. JSON mengizinkan ukuran apa pun, tetapi TOML berhenti di 9223372036854775807.
- Tingkat teratas berupa daftar atau nilai tunggal. Dokumen TOML selalu berupa tabel, jadi JSON harus berupa objek.
Nama yang memerlukan tanda kutip
Nama yang hanya terdiri dari huruf, angka, garis bawah dan tanda hubung ditulis apa adanya. Nama lain, seperti yang memuat spasi atau titik, ditulis dalam tanda kutip ganda, dan begitu pula nama kosong. Tanda kutip, garis miring terbalik dan karakter kontrol dalam teks dilolos sebagaimana diwajibkan TOML.
Contoh: daftar, float dan objek
JSON di bawah memberi satu nilai dari setiap jenis yang ditulis alat. Setiap baris memberi nilai JSON dan baris TOML yang menjadinya.
| Nilai JSON | Baris TOML |
|---|---|
| "ports": [8000, 8001] | ports = [8000, 8001] |
| "ratio": 1.0 | ratio = 1.0 |
| "owner": {"name": "Ada"} | [owner], lalu name = "Ada" |
Pertanyaan yang sering diajukan
Mengapa nilai sebuah tabel datang sebelum sub-tabelnya?
TOML memerlukan nilai milik setiap tabel datang sebelum judul sub-tabelnya. Alat menulis nilai lebih dulu, sehingga berkas terbaca dengan benar dan tampak seperti yang akan ditulis orang dengan tangan.
Mengapa satu angka ditulis 1.0 dan yang lain 1?
Angka JSON dengan titik atau eksponen, seperti 1.0 atau 2e3, adalah float dalam TOML, dan angka tanpa keduanya adalah bilangan bulat. Alat mempertahankan perbedaan itu, sehingga float tidak pernah ditulis sebagai bilangan bulat.
Mengapa null menghentikan konversi?
TOML tidak memiliki nilai null, sehingga alat tidak dapat menuliskannya tanpa mengubah data. Hapus nama yang memuat null, atau berikan nilai seperti string kosong, lalu konversi lagi.
Apakah tanggal dalam JSON menjadi tanggal TOML?
Tidak. Tanggal dalam JSON adalah string, dan string tetap string, sehingga TOML menyimpan tanggal dalam tanda kutip. Ubah tanda kutipnya secara manual jika berkas TOML memerlukan nilai tanggal yang sebenarnya.
Apakah JSON yang saya tempel dikirim ke suatu tempat?
Tidak. Konversi berjalan di peramban Anda, dan tidak ada yang Anda tempel yang disimpan atau dikirim kepada kami. Meski begitu, jangan tempel kata sandi atau token ke halaman yang tidak Anda percaya.
Sumber
- TOML v1.0.0 specification (dalam bahasa Inggris)
- RFC 8259: The JavaScript Object Notation (JSON) Data Interchange Format (dalam bahasa Inggris)
Angka dan teks terakhir diperiksa pada Rabu, 11 November 2026.