تخطَّ إلى المحتوى
تسجيل الدخولاطلب حساب

وش يُلتقط بالضبط

السبب اللي يخلّي تقرير uMarker يستاهل هو إنك تكتب جملة وحدة، والأداة ترفق كل اللي يحتاجه المطوّر عشان يعيد إنتاج المشكلة. ما تنسخ نسخة متصفّحك، ولا تلصق رابطاً، ولا تفتح الكونسول. uMarker يجمع كل هذا من التبويب لحظة الالتقاط، ويرسله مع علاماتك.

اللي يحمله التقرير يضبطه فريقك لكل مشروع من اللوحة: الودجت ← الإعداد، بطاقة «ما الذي تلتقطه الملاحظة». والضبط يسري على سنيبت الموقع والإضافة سواء — الاثنان يشغّلان نفس محرّك الالتقاط — والتقرير يحتفظ بالوضع اللي انرفع فيه.

  • الوضع العادي — لعملائك. التقرير يحمل بس اللي يوريك إيّاه المُبلِّغ.
  • الوضع التقني — لفريقك ومختبِريك. يضيف اللي يحتاجه المطوّر عشان يعيد إنتاج العلّة.

المشاريع الجديدة تبدأ على الوضع العادي؛ والمشاريع اللي كانت موجودة قبل أوضاع الالتقاط انضبطت على الوضع التقني، فما خسر أحد بياناته. والوضعان متاحان بكل الباقات. والتغيير يسري من أول تحميل صفحة بعده، والتقارير اللي انرفعت قبله تحتفظ باللي كان معها. ونافذة الإضافة تبيّن وضع المشروع اللي أنت عليه — «هذا المشروع يلتقط: عادي» أو «تقني» — بس ما فيها مفتاح: الوضع قرار الفريق، مو المختبِر.

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

وهذا كل اللي يحتويه تقرير الوضع العادي. وما يُجمَع أي شي تقني بالصفحة أصلاً: المسجِّلات ما تركّب شي لين يكون المشروع تقنياً. والخادم يفرض الضبط بدل ما يثق بالمتصفّح — أي بيانات تقنية توصل لمشروع على الوضع العادي (من نسخة إضافة قديمة، أو سكربت مخزَّن مؤقّتاً، أو طلب مكتوب باليد) تنرمى.

اللي يضيفه الوضع التقني

Section titled “اللي يضيفه الوضع التقني”
القطعة وش هي
طلبات الشبكة كل طلب أجرته الصفحة: عنوانه (والأسرار مفرّغة)، ونوعه، وطريقته، وحالته، ووقته، وحجمه. والطلبات الفاشلة والبطيئة (ثانية أو أكثر) متعلَّمة.
رسائل الكونسول مخرجات console في الصفحة: log وinfo وwarn وerror وdebug.
أخطاء JavaScript الأخطاء اللي ما انعالجت والـpromises المرفوضة، مع تتبّعها البرمجي (stack trace)، ومجمّعة بعدد مرّات تكرار كل خطأ.
الأداء وقت أول بايت، وجاهزية الـDOM والتحميل، وأول وأكبر رسم للمحتوى، وإزاحة التخطيط، والمهامّ الطويلة، وذاكرة جافاسكربت، وحجم الصفحة.
مسار الخطوات آخر النقرات والتنقّلات بين الصفحات أو المسارات، مسقوف بعدد الخطوات المضبوط للمشروع (20 افتراضياً، و100 بالأكثر).
الاتصال والبيئة نوع الاتصال وسرعته وزمن الرحلة وتوفير البيانات؛ وهل الصفحة داخل iframe، والتكبير، وكثافة البكسل، ونظام الألوان، وأسماء المفاتيح المخزّنة بالمتصفّح — أبداً مو قيمها.
رسائل المتصفّح نفسه بالإضافة على كروم أو Edge بس: اللي ما يقدر أي سكربت بالصفحة يقرأه — تفاصيل CORS وCSP، والمحتوى المختلط، وأخطاء الشبكة net::ERR_…. شوف الملاحظة تحت.

والبيانات التقنية مسقوفة لكل تقرير. الطلبات الفاشلة والبطيئة وأحدث العناصر تُحفظ أولاً، والتقرير يسجّل وش انشال منه.

ترويسات الطلبات أو الردود، والكوكيز، ومحتوى الطلبات أو الردود، والقيم المكتوبة بالحقول، والقيم المخزّنة بالمتصفّح — ما تُلتقط أبداً، مهما كان وضع المشروع.

وتقريرك يُرفَع باسم هويّتك المتّصلة — تُقرأ من جلستك، مو من التقرير نفسه — فيعرف الفريق دايماً مين أرسله. والمشروع يُطابَق من عنوان الموقع لمّا تُحمَّل الأداة على تلك الصفحة، والخادم يعيد التأكّد إنك مصرَّح لك بذاك المشروع قبل ما يقبل التقرير.

تفاصيل المتصفّح والصفحة

Section titled “تفاصيل المتصفّح والصفحة”

تُقرأ من متصفّحك وقت الالتقاط وتُرفَق كقيم مُهيكلة بسيطة، بالوضعين:

  • url: الصفحة اللي التقطت منها، وقيم الاستعلام اللي شكلها سرّ مفرّغة.
  • browser: كروم أو Edge أو فايرفوكس أو سفاري.
  • os: ويندوز أو macOS أو لينكس أو iOS أو أندرويد.
  • screen: مقاس شاشتك الكامل، مثل 1920x1080.
  • viewport: المساحة الظاهرة من الصفحة، مثل 1440x780.
  • language: لغة متصفّحك، مثل ar-SA.
  • user_agent: نصّ التعريف الخام، للنسخة بالضبط.

وباللوحة تظهر هذي كقائمة مُعنونة تحت لقطتك، داخل لوحة السياق التقني، فيقدر المُفرِز يطابق بيئتك بلا ما يسألك ولا سؤال متابعة. وuser_agent يُعرض هناك بصيغة مقروءة (Chrome 120 · macOS 14) والنصّ الخام يبان لمّا تمرّ عليه.

الإضافة مبنيّة عشان تشتغل على مواقع عملاء حقيقية، فاللي يغادر متصفّحك محدود عمداً:

  • ما ينرسل شي لين تضغط «إرسال للمراجعة»، فتراجع دبابيسك وملاحظاتك واللقطة نفسها أولاً.
  • القيم المكتوبة تُخفى قبل ما تُؤخذ اللقطة، لمّا يكون فريقك مشغّل الإخفاء للمشروع: قيم الحقول وأي منطقة أشّروا عليها بمُحدِّد CSS تنكتب فوقها نقاط (••••) على الصفحة الحيّة — تنكتب فوقها، مو تنموّه، لأنّ اللقطة المموّهة مو لقطة مُخفاة — وتُؤخذ اللقطة، وتُستعاد الصفحة أول ما تخلص. وبالصفحة الطويلة الالتقاط ينزل ويخيّط الشرائح، فتوقّع النقاط تبقى بالشاشة كم ثانية.
  • قيم الاستعلام اللي شكلها سرّ تُفرَّغ وقت التسجيل، دايماً وبلا مفتاح — ضمن الحدّ المذكور فوق.
  • بمشروع على الوضع العادي، ما يُسجَّل أي شي تقني أصلاً، والخادم يرمي أي شي منه يوصل.
  • توكن جلستك ما يلمس الصفحة أبداً. العامل الخلفي بالإضافة وحده يمسكه ويكلّم uMarker؛ والمواقع اللي تزورها ما تشوفه.