تخطي إلى المحتوى

JSON إلى TypeScript

يدعم JSON إلى TypeScript تحويل أمثلة JSON إلى واجهات TypeScript وأسماء نوعية بديلة، مع استنتاج الحقول الاختيارية وأنواع الاتحاد وبنية عناصر المصفوفة، وهو مناسب لنمذجة استجابات API وتهيئة الأنواع في الواجهة الأمامية وتنظيم بيانات الـ mock.

JSON

رمز

0 / 500,000

TypeScript

JSON إلى TypeScript

بداية سريعة

1
ألصق عينة JSON صالحة في المحرر الأيسر.
2
اختياري: عيّن اسم نوع جذري مخصص مثل ApiResponse قبل التوليد.
3
راجع التصاريح المُولدة على اليمين. جذور الكائنات تصبح interface، وجذور المصفوفات والقيم البدائية تصبح type alias.
4
استخدم النسخ أو التنزيل لإعادة استخدام ملف .ts المُولد داخل مشروعك.

سيناريوهات شائعة

حوّل استجابات API الحقيقية بسرعة إلى أنواع TypeScript جاهزة للاستخدام في صفحات الواجهة الأمامية أو عملاء SDK أو أثناء الربط مع الواجهة الخلفية.

قبل تثبيت العقد النهائي، استخدم عينات JSON لمراجعة استنتاج الحقول الاختيارية والقيم null وأنواع الاتحاد.

حوّل بيانات JSON التجريبية إلى تعريفات أنواع سريعة للـ fixtures أو قصص Storybook أو النماذج الأولية.

عندما تتغيّر بنية استجابة الخلفية، استخدم أحدث عينة JSON لمراجعة ما إذا كانت التصريحات المتداخلة مثل User وMeta تحتاج إلى تحديث.

نصائح الاستخدام

استخدم عينة JSON ممثلة قدر الإمكان. المولد يستنتج فقط من القيم التي تلصقها، لذلك الحالات غير الموجودة لن تظهر في الإخراج.
المصفوفات الفارغة تصبح unknown[]، والكائنات الفارغة تصبح interfaces تمتد من Record<string, unknown> حتى توفر بيانات أغنى.
تتم تسوية أسماء التصاريح المتداخلة من أسماء الخصائص، لذلك يفضل الإخراج الجديد أسماء مثل User أو Meta بدلاً من الصيغ القديمة ذات بادئة الجذر.
لا يعمل التوليد إلا مع JSON صالح. أصلح أخطاء الصياغة أولاً؛ يعرض المحرر السطر والعمود عند فشل التحليل.
أسماء الجذر المخصصة الصالحة تُحفظ كما هي، أما الأسماء غير الصالحة فتُسوّى إلى معرف PascalCase صالح في TypeScript.

القيود والتوافقية

هذه الأداة تستنتج الأنواع من بيانات نموذجية وليست من schema رسمي. لا يمكنها تخمين الحقول غير الموجودة في عينتك.
يجب أن يكون الإدخال JSON صارماً. التعليقات والفواصل اللاحقة وبقية صياغات JavaScript فقط غير مدعومة.
الإخراج المُولد لا يتضمن عبارات export. أضفها يدوياً إذا كان مشروعك يحتاج إلى تصاريح مُصدّرة.
النتيجة هي كود TypeScript ثابت فقط. لا يتم إنشاء مدققات runtime أو parsers أو serializers.

الخصوصية والأمان

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

أسئلة شائعة

6

تابع الخطوة التالية باستخدام هذه الأدوات ذات الصلة.