Apa itu Konverter JSON ke TOML?

Konverter JSON ke TOML mengubah data JSON (JavaScript Object Notation) ke format TOML (Tom's Obvious Minimal Language). Ini menangani objek, array, struktur bersarang, dan secara otomatis mendeteksi nilai datetime untuk menghasilkan output TOML yang bersih dan valid.

Kapan Anda Membutuhkan Ini?

Konfigurasi Proyek

Konversi file config JSON ke TOML untuk alat seperti Cargo (Rust), Hugo, atau pyproject.toml Python

Alur Kerja DevOps

Transformasi pengaturan JSON ke format TOML untuk konfigurasi deployment

Migrasi Data

Pindahkan data antar sistem yang menggunakan format konfigurasi berbeda

Belajar TOML

Lihat bagaimana struktur JSON yang familiar diterjemahkan ke sintaks TOML

Data Anda Tetap Pribadi

Pemrosesan 100% Sisi Klien: Semua konversi terjadi langsung di browser Anda. Data Anda tidak pernah meninggalkan perangkat, dan kami tidak mengumpulkan atau menyimpan data input apa pun.

Tanpa unggahan — Data Anda tidak pernah meninggalkan perangkat
Tanpa pelacakan — Kami tidak mengumpulkan atau menyimpan data input apa pun
Tanpa pemrosesan server — Semuanya berjalan secara lokal di browser Anda

Cara Menggunakan

Masukkan JSON Anda

Tempel atau ketik data JSON Anda ke dalam panel kiri. Anda juga dapat mengklik ikon unggah untuk memuat file JSON dari perangkat Anda.

Konversi Otomatis

Output TOML muncul secara otomatis di panel kanan saat Anda mengetik, dengan validasi real-time dan pemformatan.

Sesuaikan Opsi

Konfigurasikan pengaturan konversi seperti penanganan nilai null dan pemformatan tabel inline agar sesuai dengan kebutuhan Anda.

Ekspor Hasil

Salin output TOML ke clipboard Anda atau unduh sebagai file .toml untuk digunakan langsung di proyek Anda.

Opsi Konversi

Penanganan Nilai Null

Pilih cara menangani nilai null dalam JSON Anda:

Lewati — Hilangkan kunci null dari output sepenuhnya
String Kosong ("") — Konversi null ke string kosong

Tabel Inline

Pemformatan kompak untuk objek kecil:

Objek dengan ≤3 kunci primitif ditampilkan sebagai { key = "value" }
Menghasilkan output yang lebih dapat dibaca dan kompak

Unggah File

Klik ikon unggah di toolbar untuk memuat file JSON dari perangkat Anda. Konten file akan secara otomatis dimuat ke editor dan dikonversi ke format TOML secara instan.

Fitur Utama

Konversi Real-time

JSON dikonversi ke TOML saat Anda mengetik, dengan debouncing cerdas untuk mengoptimalkan kinerja. Perubahan pada opsi konversi memicu re-konversi instan, memberikan umpan balik langsung pada output Anda.

Pemetaan Struktur Cerdas

Konverter secara cerdas memetakan struktur JSON ke padanan TOML mereka dengan presisi:

Struktur JSON	Output TOML	Contoh
Objek	Tabel TOML dengan header `[table]`	`[database]`
Objek bersarang	Notasi jalur bertitik	`[server.config]`
Array objek	Sintaks array of tables	`[[products]]`
Array primitif	Array inline	`["a", "b", "c"]`
Primitif	Pemetaan nilai langsung	`port = 8080`

Penanganan Nilai Null

Keterbatasan TOML: TOML tidak secara native mendukung nilai null. Konverter ini menyediakan dua strategi untuk menangani keterbatasan ini secara efektif.

Strategi Lewati

Hilangkan Kunci Null

Kunci null tidak muncul di output
Pesan peringatan menunjukkan kunci yang dihilangkan
Output lebih bersih untuk field opsional

Strategi Konversi

Konversi String Kosong

Null menjadi ""
Mempertahankan semua kunci di output
Menjaga konsistensi struktur

Tabel Inline

Objek kecil dengan hingga 3 nilai primitif dapat ditampilkan sebagai tabel inline TOML alih-alih bagian tabel terpisah, menghasilkan output yang lebih kompak dan dapat dibaca.

Contoh Tabel Inline

# Without inline tables
[point]
x = 1
y = 2
z = 3

# With inline tables enabled
point = { x = 1, y = 2, z = 3 }

Deteksi Datetime

String yang cocok dengan pola tanggal, waktu, atau datetime RFC 3339 secara otomatis dikenali dan dikeluarkan sebagai nilai datetime TOML tanpa tanda kutip, memastikan penanganan tipe yang tepat.

Format tanggal: 2024-01-15
Format datetime: 2024-01-15T10:30:00Z
Format waktu: 10:30:00

Kutipan Kunci Cerdas

Kunci JSON yang berisi spasi, titik, atau karakter khusus secara otomatis dikutip dalam output TOML untuk validitas. Kunci alpanumerik sederhana menggunakan format bare untuk keterbacaan maksimal.

Contoh Kutipan Kunci

# Simple keys (no quotes needed)
name = "John"
age = 30

# Special keys (automatically quoted)
"user.name" = "John"
"first name" = "John"
"api-key" = "secret"

Bilah Status

Bilah status di bagian bawah memberikan umpan balik real-time tentang konversi Anda:

Status validasi — Menampilkan status Valid, Invalid, atau Ready
Jumlah kunci — Total jumlah kunci di output
Ukuran file — Ukuran output dalam byte untuk perencanaan unduhan

Pertanyaan yang Sering Diajukan

Mengapa saya tidak bisa mengkonversi array JSON sebagai root?

TOML memerlukan root berupa tabel (pasangan kunci-nilai). Array JSON di level root tidak memiliki padanan dalam spesifikasi TOML.

Solusi: Bungkus array Anda dalam objek terlebih dahulu. Contohnya:

Contoh Pembungkus Array

// Instead of: [1, 2, 3]
// Use:
{
  "items": [1, 2, 3]
}

Bagaimana nilai null ditangani?

TOML tidak memiliki tipe null. Anda dapat memilih antara dua strategi:

Lewati — Kunci null tidak akan muncul di output. Pesan peringatan menunjukkan kunci mana yang dihilangkan.
Konversi ke string kosong — Nilai null menjadi "", mempertahankan semua kunci di output.

Pilih strategi yang paling sesuai dengan kasus penggunaan Anda di opsi konversi.

Apa itu tabel inline?

Tabel inline adalah sintaks TOML yang kompak untuk objek kecil, ditampilkan dalam satu baris:

Format Tabel Inline

point = { x = 1, y = 2 }

Aktifkan opsi Tabel Inline untuk menggunakan format ini bagi objek dengan hingga 3 nilai primitif. Ini menghasilkan output yang lebih kompak dan dapat dibaca untuk struktur sederhana.

Bagaimana array objek dikonversi?

Array di mana setiap elemen adalah objek menjadi array of tables TOML menggunakan sintaks [[name]]:

Contoh Array of Tables

[[products]]
name = "Hammer"
price = 9.99

[[products]]
name = "Nail"
price = 0.05

Catatan: Array campuran (berisi objek dan primitif) diperlakukan sebagai array inline.

Apakah string datetime secara otomatis terdeteksi?

Ya. String yang cocok dengan pola RFC 3339 secara otomatis dikenali dan dikeluarkan sebagai datetime TOML bare tanpa tanda kutip:

2024-01-15 — Format tanggal
2024-01-15T10:30:00Z — Datetime dengan zona waktu
10:30:00 — Format waktu

Ini memastikan penanganan tipe yang tepat dan kompatibilitas dengan parser TOML.

Apakah ada batasan ukuran?

Karena semua pemrosesan terjadi di browser Anda, batas praktis tergantung pada memori perangkat Anda yang tersedia dan kekuatan pemrosesan.

Catatan Kinerja: Konverter menangani file JSON besar secara efisien, tetapi dataset yang sangat besar (beberapa MB) mungkin menyebabkan kinerja lebih lambat pada perangkat lama.

Untuk kinerja optimal, kami merekomendasikan file di bawah 5MB. File yang lebih besar masih akan berfungsi tetapi mungkin memerlukan waktu lebih lama untuk diproses.