المحولات

محول YAML ↔ JSON

حول بين YAML و JSON في أي اتجاه فورًا. مبني على js-yaml لدعم مواصفات YAML 1.2 بالكامل بما في ذلك المراسم (anchors)، والإشارات (aliases)، والسلاسل متعددة الأسطر، والهياكل المتداخلة المعقدة. ضروري لأعمال DevOps مع مخططات Kubernetes، وسير عمل GitHub Actions، ومواصفات OpenAPI، وملفات Docker Compose.

JavaScript مطلوب

هذه الأداة تتطلب JavaScript للعمل. يرجى تفعيل JavaScript في إعدادات متصفحك لاستخدام محول YAML ↔ JSON.

لماذا JavaScript؟ هذه الأداة تعالج ملفاتك بالكامل في متصفحك باستخدام WebAssembly — لا شيء يُرفع إلى الخوادم. هذا النهج الذي يركز على الخصوصية يتطلب تفعيل JavaScript.

ماذا تفعل هذه الأداة؟

يوفر محول YAML-JSON ترجمة ثنائية الاتجاه بين صيغتين شائعتين لتسلسل البيانات. ينتج JSON إلى YAML ملف YAML نظيف وقابل للقراءة مع الاقتباس المناسب وأنماط الكتل. يتعامل YAML إلى JSON مع مواصفات YAML 1.2 بالكامل بما في ذلك الميزات المتقدمة مثل المراسم (&) والإشارات (*), ومفاتيح الدمج (<<), وأنماط السلاسل متعددة الأسطر (المحرف | الحرفي و > المطوي), وعلامات الأنواع المعقدة. يقوم الأداة بتحقق من التركيب أثناء الكتابة، مع الإبلاغ عن معلومات الصف والعمود للأخطاء.

كيف تعمل

تستخدم الأداة مكتبة js-yaml المصممة للاستخدام في المتصفح. بالنسبة لـ YAML إلى JSON: يقوم js-yaml بتحليل مستند YAML إلى كائنات JavaScript، مع معالجة جميع الميزات المحددة لـ YAML (حل المراسم إلى القيم المرجعية، وتوسيع الإشارات). ثم يقوم JSON.stringify بتسلسلها إلى JSON مع تحديد مسافة قابلة للتكوين. بالنسبة لـ JSON إلى YAML: يقوم JSON.parse بالتحويل إلى كائنات، ثم يقوم js-yaml.dump بتوليد YAML بتنسيق ذكي (يقرر بين أنماط التدفق والكتل، مع التعامل مع الاقتباسات بشكل مناسب). يتم تحويل ملفات YAML متعددة المستندات (المفصولة بـ ---) إلى مصفوفات JSON.

الميزات

ثنائي الاتجاه: YAML → JSON و JSON → YAML
دعم كامل لـ YAML 1.2 عبر js-yaml
مسافة قابلة للتكوين لـ JSON (2/4/8 مسافة)
يتحقق ويعرض أخطاء التحليل مع الصف والعمود
يتعامل مع المراسم، والإشارات، ومفاتيح الدمج
YAML متعدد المستندات إلى مصفوفة JSON
تحويل مباشر أثناء الكتابة

كيفية الاستخدام

1

اختر الاتجاه

اختر YAML → JSON لتحليل YAML إلى JSON، أو JSON → YAML للتحويل العكسي.
2

الصق مدخلاتك

أدخل YAML أو JSON صالح. يتم تحديث المخرجات فورًا أثناء الكتابة، أو استخدم زر التحويل للمدخلات الكبيرة.
3

ضبط تنسيق المخرجات

لـ JSON، اختر المسافة (2 مسافة هي المعيار). لـ YAML، يتم تحسين التنسيق تلقائيًا.
4

راجع وانسخ

راجع المخرجات المحولة. إذا كانت هناك أخطاء في التركيب، تشير رسالة الخطأ إلى الصف والعمود للإصلاح.

حالات الاستخدام الشائعة

تكوين Kubernetes

حول بين مخططات YAML و JSON لتفاعلات API، أو التصحيح، أو الأدوات التي تتطلب صيغًا محددة.

تحرير خطوط أنابيب CI/CD

تستخدم أنظمة GitHub Actions و GitLab CI وغيرها YAML. حول إلى JSON للتلاعب البرمجي، ثم أعد التحويل إلى YAML للتحرير.

أعمال مواصفات OpenAPI

يمكن أن تكون مواصفات OpenAPI بصيغة YAML أو JSON. حول بين الصيغ بناءً على متطلبات الأدوات أو تفضيلات الفريق.

إدارة التكوين

حول ملفات التكوين بين الصيغ لبيئات النشر المختلفة أو أنظمة الأدوات.

نصائح وأفضل الممارسات

YAML هي مجموعة فرعية من JSON — أي JSON صالح هو YAML صالح. العكس ليس صحيحًا (لـ YAML العديد من الميزات التي يفتقر إليها JSON)
تعليقات YAML (الأسطر التي تبدأ بـ #) تُفقد عند التحويل إلى JSON — JSON لا يحتوي على تراكيب للتعليقات
YAML متعدد المستندات (المفصول بـ ---) يصبح مصفوفة JSON عند التحويل
يتم حل المراسم والإشارات في YAML (توسيعها) في مخرجات JSON — يتم تسطيح هيكل المرجع

الأسئلة المتكررة

هل يحفظ تعليقات YAML؟

لا — يتم إزالة التعليقات أثناء التحويل. بما أن JSON لا يحتوي على تراكيب للتعليقات، فلا يمكن تمثيلها. خطط لإعادة إضافة التعليقات إذا قمت بالتحويل مرة أخرى إلى YAML.

هل يتعامل مع YAML متعدد المستندات في Kubernetes؟

نعم — يتم إصدار المستندات المفصولة بـ --- كـ JSON array من الكائنات. هذا هو الاتفاقية القياسية للتعامل مع YAML متعدد المستندات في JSON.

هل يتم الحفاظ على أنواع YAML المعقدة؟

يتم تحويل أنواع YAML المحددة (التواريخ، العلامات المخصصة) إلى أقرب تمثيلاتها في JSON (سلاسل، أرقام). لا يتم الحفاظ على معلومات النوع الدلالي في JSON.

لماذا فشل YAML في التحليل؟

أخطاء YAML الشائعة: مسافة غير متسقة (المسافات فقط، لا توجد tabs)، اقتباسات غير مغلقة، تسلسلات هروب غير صالحة، نقطتان في غير مكانهما. تظهر رسالة الخطأ الصف والعمود.