JSON إلى TypeScript

النماذج المكتوبة من البيانات الحقيقية

قم بتحويل أي JSON إلى واجهات أو أنواع TypeScript على الفور، مع استنتاج الكائنات المتداخلة والمصفوفات والاتحادات والخصائص الاختيارية تلقائيًا.

تعد واجهات TypeScript المكتوبة يدويًا لمطابقة استجابة واجهة برمجة التطبيقات (API) مملة وعرضة للخطأ. قم بلصق حمولة JSON وستقوم هذه الأداة بتوجيه البنية، وإنشاء واجهة مطابقة (أو اسم مستعار للكتابة) مع الحقول المكتوبة بشكل صحيح، والواجهات المتداخلة للكائنات، وأنواع عناصر المصفوفة. تصبح المصفوفات المختلطة أنواعًا اتحادية، لذا تعكس نماذجك البيانات تمامًا.

سمات

إنشاء واجهات أو كتابة الأسماء المستعارة
يتعامل مع الكائنات والمصفوفات المتداخلة
يستنتج أنواع الاتحاد من صفائف مختلطة
الخصائص الاختيارية للقيم الخالية
اسم نوع الجذر المخصص
يتم تشغيله محليًا: لم يتم تحميل الكود مطلقًا

كيفية استخدام JSON إلى TypeScript

1
لصق جسون
قم بإسقاط كائن أو مجموعة من البيانات.
2
ضبط الخيارات
اختر الواجهة أو النوع، وقم بتسمية الجذر، ثم حدد القيم الفارغة اختياريًا.
3
مراجعة الأنواع
يتم إنشاء الواجهات المتداخلة تلقائيًا.
4
ينسخ
انسخ TypeScript إلى مشروعك.

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

اكتب استجابة API بسرعة
إنشاء نماذج من تركيبات JSON
إنشاء واجهات لملف التكوين
أنواع Bootstrap للتكامل الجديد

دليل مفصل

ضبط الإخراج لأسلوبك

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

كيف يتم استنتاج الأنواع

يقرأ المحول JSON الخاص بك ويعين كل قيمة إلى نوع TypeScript: تصبح السلاسل والأرقام والقيم المنطقية عبارة عن سلسلة، وعدد ومنطقي، وتصبح الكائنات المتداخلة واجهات مسماة خاصة بها، وتصبح المصفوفات صفائف مكتوبة. عندما يحتوي المصفوفة على أنواع مختلفة من القيم، تكون النتيجة اتحادًا مثل (سلسلة | رقم)[]. تصبح القيمة الخالية فارغة، لأن العينة لا يمكنها إظهار ما يحتوي عليه الحقل عند تعيينه. يتم اقتباس أسماء الخصائص التي لا تمثل معرفات صالحة، مثل "الاسم الأول"، بحيث يتم تجميع الإخراج دائمًا.

الحصول على أنواع دقيقة من بيانات العينة

الأنواع المستنتجة تكون جيدة مثل العينة فقط. إذا كان هناك حقل مفقود من بعض استجابات واجهة برمجة التطبيقات (API)، فقم بوضع علامة عليه كاختياري باستخدام ? بعد الإنشاء، وإذا كان من الممكن أن يكون الحقل فارغًا في الإنتاج، فقم بتوسيعه إلى سلسلة | باطل. استخدم الاستجابة الكاملة التي يمكنك العثور عليها، ومن الأفضل أن تكون تلك الاستجابة التي يوجد بها كل حقل اختياري. بالنسبة لواجهات برمجة التطبيقات التي لا تتحكم فيها، قم بإقران الأنواع التي تم إنشاؤها مع التحقق من صحة وقت التشغيل، على سبيل المثال Zod أو io-ts، لأن أنواع TypeScript تختفي في وقت التشغيل ولن تلتقط واجهة برمجة تطبيقات تم تغييرها. تصل التواريخ بتنسيق JSON كسلاسل، لذا قم بتحويلها بنفسك إذا كنت بحاجة إلى كائنات التاريخ.

الأسئلة المتداولة

كيف أقوم بتحويل JSON إلى واجهة TypeScript؟

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

هل يتعامل مع الكائنات والمصفوفات المتداخلة؟

نعم. تصبح الكائنات المتداخلة واجهات مسماة خاصة بها ويتم كتابة المصفوفات حسب عناصرها. المصفوفات ذات الأنواع المختلطة تنتج اتحادًا مثل (سلسلة | رقم)[].

هل يمكنني الحصول على أسماء مستعارة للكتابة بدلاً من الواجهات؟

نعم: قم بتبديل خيار إصدار الأسماء المستعارة "النوع" بدلاً من إعلانات "الواجهة"، وأعد تسمية النوع الجذر ليناسب مشروعك.

هل تم تحميل JSON الخاص بي في أي مكان؟

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

كيف أقوم بإنشاء واجهات TypeScript من JSON؟

الصق JSON الخاص بك (على سبيل المثال، استجابة API)، وقم بإعطاء الجذر اسمًا، وتستنتج الأداة الأنواع وتنتج واجهات جاهزة للاستخدام، بما في ذلك الكائنات والمصفوفات المتداخلة. يتم تشغيله محليًا، لذا تظل الحمولات الحقيقية خاصة.

هل يتعامل مع الكائنات المتداخلة والخصائص الاختيارية؟

نعم. تصبح الهياكل المتداخلة واجهات مسماة خاصة بها، وتحصل المصفوفات على أنواع العناصر، ويمكنك وضع علامة على الحقول اختيارية بحيث تتطابق الأنواع مع البيانات الحقيقية والمفقودة أحيانًا.

هل يمكنني إخراج اسم مستعار للنوع بدلاً من الواجهة؟

نعم. اختر الواجهة أو اكتب الإخراج وفقًا لنمط قاعدة التعليمات البرمجية الخاصة بك؛ كلاهما ينتج TypeScript دقيقًا من شكل JSON المستنتج.

النماذج المكتوبة من البيانات الحقيقية

سمات

كيفية استخدام JSON إلى TypeScript

لصق جسون

ضبط الخيارات

مراجعة الأنواع

ينسخ

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