طريقة الاستخدام
- الصق JSON على اليسار، أو انقر «تحميل مثال».
- يظهر TOML أثناء الكتابة. إذا كان JSON غير صالح، يُظهر الخطأ السطر الذي يفشل فيه.
- انسخ TOML أو نزّله، أو انقر «عكس الاتجاه» لتحويل TOML إلى JSON مجددًا.
شرح الخيارات
- القيم الفارغة (null)
- لا يملك TOML قيمة null. تُحذَف المفاتيح وعناصر المصفوفات التي تساوي null، ويسرد تعليق في السطر الأول المسارات المحذوفة.
- جذر غير كائن
- يجب أن يكون مستند TOML جدولًا في المستوى الأعلى. إذا كان جذر JSON مصفوفة أو قيمة مفردة، يوضع تحت مفتاح items ويذكر تعليق ذلك.
- الجداول ومصفوفات الجداول
- تُكتب الكائنات المتداخلة كجداول [a.b]، والمصفوفات التي كل عناصرها كائنات كمصفوفات جداول [[a]]، والمصفوفات الأخرى بشكل مضمّن.
مثال
JSON:
{"server":{"host":"0.0.0.0","port":8080},"databases":[{"name":"main","url":"postgres://db:5432/app"}]}
TOML:
[server]
host = "0.0.0.0"
port = 8080
[[databases]]
name = "main"
url = "postgres://db:5432/app"
الأسئلة الشائعة
ما الفرق بين TOML وJSON؟
TOML صيغة إعدادات مخصصة للكتابة اليدوية. لها تعليقات وأقسام وقيم تاريخ ووقت، وتستخدمها Cargo وpyproject وHugo وNetlify وغيرها. JSON أفضل لتبادل البيانات بين البرامج ولا يحتوي تعليقات.
لماذا أصبح 1.0 هو 1؟
بمجرد تحليل JSON في JavaScript، يصبح 1 و1.0 الرقم نفسه، لذا يُكتب كعدد صحيح. إذا كان يجب أن يكون حقل ما عددًا عشريًا، غيّره إلى 1.0 في TOML.
هل يحافظ على ترتيب المفاتيح؟
تحافظ أزواج المفتاح/القيمة العادية على ترتيبها في JSON. يتطلب TOML أن تأتي [الجداول] و[[مصفوفات الجداول]] بعد المفاتيح العادية، لذا تنتقل إلى النهاية.
هل تُرفع بياناتي؟
لا. يحدث التحليل والتحويل في متصفحك، وهذا مهم لملفات الإعدادات التي تحتوي رموزًا مميزة أو كلمات مرور.
الخصوصية
تعمل هذه الأداة بالكامل داخل متصفحك. تُعالَج ملفاتك ونصوصك على جهازك ولا تُرفع أبدًا إلى خوادمنا.