أدلة الاختبار

لماذا يهم

الإخفاق الذي لا يُوثَّق لحظة حدوثه يصعب غالباً إظهاره مرة أخرى: فقد تتغير البيانات، أو يُعاد نشر البيئة، أو تكون المشكلة متقطعة. ومن دون أدلة قد يُغلق التقرير بعبارة «تعذّرت إعادة الإنتاج»، والنجاح المسجَّل بلا إثبات قد يُشكَّك فيه أثناء تدقيق أو اعتماد للقبول (Sign-off).

وللأدلة خطرها أيضاً. فلقطة الشاشة قد تُظهر رقم هاتف عميل، وملف الشبكة المصدَّر قد يحتوي ملف تعريف ارتباط الجلسة (Session Cookie) الذي يتيح لكل من يملك الملف أن يتصرف بصفة ذلك المستخدم. وجمع ما يلزم فقط يحمي الأشخاص الذين يحتفظ النظام ببياناتهم.

ما الذي يُعدّ دليلاً، وكم تحتاج منه

الدليل هو أي سجل يُنشأ أثناء تنفيذ الاختبار ويدعم نتيجته. ويذكر منهج ISTQB للمستوى التأسيسي سجلات الاختبار ولقطات الشاشة وتفريغات قاعدة البيانات والتسجيلات بوصفها مواد يمكن أن يتضمنها تقرير العيب لتسهيل إعادة إنتاج الإخفاق.

والدليل يحتاج إلى سياق. فلقطة الشاشة وحدها لا تثبت إلا أن شاشةً ما بدت هكذا ذات مرة؛ أما مع حالة الاختبار والتشغيل والبناء والبيئة ودور الحساب وبيانات الاختبار والوقت مع منطقته الزمنية، فتثبت ما حدث في ذلك الاختبار.

• الاختبار الفاشل: ما يكفي ليرى المطور الإخفاق دون أن يسألك؛ أي النتيجة الفعلية بجانب النتيجة المتوقعة، مع السجلات التي تُظهر ما حدث في الخلفية.
• الاختبار الناجح: تكفي غالباً النتيجة المسجلة. أما الأعمال الخاضعة للتنظيم والقبول التعاقدي وبعض اعتمادات اختبار قبول المستخدم (UAT) فتتطلب إثبات النجاح، وتحدد خطة الاختبار أي الاختبارات تحتاجه وبأي شكل.
• اجمع الأدلة أثناء التنفيذ واحفظها مع النتيجة: فالدليل الذي يُعاد إنشاؤه لاحقاً على بناء آخر يخصّ اختباراً جديداً.

لقطات الشاشة وتسجيلات الشاشة

لقطة الشاشة أسرع دليل على ما رآه المستخدم. التقط النافذة كاملة مع ظهور عنوان الصفحة (URL) والحساب المسجَّل دخوله، لا قصاصة ضيقة حول الخطأ؛ وإذا كان الإخفاق تغيّراً، فالتقط لقطة قبله وأخرى بعده. وحدّد المشكلة على نسخة من الصورة، واحتفظ بالأصل.

أما التسجيل فيُظهر ما لا تستطيعه اللقطة: الترتيب والتوقيت. استخدمه للتدفقات متعددة الخطوات والوميض والاستجابات البطيئة والإخفاقات المتقطعة؛ واجعله قصيراً، ودوّن الثانية التي يظهر فيها الإخفاق.

• انسخ رسائل الخطأ نصاً أيضاً ليمكن البحث فيها؛ واستخراج النص من لقطة الشاشة بالتعرف الضوئي على الحروف (OCR) حلّ احتياطي.

جرّبها: تحويل الصورة إلى نص

السجلات: وحدة التحكم والشبكة والخادم

السجلات تُظهر ما حدث تحت الشاشة. في تطبيقات الويب تغطي ثلاثة سجلات معظم الإخفاقات، وأول اثنين منها في أدوات المطور (DevTools) في المتصفح، وتفتحها بالمفتاح F12 أو Ctrl+Shift+I (أو Cmd+Option+I على Mac).

وتتناول وحدة اختبار تطبيقات الويب أدوات المطور، وتتناول وحدة HTTP الطلبات والترويسات ورموز الحالة، وكلتاهما بالتفصيل. ويكفيك الآن أن تعرف أن الصفحة كلما تواصلت مع الخادم أرسل المتصفح طلباً (Request) وتلقّى استجابة (Response) تحمل رمز حالة من ثلاثة أرقام (2xx نجاح، و4xx مشكلة في الطلب، و5xx إخفاق في جهة الخادم) وترويسات (Headers)، وهي أسطر معلومات إضافية لكل منها اسم، مثل ملف تعريف الارتباط (Cookie) الذي يُبقي المستخدم مسجَّل الدخول.

• وحدة التحكم (Console): أخطاء JavaScript وحالات تعذّر تحميل الموارد والتحذيرات. انسخ الخطأ نصاً مع اسم الملف ورقم السطر ووقته؛ وفعّل إظهار الطوابع الزمنية (Timestamps) في إعدادات وحدة التحكم إن كانت مخفية.
• لوحة الشبكة (Network): كل طلب مع طريقته وعنوانه ورمز حالته وتوقيته وترويساته وأجسامه. افتحها قبل الخطوة الأولى وفعّل «Preserve log» (وفي Firefox: «Persist Logs») حتى لا يمسحها الانتقال إلى صفحة أخرى. صدّر ملف HAR (أرشيف HTTP، بصيغة JSON) أو انسخ الطلب الفاشل وحده.
• سجلات الخادم: غالباً خارج متناول المختبِر. أعطِ المطور الوقت الدقيق مع منطقته الزمنية، لأن كثيراً من الخوادم يسجّل بتوقيت UTC (فالساعة ⁦10:14⁩ في الرياض، بتوقيت ⁦UTC+3⁩، هي ⁦07:14⁩ بتوقيت UTC)، وأي معرّف طلب أعادته الاستجابة، مثلاً في ترويسة مثل X-Request-Id (تختلف الأسماء). وأرفق الأسطر التي يجدها، لا الملف كله.

جرّبها: عارض شجرة JSON جرّبها: محوّل المناطق الزمنية

الخصوصية والأمان عند جمع الأدلة

تنسخ الأدلة البيانات إلى أماكن يصل إليها عدد أكبر من الناس: أدوات تتبع العيوب والمحادثات والبريد الإلكتروني وتذاكر الموردين. وقد يحمل ملف HAR كل ترويسة وكل جسم في الجلسة، بما فيها ملفات تعريف الارتباط والرموز (Tokens) التي تتيح لكل من يملك الملف أن يتصرف بصفة ذلك المستخدم ما دامت صالحة. والبيانات الشخصية داخل الأدلة تبقى بيانات شخصية، تنطبق عليها أنظمة مثل نظام حماية البيانات الشخصية في المملكة العربية السعودية (PDPL)، وسياسات جهتك.

ووجود كلمة مرور أو رمز أو بيانات شخصية في سجلٍّ ملاحظةٌ بحد ذاته (فورقة OWASP الإرشادية للتسجيل، Logging Cheat Sheet، تنص على ألا تُسجَّل كلمات المرور ومعرّفات الجلسات ورموز الوصول والبيانات الشخصية الحساسة في السجلات مباشرة): أبلغ عنه دون أن تلصق القيمة.

• استخدم حسابات الاختبار والبيانات المولَّدة، والتقط نافذة المتصفح لا سطح المكتب كله، وأسكت الإشعارات قبل التسجيل.
• غطِّ البيانات بمستطيل مصمت معتم، لا بتمويه خفيف. وفي ملف PDF يبقى النص تحت المستطيل المرسوم فوقه؛ فاستخدم الحجب (Redaction) الحقيقي.
• في ملف HAR (يظهر أدناه إدخال منه قبل التنظيف)، احذف قيم Cookie وSet-Cookie وAuthorization، ومصفوفات cookies التي تكررها، وكلمات المرور والبيانات الشخصية في الأجسام. ومتصفح Chrome بدءاً من الإصدار ⁦130⁩ يستبعد هذه الترويسات الثلاث افتراضياً (التصدير «sanitized»)، لكن الأجسام تبقى، وقد تحتفظ متصفحات أخرى بكل شيء، فافحص كل ملف. تسجيل الخروج يُنهي كثيراً من الجلسات، لكن بعض الرموز تبقى صالحة حتى تنتهي مدتها.
• احفظ الأدلة في أدوات الفريق ذات الصلاحيات المضبوطة، لا في القنوات العامة، واحذفها عند انتهاء مدة الاحتفاظ المتفق عليها.

{
  "startedDateTime": "2026-09-30T07:14:52.118Z",
  "request": {
    "method": "POST",
    "url": "https://staging.example.test/api/leave-requests",
    "headers": [
      { "name": "Authorization", "value": "Bearer eyJhbGciOi..." },
      { "name": "Cookie", "value": "sid=4f9c..." }
    ],
    "cookies": [{ "name": "sid", "value": "4f9c..." }],
    "postData": {
      "mimeType": "application/json",
      "text": "{\"type\":\"annual\",\"days\":3}"
    }
  },
  "response": {
    "status": 504,
    "headers": [{ "name": "X-Request-Id", "value": "8b1f0c2e" }]
  }
}

جرّبها: تنقيح PDF (حجب المعلومات) جرّبها: مولّد مستخدمين وهميين

مثال تطبيقي: أدلة طلب إجازة فاشل

يشغّل مختبِر حالة الاختبار TC-LV-009 «تقديم طلب إجازة سنوية لمدة ⁦3⁩ أيام» ضمن تشغيل انحدار السبرنت ⁦42⁩ لبوابة الموارد البشرية على بيئة Staging، وأدوات المطور مفتوحة و«Preserve log» مفعّل. يملأ المختبِر النموذج ويلتقط لقطة شاشة، ثم يبدأ تسجيل نافذة المتصفح وينقر «Submit». يدور مؤشر التحميل ⁦30⁩ ثانية، ثم تظهر «Request failed. Try again.». يلتقط المختبِر لقطة شاشة ويفتح «My requests»، فيجد الطلب مدرجاً بحالة «Pending»؛ فالمستخدم الذي يصدّق الرسالة سيقدّم طلباً مكرراً.

يصدّر المختبِر ملف HAR ويحذف قيم الجلسة، وينسخ خطأ وحدة التحكم، ويدوّن معرّف الطلب. وبهذا المعرّف يجد المطور أسطر سجل الخادم: حُفظ الطلب، ثم انتظرت خدمة الإجازات ردّ خدمة الموافقات، وبعد ⁦30⁩ ثانية توقفت البوابة (Gateway) التي تسبقها عن الانتظار وأعادت الرمز ⁦504⁩ (Gateway Timeout). وهذه الحزمة المرفقة بنتيجة التشغيل وبالعيب DEF-1874:

الجزء 1:1DEF-1874-evidence/   TC-LV-009 · run "Sprint 42 regression" · HR portal
  00-context.txt    build 5.2.0-rc1 · staging · Chrome 129 / Windows 11
                    account qa.employee07 (employee role) · 30 Sep 10:14:52 UTC+3
  الجزء 2:201-form.png       the filled form before Submit: annual leave, 12-14 Oct, 3 days
  02-error.png      after 30 s: "Request failed. Try again." (boxed in red)
  03-list.png       My requests: the same request is listed as Pending
  الجزء 3:304-console.txt    10:15:22 Failed to load resource: the server responded
                    with a status of 504 (Gateway Timeout)
  الجزء 4:405-network.har    POST /api/leave-requests -> 504 after 30.0 s
                    X-Request-Id: 8b1f0c2e · Cookie, Authorization values removed
  الجزء 5:506-server.txt     log lines for 8b1f0c2e, provided by the developer
  الجزء 6:607-steps.mp4      41 s: Submit, spinner, error at 0:31, open My requests

• ما استُبعد من الحزمة: سطح المكتب، وقيم الجلسة، وطلب تسجيل الدخول السابق في ملف HAR، الذي كان جسمه يحمل كلمة مرور حساب الاختبار.

DEF-1874-evidence/   TC-LV-009 · run "Sprint 42 regression" · HR portal
  00-context.txt    build 5.2.0-rc1 · staging · Chrome 129 / Windows 11
                    account qa.employee07 (employee role) · 30 Sep 10:14:52 UTC+3
  01-form.png       the filled form before Submit: annual leave, 12-14 Oct, 3 days
  02-error.png      after 30 s: "Request failed. Try again." (boxed in red)
  03-list.png       My requests: the same request is listed as Pending
  04-console.txt    10:15:22 Failed to load resource: the server responded
                    with a status of 504 (Gateway Timeout)
  05-network.har    POST /api/leave-requests -> 504 after 30.0 s
                    X-Request-Id: 8b1f0c2e · Cookie, Authorization values removed
  06-server.txt     log lines for 8b1f0c2e, provided by the developer
  07-steps.mp4      41 s: Submit, spinner, error at 0:31, open My requests

أسئلة شائعة

المراجع

• ISTQB Certified Tester Foundation Level (CTFL) v4.0ISTQB · 2023المنهج التأسيسي لاختبار البرمجيات: مستويات الاختبار وأنواعه وتقنيات تصميم الاختبارات وإدارة الاختبار والأدوات.
• What are browser developer tools? — MDNMDN Web Docs (Mozilla)مقدمة لأدوات المطوّرين المدمجة في المتصفحات — المفتّش ووحدة تحكم JavaScript ومصحّح الأخطاء — لفحص الصفحة أثناء اختبارها.
• OWASP Cheat Sheet Series: LoggingOWASP Foundationما يُسجَّل وما لا يُسجَّل أبداً (كلمات المرور والرموز والبيانات الشخصية)، وكيف تُبقى السجلات قابلة لكشف العبث.
• Personal Data Protection Law (English translation)الهيئة السعودية للبيانات والذكاء الاصطناعي (سدايا) · 2023النظام السعودي لحماية البيانات الشخصية — ولماذا ينبغي أن تستخدم بيئات الاختبار بيانات اصطناعية بدلاً من نسخ سجلات العملاء الحقيقية.