محول JSON إلى TypeScript

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

يقوم هذا المحول بهذا العمل نيابة عنك. الصق أي كائن أو مصفوفة JSON، وسيتجول في البنية بشكل متكرر: الكائن المتداخل يصبح واجهة مسماة خاصة به، ومصفوفة الكائنات تحصل على واجهة عنصر مع مقارنة الحقول عبر كل عنصر في تلك المصفوفة — الحقل الموجود فقط في بعضها يُوسم بعلامة ? زائدة، والحقل الذي يكون null أحيانًا وقيمة أحيانًا يظهر كاتحاد string | null سليم بدلاً من أحدهما.

مبدل الصيغة يغير فقط كيفية طباعة نفس البنية المستنتجة: كتلة interface أو اسم نوع مستعار أو مخطط Zod مبني من استدعاءات z.object() و z.array() و z.union() مع .optional() و .nullable() حيث تنطبق. Zod نفسها حزمة npm منفصلة (npm install zod) — هذه الأداة تكتب فقط كود المخطط المصدر، ولا تثبت أي شيء لك.

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