تحويل JSON إلى تعريفات أنواع
أداة تحويل JSON إلى تعريفات أنواع تحلل بيانات JSON التي تلصقها (استجابة من واجهة برمجية API مثلًا) وتستنتج بنيتها لتُنشئ تعريف نوع مكافئ جاهزًا للّصق: واجهة TypeScript (interface)، أو صنف بيانات Python (dataclass)، أو بنية Go (struct) — مع تمييز الحقول الاختيارية عندما تكون غائبة في بعض عناصر المصفوفة، والتفريق بين الأعداد الصحيحة والعشرية. بما أن الاستنتاج يعتمد على بيانات العيّنة فقط، راجع دائمًا النتيجة النهائية. تعمل الأداة بالكامل داخل متصفحك؛ بيانات JSON التي تلصقها لا تُرسل لأي خادم.
كل شيء يحدث داخل متصفحك — بيانات JSON التي تلصقها لا تُرسل لأي مكان.
الأداة تستنتج الأنواع من بيانات عينة فعلية، لذا تحقّق من النتيجة دائمًا — حقل غائب في العينة لن يظهر في التعريف الناتج، وحقل رقمي دائمًا صحيح في العينة سيُعامل كعدد صحيح (int) لا عشري.
الصق JSON أعلاه لإنشاء تعريف أنواع مكافئ.
ما الذي تفعله هذه الأداة
تستنتج شكل البيانات من مثال JSON وتولّد منه تعريفات أنواع جاهزة للصق في شيفرتك.
متى تستخدمها
- تتكامل مع واجهة برمجية بلا توثيق أنواع، ولديك استجابة حقيقية منها.
- تريد أنواعًا لبنية بيانات دون كتابتها حقلًا حقلًا.
- تنقل بيانات غير مكتوبة الأنواع إلى شيفرة تتحقق من الأنواع.
طريقة الاستخدام
- الصق مثال JSON في حقل المدخل.
- اقرأ تعريفات الأنواع المولَّدة.
- انسخها إلى مشروعك.
مثال عملي
المُدخَل
استجابة فيها كائن user ومصفوفة orders.
الناتج
تعريفات أنواع للكائن الرئيسي ولـuser ولعنصر orders، مع أنواع الحقول مستنتجة من قيمها.
حدود الأداة
- الاستنتاج من مثال واحد: الحقل الذي قيمته null في المثال لا يمكن معرفة نوعه الحقيقي، والحقل الاختياري الغائب لن يظهر أصلًا.
- تسمية أنواع عناصر المصفوفات تعتمد على قاعدة بسيطة تحذف السين الأخيرة من الاسم الإنجليزي، وهي كافية لأسماء مثل items وusers لا محلّل لغوي حقيقي — راجع الأسماء المولَّدة.
- راجع الناتج قبل اعتماده؛ هو نقطة انطلاق جيدة لا عقد موثّق.
الخصوصية والمعالجة
كل شيء يجري في متصفحك — JSON الذي تلصقه لا يُرسل إلى أي مكان.
ملاحظات تقنية
- الاستنتاج يمشي في بنية البيانات فقط ولا ينفّذ أي شيء مما بداخلها.
- الشكل المستنتج منفصل عن توليد الشيفرة، فإضافة لغة جديدة لا تمسّ منطق الاستنتاج.
الأسئلة الشائعة
التعريف يُستنتج من بيانات العيّنة التي تلصقها فقط. إذا كان حقل غائبًا في العيّنة، فلن يظهر في النتيجة، وإذا كان حقل رقمي دائمًا عددًا صحيحًا في العيّنة، فسيُعامل كعدد صحيح لا عشري — لذا يُنصح بمراجعة النتيجة دائمًا.