json إلى TypeScript

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

تعد كتابة استجابة API يدويًا أمرًا مملاً وعرضة للخطأ بطريقة محددة: تكتب ما تعتقده * ترجع نقطة النهاية، وليس ما ترجعه. يتم حذف الحقول التي لم تلاحظها مطلقًا، ويتم كتابة عدد صحيح يكون أحيانًا فارغًا كـ `number`، ويظهر الخطأ في وقت التشغيل في الإنتاج وليس في المحرر الخاص بك. يؤدي إنشاء الأنواع مباشرة من حمولة حقيقية إلى سد هذه الفجوة، لأن الشكل الذي تقوم بتجميعه مقابله هو الشكل الذي أرسله الخادم.

كل شيء يعمل في متصفحك. محرك الاستدلال هو TypeScript خالي من التبعية، وليس غلافًا حول خدمة عن بعد، لذا فإن الحمولات - التي تحمل بشكل روتيني رموز الوصول وسجلات العملاء والمعرفات الداخلية - لا تترك الصفحة أبدًا. اختر واجهات أو اكتب أسماء مستعارة، وقم بتبديل الكلمة الأساسية `export` وتعديل `readonly`، واختر عرض المسافة البادئة، ثم انسخ الإخراج أو قم بتنزيل ملف.ts.

هناك طريقة سريعة لمعرفة ما يمنحك إياه تحويل JSON إلى TypeScript وهي العينة المضمنة. اضغط على تحميل العينة، ثم قم بإنشاء. تحصل على ثلاث واجهات JSON إلى TypeScript: `Root` و`Owner` و`Release`. الإصدار الثاني لا يحتوي على مفتاح `notes`، لذا فإن واجهة `Release` fringnotes؟: string`، و ` `retiredAt` is null in the onest، لذا يصبح ` `At؟: null`. هذه هي النتيجة الصادقة، لأن قيمة فارغة واحدة لا تقدم أي دليل على النوع الحقيقي. لتحويل JSON إلى TypeScript للحصول على نقطة نهاية حقيقية، قم بلصق العديد من السجلات بحيث يكون للاستدلال المزيد للمقارنة.

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