المشكلة — الـ JSON ملوش عقد

الـ JSON بيقبل أي حاجة

الـ JSON مجرد نص. الـ JSON.parse بيتأكد إن الأقواس والفواصل مظبوطة وبس. مش بيسأل عن المعنى خالص:

• مفيش types متفق عليها: "30" و30 الاتنين JSON سليم، بس واحد string والتاني number.
• مفيش حقول إجبارية: {} JSON سليم برضه، حتى لو الكود مستني name وemail.
• مفيش منع لحقول زيادة: حد يبعتلك "isAdmin": true جوه الـ body، والـ parser هيقبله.
• مفيش حدود: اسم طوله ١٠ ميجا، أو qty: -5، أو array فيها مليون عنصر.

const body = JSON.parse('{"price": "100", "qty": 2}');console.log(body.price * body.qty); // 200 ← اشتغلت بالصدفةconsole.log(body.price + body.qty); // "1002" ← مصيبةconsole.log(body.discount.value);   // TypeError: Cannot read properties of undefined

طب والـ TypeScript؟

الـ TypeScript بيراجع الكود وقت الكتابة، وبعد الـ compile الـ types كلها بتتمسح. يعني:

interface Order {  price: number;  qty: number;}// الـ TS مصدّقك على كلمتك، ومش بيراجع حاجةconst order = JSON.parse(rawBody) as Order;order.price.toFixed(2); // لو price جت string ← TypeError وقت التشغيل

• الـ as Order كذبة مهذبة: إنت بتقول للـ compiler “صدقني”، وهو بيصدقك.
• الـ JSON.parse بيرجّع any: فالـ type safety بتقف عند أول بيانات جاية من بره.
• الـ types مش موجودة في الـ JavaScript النهائي: مفيش حاجة اسمها Order وقت التشغيل عشان تراجع عليها.

حدود الثقة (trust boundaries)

أي مكان البيانات بتدخل فيه سيستمك من مصدر إنت مش متحكم فيه 100% هو trust boundary. هنا لازم تراجع:

• الـ API requests: الـ body والـ query والـ headers. أي حد يقدر يبعت أي حاجة بـ curl.
• الـ webhooks: service تانية بتبعتلك events. ممكن تغيّر شكلها في version جديد من غير ما تاخد بالك.
• ملفات الـ config: يوزر بيكتب "port": "3000" أو بيغلط في اسم key.
• رسايل الـ queue: service قديمة لسه بتبعت الشكل القديم في Kafka أو RabbitMQ.
• ردود الـ LLM: الموديل ممكن يرجّع field ناقص أو type غلط حتى لو طلبت منه JSON.
• بيانات قديمة في الداتابيز: document في MongoDB اتكتب من سنتين بشكل مختلف.
• الـ localStorage والـ URL params: على الـ frontend، أي حاجة اليوزر يقدر يعدّلها.

Fail fast: ارفض عند الباب

لو البيانات الغلط عدّت من الباب، الغلط بيظهر بعيد عن سببه:

• ارفض بدري: الـ request يرجع 400 ومعاه رسالة بتقول /qty must be integer.
• الغلط قريب من سببه: اللي بعت الغلط هو اللي بيعرف على طول، مش إنت بعد أسبوع.
• الكود اللي جوه يبقى أبسط: مش محتاج if (typeof x === "number") في كل function، لأن الباب ضمنلك الشكل.

الحلول اللي قدامك

خلّصت الفصل لما

• تشرح ليه JSON.parse بينجح مع بيانات غلط
• تشرح ليه as Order مش validation
• تعدّ 5 أمثلة على trust boundaries
• تشرح فكرة fail fast وفايدتها
• تقارن بين if يدوي وZod والـ JSON Schema والـ Protobuf