التعابير النمطية (Regex) للمبتدئين

الخطوة 1. في نمط المطوّر [A-Z]{2}\d{9}[A-Z]{2} عيبان، واحد في كل اتجاه من قائمة أخطاء الدليل. فهو يطابق أكثر مما ينبغي لأنه بلا مراسٍ (Anchors): يقبل أي مدخل يحوي رقماً صالحاً في أي موضع منه، فتمر XRB123456789SAX وRB123456789SA123 وRB123456789SA متبوعة بمسافة. ويطابق أقل مما ينبغي لأن [A-Z] دون العلم i يرفض rb123456789sa، والمتطلب FR-21 يقول إن النموذج يجب أن يقبله. النمط المصحح: ^[A-Z]{2}\d{9}[A-Z]{2}$ مع العلم i، ويُكتب في JavaScript /^[A-Z]{2}\d{9}[A-Z]{2}$/i؛ ويكافئه ^[A-Za-z]{2}\d{9}[A-Za-z]{2}$ بلا أعلام. وتنبيه قبل الإبلاغ عن العيب الثاني: إن كان النموذج يحوّل المدخل إلى حروف كبيرة قبل تشغيل هذا الفحص فالحروف الصغيرة تمر أصلاً. هذا سؤال للمطوّر، والمدخل الاختباري rb123456789sa يحسمه في الحالتين.

الخطوة 2. يجب أن تطابق: RB123456789SA، وrb123456789sa (حالة الأحرف)، وCP987654321IN (بادئة ورمز دولة مختلفان). يجب ألا تطابق: RB12345678SA (8 أرقام) وRB1234567890SA (10 أرقام)، وهما طولا الحدّين؛ وRB123456789S (حرف واحد في النهاية)؛ وR1123456789SA (رقم في موضع حرف)؛ وXRB123456789SAX وRB123456789SA123 (أحرف زائدة لا يرفضها إلا المرساتان)؛ وRB123456789SA متبوعة بمسافة (شائعة بعد النسخ واللصق)؛ وRB-123456789-SA (فواصل)؛ ومدخل فارغ. يكسر كل مدخل غير صالح جزءاً واحداً بالضبط من القاعدة، فإذا قُبل أحدها عرفت أي جزء من النمط خاطئ. والنتيجة المتوقعة لكل مدخل «مقبول» أو «مرفوض»، كما في أي حالة اختبار للتحقق.

الخطوة 3. نمط واحد يحقق FR-22: ^Parcel (?<id>[A-Z]{2}\d{9}[A-Z]{2}): (?<status>accepted|in transit|out for delivery|delivered) (?<date>\d{4}-\d{2}-\d{2}) (?<time>\d{2}:\d{2}) \((?<city>[^()]+)\)$. النقاط المهمة: التناوب (Alternation) الخاص بالحالة موضوع داخل مجموعة خاصة به، فنطاقه الحالة وحدها؛ ولو كُتب دون مجموعة لقسّم accepted|in transit|… النمط كله إلى أربعة بدائل وطابق تقريباً أي نص يحوي «in transit». والقوسان حول المدينة حرفان خاصان، فيُهرَّب القوسان الحرفيان بـ \( و\). والمدينة [^()]+ لا \w+: فـ \w+ يطابق «Riyadh» ولا يطابق «New Delhi» بسبب المسافة، ولا يطابق أبداً، كما يحذّر الدليل، اسم مدينة بالحروف العربية أو الديفاناغارية إذا كانت الصفحة موطَّنة؛ أما الفئة المنفية، أو [\p{L}\p{M} ]+ مع العلم u، فتعالج الحالتين. والمرساتان ^ و$ تجعلان الفحص يرفض سطراً نقص منه شيء أو زاد عليه. وعلى السطر الأول في المثال تكون المجموعات: id = RB123456789SA، وstatus = delivered، وdate = 2026-10-02، وtime = 14:05، وcity = Riyadh؛ وعلى السطر الثاني status = out for delivery وcity = New Delhi. والسطر الذي فيه «delivred» لا يطابق أصلاً، فيفشل الفحص بدلاً من أن يبلّغ عن نجاح، وهذا بالضبط ما يحتاجه الاختبار: فالنمط المتساهل الذي يقبل قيمة خاطئة يجعل الاختبار ينجح حين يجب أن يفشل (نتيجة سلبية كاذبة، False-negative result). وفي الاختبار قارن كل مجموعة بالقيمة المتوقعة، مثل m.groups.status === "delivered". وتكفي مجموعة التاريخ \d{4}-\d{2}-\d{2} هنا لأن الاختبار يقارن القيمة نفسها؛ ولا تستخدم نمط تاريخ ISO الأدق من الدليل إلا حين يكون غرض الاختبار الصيغة نفسها. وفي الفحص الآلي يعمل النمط على سطر حالة واحد فلا يحتاج إلى أي علم؛ ولتجربته في «أداة اختبار Regex» على المادة كلها فعّل العلم m، للسبب المشروح في الخطوة 4.

الخطوة 4. نمط يجد استجابتي 5xx على مسارات الطرود فقط: ^\S+ \S+ /api/v2/parcels(?:/\S*)? 5\d\d \d+ms$ مع العلم m حتى يطابق ^ و$ عند حدود الأسطر، ومع العلم g في أداة الاختبار لرؤية كل التطابقات؛ وفي تعبير JavaScript الحرفي تُكتب الشرطات المائلة \/. قراءته من اليسار إلى اليمين: الطابع الزمني، ثم الطريقة، ثم المسار /api/v2/parcels متبوعاً اختيارياً بـ / ومزيد من الأحرف غير المسافات (/RB123456789SA أو /RB123456789SA/events)، ثم حالة تبدأ بـ 5، ثم المدة. يطابق سطرين بالضبط: طلب GET بالحالة 503 وطلب POST بالحالة 502. أما 5\d\d وحده فيجد تسعة تطابقات في ستة من الأسطر السبعة لأنه يجد الأرقام في أي موضع: 567 داخل RB123456789SA في سطرين، و512 ثم 567 داخل CP512345678IN، و512 مرة أخرى في المدة 512ms، و500 داخل EE500000000SA، والحالة 500 على /api/v2/rates وهو ليس مسار طرود؛ ولا تريد من التسعة إلا 503 و502. ووضع مسافة على جانبي الحالة، \s5\d\d\s، يزيل التطابقات الكاذبة في أرقام التتبع والمدد لكنه يبقي سطر الأسعار؛ وشرط المسار يزيله أيضاً. ومن دون العلم m لا يطابق النمط شيئاً، لأن ^ و$ يعنيان عندئذٍ بداية النص كله ونهايته. وهذه القاعدة نفسها التي في النموذج: من دون سياق ومراسٍ يطابق التعبير أكثر مما ينبغي.

الخطوة 5. أسئلة مفتوحة لمالك المنتج أو المطوّر: هل يتحقق النموذج قبل التحويل إلى الحروف الكبيرة أم بعده، وهل يُحذف الفراغ الطرفي من المدخل (المسافة الزائدة من النسخ واللصق شائعة)؟ هل تُقبل الأرقام العربية المشرقية المكتوبة على لوحة مفاتيح عربية أم تُحوَّل؟ فـ \d في JavaScript لا يطابق إلا 0–9، لذا يُرفض RB١٢٣٤٥٦٧٨٩SA. هل قائمة الحالات في FR-22 كاملة، وكيف يبدو السطر حين لا تكون للطرد مدينة بعد؟ وما رسالة الخطأ التي يعرضها النموذج لكل مدخل مرفوض حتى يؤكدها الاختبار؟

إن اختلفت أنماطك فافحصها في «أداة اختبار Regex». يجب أن يقبل نمط النموذج، حين تجرّبه على كل مدخل من مدخلات الخطوة 2 (أو عليها كلها، مدخلاً في كل سطر، مع العلم m)، المدخلات الصالحة الثلاثة ويرفض كل المدخلات الأخرى. ومقابل المادة مع العلم m يجب أن يطابق نمط سطر الحالة أسطر الحالة الثلاثة بقيم المجموعات الصحيحة ويرفض السطر ذا الخطأ الإملائي حين تضيفه، وأن يبرز نمط السجل سطرين من السجل بالضبط. والنمط المختلف المكافئ مقبول — فـ \d{2} و[0-9]{2} شيء واحد — ما دام مثبتاً بالمراسي حيث يتحقق، ويهرّب كل حرف خاص حرفي، ويبقي التناوب داخل مجموعة. ولا يضع أي من هذه الأنماط محدداً كمياً متكرراً على مجموعة تحوي محدداً آخر، مثل (a+)+ في الدليل: فالمجموعة الوحيدة التي عليها محدد كمي، (?:/\S*)?، اختيارية ولا تُطابَق أكثر من مرة، لذا فخطر التراجع الكارثي (Catastrophic backtracking) منخفض؛ والصق مدخلاً طويلاً لتتأكد. ثم ضع نمط سطر الحالة في «شارح Regex» واقرأه رمزاً رمزاً: فهي طريقة سريعة لإيجاد خطأ لا تراه.