محوّل JSON إلى كود

ما هي محوّل JSON إلى كود؟

JSON إلى كود هو مولّد أنواع مجاني يعمل بالكامل داخل المتصفح، يقرأ عيّنة JSON ويكتب نموذج البيانات المطابق باللغة التي تختارها. اختر هدفاً من قائمة تحويل إلى — واجهة TypeScript، هيكل Go، هيكل serde في Rust، مخطط Zod، أو JSON Schema — وحدّد اسم النوع الجذري لتسمية النوع ذي المستوى الأعلى. يجتاز محرّك الاستنتاج ملف JSON: تُربَط السلاسل والأرقام والقيم المنطقية و null بالأنواع الأصلية، وتُرفع الكائنات المتداخلة إلى أنواع مُسمّاة خاصة بها، وتتبنى المصفوفات نوع عنصرها، وتصبح المفاتيح المفقودة من بعض عناصر المصفوفة اختيارية. يستخدمه مطورو الواجهة الأمامية والخلفية لبناء كائنات نقل البيانات (DTO) من استجابات الـ API، وصياغة مخططات التحقق، وإبقاء أنواع العميل والخادم متزامنة دون كتابة الكود المتكرر يدوياً.

كيفية استخدام محوّل JSON إلى كود

1. الصق أو اكتب عيّنة JSON تمثيلية في صندوق الإدخال، أو انقر على عيّنة لتحميل مثال.
2. افتح الإعدادات واختر هدفاً ضمن تحويل إلى: TypeScript أو Go أو Rust أو Zod أو JSON Schema.
3. حدّد اسم النوع الجذري للتحكم في اسم الواجهة أو الهيكل أو المخطط ذي المستوى الأعلى.
4. اقرأ الكود المُولَّد في لوحة الإخراج؛ فهو يتحدّث تلقائياً كلما حرّرت JSON أو غيّرت الخيارات.
5. تحقّق من إحصائية الأنواع لمعرفة عدد الأنواع المُسمّاة المُستنتَجة، ثم انقر على نسخ للحصول على النتيجة.

أمثلة

{ "id": 1, "name": "Ada", "active": true }

export interface Root {
  id: number;
  name: string;
  active: boolean;
}

{ "user": { "age": 30 } }

type User struct {
	Age float64 `json:"age"`
}

type Root struct {
	User User `json:"user"`
}

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

هل يُرفع ملف JSON الخاص بي إلى أي مكان؟

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

ما الأهداف المدعومة؟

واجهات TypeScript، وهياكل Go (بوسوم json و omitempty للحقول الاختيارية)، وهياكل serde في Rust (بمشتقات Serialize/Deserialize و rename عند إعادة تسمية حقل)، ومخططات Zod، و JSON Schema بإصدار draft-07. لا تولّد الأداة إلا ما يمكنها استنتاجه بأمانة من عيّنتك.

كيف تُحدَّد الحقول الاختيارية؟

من عيّنتك. عندما تحتوي مصفوفة على كائنات ويكون أحد المفاتيح مفقوداً من بعضها، يُستنتَج ذلك المفتاح على أنه اختياري. فيما عدا ذلك، يُعامَل كل مفتاح موجود في العيّنة على أنه مطلوب.

وماذا عن الأرقام و null والأنواع المختلطة؟

تُربَط الأرقام بنوع الفاصلة العائمة الخاص باللغة (number، float64، f64)، ويُربَط null بنوع قابل للإبطال أو نوع قيمة حسب الهدف، وأي حقل يحمل أنواعاً مختلفة عبر العيّنات يرتدّ إلى نوع متساهل (unknown، interface{}، serde_json::Value) بدلاً من التخمين.

لماذا يكون الإخراج فارغاً أو يُظهر خطأ؟

يجب أن يكون الإدخال JSON صالحاً. إذا فشل التحليل، تُظهر الأداة الخطأ مع السطر والعمود عند توفّرهما؛ صحّح الموضع المُشار إليه وسيُعاد توليد الكود فوراً.