متى تحتاج إلى ملف HAR؟
ملف HAR (أرشيف HTTP) هو تسجيل لكل طلب شبكة يقوم به متصفحك أثناء استخدامك لصفحة ما. عند الإبلاغ عن خلل يظهر فقط في المتصفح - مثل عدم تحميل صفحة، أو زر لا يستجيب، أو بيانات تُعرض بشكل غير صحيح - غالبًا ما تحتاج فرق الدعم والهندسة إلى ملف HAR لمعرفة بالضبط ما طلبه المتصفح وما الذي تلقاه ردًا. إرفاق ملف HAR بتذكرتك يقلّص بشكل كبير من وقت تشخيص المشكلة.
يوضح هذا الدليل كيفية تسجيل ملف HAR في متصفح Google Chrome خلال حوالي 60 ثانية.
ملخص سريع
- افتح أدوات مطوري Chrome (DevTools) (اضغط F12 أو انقر بزر الماوس الأيمن ← فحص العنصر).
- انقر على علامة التبويب الشبكة (Network).
- تأكد من أن نقطة التسجيل (●) حمراء اللون - وهذا يعني أن Chrome يقوم بالتسجيل الآن.
- أعد إحداث الخلل في علامة التبويب نفسها.
- انقر بزر الماوس الأيمن على أي صف في لوحة الشبكة ← حفظ الكل كملف HAR مع المحتوى (Save all as HAR with content).
- أرفق ملف
.harالذي تم تنزيله بتذكرة الدعم الخاصة بك.
الشرح التفصيلي الكامل
الخطوة 1 - افتح أدوات مطوري Chrome
في الصفحة التي يظهر فيها الخلل، انقر بزر الماوس الأيمن في أي مكان واختر فحص العنصر (Inspect). أو ببساطة اضغط على F12 (على Windows/Linux) / Cmd + Option + I (على macOS).
الخطوة 2 - انقر على علامة التبويب الشبكة
في أعلى لوحة أدوات المطورين، انقر على الشبكة (Network). هذا هو المكان الذي سيتم فيه تسجيل كل طلب تقوم به الصفحة.
الخطوة 3 - تأكد من أن التسجيل مُفعّل، ثم أعد إحداث الخلل
يجب أن تكون النقطة الدائرية في أعلى يسار لوحة الشبكة حمراء (●) - وهذا يعني أن التسجيل نشط. إذا كانت رمادية، انقر عليها مرة واحدة لبدء التسجيل.
نصيحة: فعّل خانة الاختيار الحفاظ على السجل (Preserve log) حتى لا تُمحى الطلبات إذا أُعيد تحميل الصفحة أو إعادة توجيهها أثناء اختبارك.
الآن قم بالإجراء بالضبط الذي يُحدث الخلل - انقر على الزر المعطّل، أو أرسل النموذج، أو حمّل الصفحة التي تفشل، وما إلى ذلك. ستشاهد الطلبات تظهر في القائمة أثناء حدوثها.
الخطوة 4 - احفظ كملف HAR
بمجرد إعادة إحداث الخلل، انقر بزر الماوس الأيمن على أي صف في قائمة الشبكة واختر حفظ الكل كملف HAR مع المحتوى. سيقوم Chrome بتنزيل ملف .har إلى مجلد التنزيلات لديك.
الخطوة 5 - أرفق ملف .har بتذكرتك
افتح تذكرة الدعم الخاصة بك (أو رسالة الرد عبر البريد الإلكتروني) وأرفق ملف .har. هذا كل ما في الأمر - يمكن لفريق الهندسة الآن إعادة تشغيل بالضبط ما شاهده متصفحك.
الشرح المتحرك للخطوات الخمس الكاملة (5 ثوانٍ)
نصائح وملاحظات مهمة
- يحتوي ملف HAR على بيانات حقيقية. أي ملفات تعريف ارتباط (cookies)، أو رموز مصادقة، أو قيم نماذج، أو معلومات شخصية كانت جزءًا من الطلبات موجودة داخل الملف. لا تنشر ملفات HAR علنًا - أرفقها بتذكرة Jira حيث يكون الوصول مُتحكَّمًا به.
- أعد إحداث الخلل بعد فتح أدوات المطورين. الطلبات التي حدثت قبل فتح أدوات المطورين لا يتم التقاطها.
- استخدم خيار "الحفاظ على السجل" إذا كان الخلل يتضمن إعادة توجيه الصفحة أو إعادة تحميلها. فبدونه، يُمسح السجل عند التنقل.
- يمكن أن تكون ملفات HAR كبيرة الحجم (عدة ميغابايت أمر طبيعي). إذا رفض نظام التذاكر لديك التحميل، اضغط الملف أولًا في أرشيف مضغوط.
- يتوفر المتصفحان Firefox وEdge على الميزة نفسها - نفس الاختصار (F12)، ونفس علامة التبويب الشبكة، ونفس خيار "حفظ الكل كملف HAR" بالنقر بزر الماوس الأيمن.
هل تحتاج إلى مساعدة؟
إذا كانت أي خطوة أعلاه غير واضحة أو لم يتم تنزيل الملف، تواصل مع فريق هندسة دعم العملاء عبر Slack - وسنرشدك خلال العملية مباشرة.