إدخال YAML

مخرجات TypeScript

ما هو تحويل YAML إلى TypeScript؟

يستخدم TypeScript الواجهات والأنواع لتنظيم البنية. تُنشئ هذه الأداة واجهات TypeScript من YAML الخاص بك، مما يتيح لك كتابة الإعداد المُحلَّل أو البيانات بصورة صحيحة. تُعرّف مواصفات YAML 1.2 تنسيق الإدخال.

يعمل التحويل في المتصفح. لا يتم إرسال أي بيانات إلى خادم. تعمل الأنواع المُنشأة مع المُحلِّلات مثل js-yaml أو حزمة yaml. لتحويل JSON إلى TypeScript استخدم JSON إلى TypeScript.

أمثلة YAML إلى TypeScript

توليد واجهات TypeScript من YAML. مثال بموضوع الاتصالات:

مثال: سجل المشترك

إدخال YAML

مخرجات TypeScript:

مخرجات TypeScript

انقر على زر تحميل مثال أعلاه لتحميل المزيد من الأمثلة إلى المحرر.

كيفية استخدام هذه الأداة

1

الصق أو ارفع YAML

انسخ YAML الخاص بك والصقه في المحرر الأيسر. يمكنك أيضاً النقر على <strong>رفع الملف</strong> لتحميل ملف <code>.yaml</code> أو <code>.yml</code>. زر <strong>تحميل مثال</strong> يحمّل بيانات نموذجية. سيظهر خطأ إذا كان YAML غير صالح.

2

مراجعة مخرجات TypeScript

تعرض اللوحة اليمنى واجهات TypeScript المُولَّدة. استخدمها مع js-yaml أو حزمة yaml لتحليل الإعداد وكتابته بصورة صحيحة. عدّل الحقول الاختيارية باستخدام ? أو أنواع الاتحاد عند الحاجة.

3

نسخ أو تنزيل

استخدم <strong>نسخ</strong> أو <strong>تنزيل</strong>. لتحويل JSON إلى TypeScript استخدم JSON إلى TypeScript. لتنسيق YAML استخدم منسق YAML.

متى يفيد تحويل YAML إلى TypeScript

عند بناء تطبيقات Node.js أو واجهة أمامية تحمّل إعداد YAML (مثل <code>config.yml</code> أو مانيفستات Kubernetes أو سير عمل CI)، ستحتاج إلى هياكل بيانات مكتوبة للبيانات المُحلَّلة. الصق عيّنةً هنا وستحصل على واجهات TypeScript جاهزة للاستخدام مع js-yaml أو حزمة yaml. كتابة الأنواع يدوياً لـ YAML معقد ومتداخل مرهقة؛ هذه الأداة تستنتج البنية من العيّنة.

ملفات الإعداد مثل application.yml أو سير عمل GitHub Actions كثيراً ما تحتوي على تداخل عميق. تساعد الأنواع المُولَّدة على اكتشاف الأخطاء المطبعية وتوفر الإكمال التلقائي في بيئة التطوير المتكاملة. لاستخراج قيم محددة من YAML كبير، حوّله أولاً إلى JSON واستخدم jq.

الأسئلة الشائعة

كيف يتم تحليل YAML في TypeScript؟

استخدم حزمة js-yaml أو yaml. حلّل سلسلة YAML وخصّصها للنوع المُولَّد: const config = yaml.parse(str) as MyConfig. للتحقق من الصحة في وقت التشغيل، فكّر في استخدام Zod أو io-ts.

js-yaml مقابل حزمة yaml؟

js-yaml مستخدمة على نطاق واسع. حزمة yaml لها واجهة برمجة تطبيقات مختلفة وتعامل أفضل مع التعليقات. كلتاهما تعملان مع الأنواع المُولَّدة.

هل بياناتي خاصة؟

نعم. يعمل التوليد بالكامل في المتصفح. لا يتم إرسال أي YAML أو كود إلى خادم.

الحقول الاختيارية مقابل الإلزامية؟

يستنتج المولّد من العيّنة. أضف ? لخصائص الواجهة للحقول الاختيارية. للتحقق الصارم في وقت التشغيل استخدم Zod أو أدوات مماثلة مع الأنواع المُولَّدة كمرجع.

هل يعمل مع Angular أو React؟

نعم. تعمل الأنواع المُولَّدة في أي مشروع TypeScript. حمّل YAML في وقت البناء أو التشغيل واقطع على نوع الواجهة المُولَّد. لإعداد البيئة فكّر في تحميل YAML في خدمة إعداد.

الأدوات ذات الصلة

توثيق TypeScript. مواصفات YAML. js-yaml. مواصفات JSON. MDN.