الصق تعريفات interface أو أسماء type البديلة أو enum أو الأصناف في TypeScript لتحصل على مستند JSON نموذجي يحققها. تُتتبَّع الاتحادات الحرفية وRecord وأنواع الأدوات مثل Pick وOmit وPartial والـ interfaces المتسلسلة بـ extends وتُملأ كلها.
استخدمه قبل وجود الـ API لتجهيز بيانات وهمية لـ MSW أو json-server، أو لإنشاء props في Storybook، أو لتُري فريق الخلفية بالضبط الشكل الذي تريد أن يرسلوه.
types.ts. يمكن أن تختلط بها export وimport وتعريفات الدوال؛ فلا تُقرأ إلا تعريفات الأنواع.enums حتى تُملأ. أسماء الأنواع الغائبة عن الإدخال تصبح null.type UserPage = Page<User>، يُفضَّل على تعريف النوع العام نفسه.HttpResponse.json(...) في handler لـ MSW أو إلى بيانات اختبار ثابتة أو إلى args في Storybook، ثم عدّل القيم.type Channel = "email" | "sms" | "push";
enum Priority { Low = "low", High = "high" }
interface Notification {
id: string;
channel: Channel;
priority: Priority;
recipient: { userId: number; locale?: string };
payload: Record<string, string>;
readAt: Date | null;
meta: Pick<Audit, "createdBy">;
}
interface Audit { createdBy: string; createdAt: Date }{
"id": "",
"channel": "email",
"priority": "low",
"recipient": {
"userId": 0,
"locale": ""
},
"payload": {
"key": ""
},
"readAt": "1970-01-01T00:00:00.000Z",
"meta": {
"createdBy": ""
}
}Channel اتحاد حرفي نصي، فيأخذ قيمته الأولى "email"؛ ويأخذ الـ enum النصي Priority قيمة عضوه الأول "low". يصبح Record<string, string> كائنًا بمفتاح واحد "key"، ويُحلّ Date | null إلى الجانب غير null كسلسلة ISO، ويُبقي Pick<Audit, "createdBy"> المفتاح المختار فقط. والحقل الاختياري locale? مضمَّن أيضًا.
string → ""، وnumber/bigint → 0، وboolean → false، وany/unknown → null، وDate → 1970-01-01T00:00:00.000Z (صيغة Date.toJSON()).null/undefined، والتقاطعات (A & B) وinterface ... extends تدمج الخصائص.enum قيمة عضوه الأول، أو 0 للـ enum الرقمي دون قيم ابتدائية.Array<T> وSet<T> تحصل على عنصر نموذجي واحد؛ والـ tuples تحصل على قيمة لكل موضع؛ وRecord<K, V> وMap وتوقيعات الفهرسة تصبح {"key": V}.Partial وRequired وReadonly وNonNullable وPick وOmit.static ودوال الوصول get/set وحقول @Exclude().children: TreeNode[]) تُقطع كمصفوفات فارغة.قبل أن تجهز الخلفية، ولّد بيانات وهمية من أنواع استجابات الـ API. يمكن بناء الواجهة أولًا، والانتقال لاحقًا إلى الـ API الحقيقي يُبقي الأنواع نفسها.
أنشئ كائنًا افتراضيًا من نوع props المكوّن لـ args في القصص أو لبيانات العرض في React Testing Library. كل خاصية مطلوبة موجودة، فلا أخطاء أنواع تطاردها.
حوّل نوع طلب من الواجهة الأمامية إلى JSON والصقه في وثيقة تصميم الـ API أو في issue، فيستطيع مطورو الخلفية الذين لا يستخدمون TypeScript قراءة البنية فورًا.
?) مضمَّنة دائمًا؛ احذف المفاتيح بنفسك لاختبار الاستجابات التي تغيب فيها.type UserPage = Page<User> يُملأ items: T[] بـ User، وتُطبَّق القيم الافتراضية مثل <T = string> حين لا يُعطى معامل. أما الأنواع الشرطية داخل الأنواع العامة فما زالت لا تُقيَّم.T["key"] ولا الأنواع الشرطية ولا أنواع template literal.name = "kim"، retries = 3) يستخدم تلك القيمة؛ أما القيم الابتدائية الأخرى مثل new Date() فلا تفيد إلا في تلميح النوع.z.infer كـ interface عادية.Map وSet ككائن ومصفوفة، لكن JSON.stringify يحوّل كليهما إلى {}، فالأفضل استخدام Record أو المصفوفات في أنواع الاستجابات.Date يخرج كسلسلة نصية؟نعم. يستبدل JSON.stringify الـ Date بنتيجة toJSON() الخاصة به، وهي سلسلة ISO 8601. والجانب المستقبِل يحصل على سلسلة نصية على أي حال، فإما أن تحدد نوعها بـ string أو أن تحلّلها.
status: "active" | "inactive"؟أول قيمة حرفية بترتيب التعريف، "active". أعد ترتيب الاتحاد إن كنت تفضّل إظهار قيمة أخرى.
تُحلَّل تعريفات الأصناف والـ decorators، فتتحول كائنات DTO المعلَّمة بـ decorators من class-validator بلا مشكلة، وتُستبعد حقول @Exclude() من class-transformer.
استخدم صفحة JSON → TypeScript للاتجاه المعاكس. وتولّد صفحات منفصلة أيضًا JSON من نماذج TypeORM وSequelize وMongoose.