JSON Schema: من الأساسيات إلى الإنتاج
الكلمات المفتاحية كثيرة، لكن لا يُستخدم منها يوميًا إلا نحو دزينة. أتقن type/properties/required/$ref، وأحسِن رسائل الخطأ، فستغطي ثمانين بالمئة من الحالات الحقيقية.
متوسطقراءة نحو 14 دقيقةحُدِّث في 2026-10-30
المخطط والتحقق
صِف شكل بياناتك بـ JSON Schema، وحوّل الاتفاقات اللفظية إلى تحقق قابل للتنفيذ، ودعها تقود أنواع TypeScript وتوليد النماذج بدورها.
7 مقالةمقالات هذه الفئة
مزامنة ثنائية الاتجاه بين المخطط وأنواع TypeScript
الأنواع والمخططات يغطي كل منهما مقطعًا واحدًا: أحدهما وقت الترجمة والآخر وقت التشغيل. السؤال ليس أيّهما تختار، بل كيف تُبقي الاثنين متزامنين تلقائيًا.
متوسطقراءة نحو 11 دقيقةحُدِّث في 2026-10-30
لماذا يظل JSON Schema المولّد تلقائيًا يرفض البيانات الحقيقية
المخططات المولّدة كثيرًا ما تمنع بيانات صالحة. تعلّم لماذا تنتج العينات الأغنى مخططات أسوأ، ثم سير العمل: أخذ عينات متعددة السجلات، والاستكمال الدلالي، وتحديد الأخطاء بدقة.
متوسطقراءة نحو 14 دقيقةحُدِّث في 2026-10-30
إعادة استخدام JSON Schema: $ref و$defs وتركيب allOf/oneOf
$ref يحل إعادة الاستخدام، وallOf وoneOf يحلان التركيب، وتكديس الاثنين معًا هو حيث تنكسر الأمور. يغطي المقال $id و$defs والشرطيات والعودية والجمع والتصحيح.
متوسطقراءة نحو 11 دقيقةحُدِّث في 2026-10-31
عندما تصبح أخطاء JSON Schema بلا معنى: تحديد موقع أخطاء Ajv وحوكمة الرسائل
يصدر المدقق أخطاءً آلية، بينما يريد المستخدم معرفة أي مربع إدخال هو الخطأ. يغطي المقال مصفوفة أخطاء Ajv، وinstancePath مقابل schemaPath، والتجميع وصياغة النص.
متقدمقراءة نحو 10 دقيقةحُدِّث في 2026-10-31
بدون additionalProperties، لا يتحقق تحقق المخطط من أي شيء
اجتياز التحقق لا يعني بيانات نظيفة. Pydantic يتجاهل الحقول غير المعروفة افتراضيًا، وZod يزيلها، وAjv يمررها — المعاملات المتخيلة والمفاتيح المكتوبة خطأً تعبر بصمت. يعرض هذا المقال ثلاث صور للقبول الصامت ويقدم طرقًا كاملة: إغلاق الكائنات، والتحكم في تحويل الأنواع، وشد كل مستوى تداخل.
Intermediateقراءة نحو 8 دقيقةحُدِّث في 2026-11-02
اختبارات العقود مع JSON Schema: لحام قواعد التحقق في CI
المخطط لا ينتهي عندما يُكتب — هناك يبدأ التدهور. خطأ مطبعي واحد يُرخي التحقق بصمت، وإعادة هيكلة واحدة تكسر جميع العينات. يشرح هذا الدليل منظومة اختبارات عقود قابلة للتنفيذ: عينات إيجابية وسلبية ولقطات حالة، وفحص lint للمخطط نفسه، وتجميع لمرة واحدة مع إعادة استخدام، وأربع بوابات CI تحوّل التغييرات الكاسرة للعقود إلى بنيات حمراء.
متوسطقراءة نحو 8 دقيقةحُدِّث في 2026-11-05