تخطَّ إلى المحتوى
ToolMug

محول JSON إلى TypeScript

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

يعمل في متصفحك — لا يُرفع أي شيء تُدخله

طريقة الاستخدام

  1. الصق نموذج JSON، أو انقر «تحميل مثال».
  2. اضبط اسم النوع الجذري.
  3. اختر واجهات أو أسماء أنواع.
  4. انسخ الأنواع المُولَّدة أو نزّلها.

شرح الخيارات

اسم النوع الجذري
اسم النوع في المستوى الأعلى، مثلًا User أو ApiResponse. تُسمَّى الأنواع المتداخلة حسب مفاتيحها — يصبح address هو Address، وعناصر posts تصبح Post.
استخدام type بدلًا من interface
يُنشئ أسماء أنواع (type User = { … }) بدلًا من واجهات. يعمل كلاهما بالطريقة نفسها للبيانات البسيطة.

أمثلة

يصبح {"id": 1, "tags": ["a"], "owner": {"name": "Ada"}}:

export interface Owner {
  name: string;
}

export interface Root {
  id: number;
  tags: string[];
  owner: Owner;
}

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

كيف تُعالَج مصفوفات الكائنات؟

تُدمَج كل العناصر في نوع واحد. يصبح المفتاح الموجود في بعض العناصر فقط اختياريًا (key?)، وتصبح القيمة التي تكون أحيانًا null اتحادًا مثل string | null.

لماذا يُصنَّف حقل ما بنوع unknown؟

احتوى النموذج فقط على null له، لذا لا يمكن استنتاج نوعه الحقيقي. استبدل unknown بالنوع الصحيح، أو الصق نموذجًا يحتوي فيه الحقل على قيمة.

هل الأعداد الصحيحة والعشرية أنواع مختلفة؟

لا في TypeScript — يصبح كلاهما number. تميّز مخرجات Go وRust وPython بينهما.

هل يُرفع JSON الخاص بي؟

لا. تُولَّد الأنواع في متصفحك، لذا تبقى استجابات API ببيانات حقيقية على جهازك.

الخصوصية

تعمل هذه الأداة بالكامل داخل متصفحك. تُعالَج ملفاتك ونصوصك على جهازك ولا تُرفع أبدًا إلى خوادمنا.

أدوات ذات صلة