TOML เป็น JSON

ชนิดข้อมูลถูกจับคู่กันอย่างไร

เอาต์พุตถูกจัดรูปแบบด้วยการเยื้อง 4 ช่องว่างเสมอ อาร์เรย์และออบเจ็กต์จึงกินพื้นที่หลายบรรทัด ตารางด้านบนแสดงค่าในบรรทัดเดียวเพื่อให้อ่านง่าย ลำดับของคีย์ถูกคงไว้ตรงตามที่ปรากฏใน TOML ของคุณ

ตัวอย่างครบทุกขั้น

title = "My App"

[server]
host = "localhost"
port = 8080

[[users]]
name = "alice"
admin = true

จะถูกแปลงเป็น:

{
    "title": "My App",
    "server": {
        "host": "localhost",
        "port": 8080
    },
    "users": [
        {
            "name": "alice",
            "admin": true
        }
    ]
}

TOML ที่รองรับ และข้อจำกัดที่แท้จริง

รองรับ: ส่วนหัว [ตาราง] รวมถึงชื่อส่วนแบบมีจุด, [[อาร์เรย์ของตาราง]], คู่ key = value บรรทัดเดียว, สตริง basic "..." พร้อมอักขระหลีก \n, \t และ \", สตริง literal '...', จำนวนเต็มและทศนิยมฐานสิบแบบเรียบง่าย, true/false, อาร์เรย์บรรทัดเดียว (ซ้อนกันได้), ความคิดเห็น # ทั้งบรรทัด และวันที่ที่ส่งผ่านเป็นสตริง

ไม่รองรับ พร้อมวิธีแก้:

• สตริงหลายบรรทัด (""" หรือ ''') และอาร์เรย์หลายบรรทัดทำให้ตัวแยกวิเคราะห์หยุดพร้อมข้อผิดพลาด ให้รวบค่าไว้ในบรรทัดเดียวก่อน
• ตารางแบบอินไลน์ไม่ถูกขยาย: point = { x = 1, y = 2 } จะออกมาเป็นสตริง "{ x = 1, y = 2 }" ไม่ใช่ออบเจ็กต์ ให้เขียนใหม่เป็นส่วน [point] แยกต่างหาก บรรทัด dependency ใน Cargo.toml อย่าง serde = { version = "1.0" } คือกรณีคลาสสิก
• คีย์แบบมีจุดทางซ้ายของเครื่องหมายเท่ากับจะยังเป็นคีย์แบนหนึ่งตัว: server.host = "a" สร้างคีย์ "server.host" โดยไม่ซ้อนกัน ให้ใช้ส่วนหัว [server] แทน ส่วน [section.names] แบบมีจุดในส่วนหัวจะซ้อนกันอย่างถูกต้อง
• ความคิดเห็นหลังค่าไม่ถูกตัดออก: port = 8080 # main จะกลายเป็นสตริง "8080 # main" เก็บความคิดเห็นไว้ในบรรทัดของตัวเอง
• รูปแบบตัวเลขนอกเหนือจากฐานสิบแบบเรียบง่ายไม่ถูกรู้จัก: 1_000, 0xFF, 5e2, +99, inf และ nan จะออกมาเป็นสตริงในเครื่องหมายคำพูด ให้เขียนเป็น 1000, 255, 500, 99
• อักขระหลีก \uXXXX ในสตริง basic ไม่ถูกถอดรหัส ให้วางตัวอักษรจริงแทน

สำหรับเอกสาร TOML 1.0 ฉบับสมบูรณ์ ให้ใช้ตัวแปลงบรรทัดคำสั่งอย่าง toml2json หรือโหลดไฟล์ด้วย tomllib ของ Python แล้วส่งออก JSON จากตรงนั้น

เหมาะกับงานแบบไหน

• ตรวจสอบอย่างรวดเร็ว ชิ้นส่วน TOML ในรูป JSON ระหว่างดีบัก
• ส่งค่าการตั้งค่าง่าย ๆ ให้ linter สคริปต์ หรือเครื่องมือทำบัญชีทรัพยากรที่รับเฉพาะ JSON
• สร้าง fixture JSON สำหรับการทดสอบ จากโน้ต TOML ที่เขียนด้วยมือได้ง่ายกว่า
• ย้ายไฟล์การตั้งค่าขนาดเล็กและแบน ซึ่ง config.toml ของ Hugo จำนวนมากก็เป็นแบบนั้น

ข้อควรรู้เรื่องการแปลงไปกลับ

• ความคิดเห็นไม่มีวันรอด: JSON ไม่มีไวยากรณ์ความคิดเห็นเลย
• วันที่ยังคงเป็นสตริง: โค้ดปลายทางต้องแยกวิเคราะห์กลับเป็นออบเจ็กต์วันที่เอง
• ตัวเลขขนาดใหญ่: จำนวนเต็มถูกเก็บเป็นค่า 64 บิตในข้อความ JSON แต่ฝั่ง JavaScript จะสูญเสียความแม่นยำเมื่อเกิน 2^53 ระวังไทม์สแตมป์ระดับนาโนวินาทีและ ID ที่เป็นตัวเลข
• ลำดับคีย์ในตัวแปลงนี้คงไว้ตามที่เขียน เครื่องมือ JSON อื่นอาจเรียงคีย์ใหม่เมื่อเขียนเอกสารออกมาอีกครั้ง

ทิศทางย้อนกลับ

JSON → TOML คือเส้นทางที่ยากกว่า เพราะ JSON มีโครงสร้าง (การซ้อนแบบนิรนามลึก ๆ, null) ที่ TOML ไม่มีหรือจัดการต่างออกไป สถานการณ์แปลงไปกลับส่วนใหญ่ต้องปรับแต่งด้วยมือฝั่ง TOML