ما الذي تفعله هذه الأداة
تحوّل JSON إلى YAML و YAML عودةً إلى JSON داخل متصفحك. وثائق YAML المتعدّدة مدعومة عند الإدخال (تصبح كل كتلة --- عنصراً في مصفوفة JSON)، ويُبلّغ المحلّل عن الأخطاء بسطر وعمود محدّدين كي تجد الإزاحة المكسورة بسرعة.
متى تستخدمها
- ترجمة بيان Helm أو Kubernetes مكتوب بـ YAML إلى JSON لأداة أخرى.
- ترتيب ملف إعدادات حين لا تتذكر هل المسافة البادئة مسافتان أم أربع.
- لصق مواصفة OpenAPI من YAML لتمريرها إلى مدقّق يدعم JSON فقط.
- اكتشاف تغيّر غير مقصود بين أسلوب التدفّق وأسلوب الكتل.
كيف تعمل
يستخدم التحليل مكتبة yaml الشهيرة المُترجمة داخل حزمة الصفحة. الإخراج يستخدم أسلوب الكتل بمسافتين بادئتين لـ YAML و JSON.stringify(value, null, 2) لـ JSON. يحفظ الاتجاهان البنى المتشعّبة والمصفوفات والقيم البسيطة — وإن كانت بعض الحالات الحدّية (المراسي والأسماء البديلة، والوسوم المخصّصة) تُسطَّح إلى قيمها المحلولة.
ملاحظات
قِيَمي المنطقية تحوّلت إلى نصوص. كان YAML 1.1 يعامل yes و no و on و off قيماً منطقية، وقد عُرف ذلك بكسره لرموز الدول النرويجية (NO). ضيّق YAML 1.2 القيم المنطقية إلى true/false فقط. تتبع هذه الأداة 1.2 — اقتبس القيم غير المعتادة إذا قصدت نصاً.
هل يحفظ التعليقات؟ لا. تُجرَّد التعليقات أثناء التحليل لأن JSON لا يحتمل وضعها. إن كان حفظ التعليقات يهمّك فعدّل YAML مباشرةً بدلاً من جولة العبور خلال JSON.
هل المراسي والأسماء البديلة مدعومة؟ نعم عند الإدخال (تُحلّ إلى عقد مكرّرة). أمّا الانتقال من JSON إلى YAML فلا يُعيد تقديم المراسي؛ الإخراج موسَّع بالكامل.
أدوات ذات صلة
- منسّق JSON — نظّف قبل/بعد التحويل
- مدقّق JSON Schema — تحقّق من JSON المحوَّل
- مدقّق الفروقات — قارن وثيقتين محوَّلتين