Konverter TOML ke JSON

Apa Itu TOML dan Mengapa Mengonversi ke JSON?

// Convert TOML to JSON in Node.js using the smol-toml library
import { parse } from 'smol-toml';

const toml = `
[package]
name = "my-app"
version = "1.0.0"

[dependencies]
serde = { version = "1.0", features = ["derive"] }
`;

const data = parse(toml);
const json = JSON.stringify(data, null, 2);

console.log(json);
// {
//   "package": { "name": "my-app", "version": "1.0.0" },
//   "dependencies": {
//     "serde": { "version": "1.0", "features": ["derive"] }
//   }
// }

Fitur Utama

Contoh

[package]
name = "my-app"
version = "1.0.0"
edition = "2021"
authors = ["Jane Doe <jane@example.com>"]

[dependencies]
serde = { version = "1.0", features = ["derive"] }
tokio = { version = "1", features = ["full"] }

[dev-dependencies]
criterion = "0.5"

[[bin]]
name = "my-app"
path = "src/main.rs"

[build-system]
requires = ["hatchling"]
build-backend = "hatchling.build"

[project]
name = "my-package"
version = "0.3.1"
requires-python = ">=3.10"
dependencies = [
  "requests>=2.31",
  "pydantic>=2.0"
]

[project.optional-dependencies]
dev = ["pytest>=8.0", "ruff>=0.4"]

[tool.ruff]
line-length = 100

[build]
command = "npm run build"
publish = "dist"

[build.environment]
NODE_VERSION = "20"

[[redirects]]
from = "/old-path"
to = "/new-path"
status = 301
force = true

[[headers]]
for = "/*"

[headers.values]
X-Frame-Options = "DENY"

baseURL = "https://example.org"
languageCode = "en-us"
title = "My Hugo Site"
theme = "ananke"

[params]
description = "A static site built with Hugo"
mainSections = ["posts", "docs"]

[[menu.main]]
name = "Blog"
url = "/posts/"
weight = 1

[[menu.main]]
name = "About"
url = "/about/"
weight = 2

edition = "2021"
max_width = 100
hard_tabs = false
tab_spaces = 4
newline_style = "Unix"
use_small_heuristics = "Default"
reorder_imports = true
reorder_modules = true

title = "Deployment Log"
last_deployed = 1979-05-27T07:32:00Z
release_date = 1979-05-27
maintenance_window = 02:00:00

[[servers]]
name = "alpha"
ip = "10.0.0.1"
ports = [8001, 8002]

[[servers]]
name = "beta"
ip = "10.0.0.2"
ports = [9001]

Cara Menggunakan

1. 1

   Tempel TOML Anda

   Masukkan atau tempel TOML Anda ke bidang input di atas. Anda juga dapat mengeklik 'Muat contoh' untuk mencoba Cargo.toml, pyproject.toml, atau konfigurasi deployment nyata.

2. 2

   Lihat Output JSON Langsung

   JSON muncul instan di panel output. Sesuaikan opsi Indentasi (2 atau 4 spasi) agar cocok dengan format target Anda. Tanggal, tabel, dan larik tabel ditangani otomatis.

3. 3

   Salin atau Unduh

   Klik Salin untuk mengambil JSON ke papan klip Anda, atau Unduh untuk menyimpannya sebagai berkas .json yang siap untuk program, API, atau perkakas Anda.

Jebakan TOML Umum

name = my-app

name = "my-app"

name = "a"
name = "b"

name = "a"
alt_name = "b"

released = 2026-7-2

released = 2026-07-02

ports = [8001, 8002

ports = [8001, 8002]

snowflake = 1420070400000000000

snowflake = "1420070400000000000"

[servers]
name = "a"
[servers]
name = "b"

[[servers]]
name = "a"
[[servers]]
name = "b"

Kasus Penggunaan Umum

Metadata Cargo Rust

Konversi Cargo.toml ke JSON untuk membangun dasbor dependensi, mengaudit versi dan fitur crate, atau memasok data manifes ke skrip dan CI yang mengharapkan JSON alih-alih TOML.

Konfigurasi Proyek Python

Konversi pyproject.toml ke JSON untuk memeriksa metadata proyek PEP 621, mengekstrak daftar dependensi, atau menggerakkan perkakas yang membaca konfigurasi pemaketan secara programatis.

Inspeksi Konfigurasi Deployment

Konversi netlify.toml, foundry.toml, atau konfigurasi platform lain ke JSON untuk mengaudit pengalihan, header, dan pengaturan build, atau untuk menghasilkan konfigurasi setara untuk platform berbeda.

Migrasi Format Konfigurasi

Konversi konfigurasi aplikasi TOML ke JSON saat berpindah ke sistem yang lebih menyukai JSON, atau sebagai langkah antara sebelum transformasi lanjut dengan perkakas JSON seperti jq.

Pengaturan Situs Statis

Konversi config.toml Hugo ke JSON untuk memigrasikan pengaturan situs, membandingkan konfigurasi antar lingkungan, atau membangun UI pengaturan yang didukung JSON.

Input API dan Skrip

Ubah TOML yang ditulis manusia menjadi JSON yang dapat dikonsumsi langsung oleh REST API, fungsi serverless, atau skrip otomasi, menjembatani konfigurasi yang mudah dibaca dan input mesin.

Detail Teknis

Penguraian TOML 1.0.0 via smol-toml

TOML diuraikan dengan pustaka smol-toml, parser tanpa-dependensi yang sepenuhnya sesuai TOML 1.0.0. Ia menangani dengan benar tabel bersarang, kunci bertitik, tabel inline, larik tabel, string multi-baris, dan keempat tipe date-time, serta melaporkan kesalahan penguraian dengan posisi baris dan kolom.

Penanganan Date-Time Tanpa Kehilangan dan Bilangan Bulat Aman

Date-time TOML diserialisasi menjadi string JSON yang mempertahankan jenis persisnya (offset date-time, local date-time, tanggal lokal, waktu lokal). Bilangan bulat di luar rentang aman JavaScript (2^53 - 1) dipromosikan ke BigInt selama penguraian, lalu dikonversi ke angka JSON terdekat dengan peringatan presisi, jadi TOML valid tidak pernah gagal dikonversi.

100% Berbasis Browser — Tanpa Unggah, Tanpa Server

Semua pemrosesan terjadi di mesin JavaScript browser Anda. Tidak ada data yang dikirim kapan pun. Input lebih besar dari 200KB beralih dari mode langsung ke manual (klik Konversi eksplisit) untuk menjaga antarmuka tetap responsif.

Praktik Terbaik

Simpan Bilangan Bulat Sangat Besar sebagai String

Jika TOML Anda memiliki bilangan bulat di luar 2^53 - 1 (ID Snowflake, stempel waktu nanodetik, penghitung besar), kutip sebagai string sebelum mengonversi. Angka JSON di browser tidak dapat menampungnya secara persis, dan alat akan memperingatkan Anda saat harus membulatkan.

Utamakan Indentasi 2-Spasi untuk Output JSON

Indentasi dua spasi adalah konvensi yang paling banyak digunakan untuk JSON dan menghasilkan output bersih dan mudah dibaca yang cocok dengan sebagian besar pemformat dan alat diff. Simpan indentasi 4-spasi untuk saat panduan gaya menuntutnya.

Validasi Output JSON Sebelum Menggunakannya

Setelah mengonversi, jika Anda berencana menyunting JSON secara manual atau memasoknya ke tempat yang ketat, jalankan melalui Pemformat JSON kami untuk memastikan valid dan diformat konsisten.

Simpan Komentar TOML Secara Terpisah

JSON tidak memiliki sintaks komentar, jadi komentar # TOML dihilangkan saat konversi. Jika komentar adalah dokumentasi penting, simpan TOML asli di kontrol versi bersama JSON yang dihasilkan.

Gunakan Larik Tabel untuk Bagian Berulang

Saat Anda memiliki beberapa bagian serupa (servers, redirects, bins), tulis sebagai larik tabel ([[section]]) alih-alih mengulang [section]. Mereka dikonversi menjadi larik objek JSON yang bersih alih-alih menyebabkan kesalahan tabel-duplikat.

Pertanyaan yang Sering Diajukan