Support

1. Reload the extension

chrome://extensions, then the reload arrow on the QA Wrap card.

Chrome caches the service worker inside the browser profile and will keep running the old one after an update. The symptom is specific and misleading: some things work and others answer nothing at all, usually with "the message port closed before a response was received" in the console. It is not a crash and it is not your profile. It is yesterday's backend talking to today's interface.

2. Reload the page you are testing

Content scripts only inject when a page loads. A tab that was already open when you installed or reloaded the extension has none, and every page-scoped tool will tell you to reload. That message is literal, not generic.

3. Check it is awake

The extension records nothing until you wake it, per browser window. A second window is a second decision. If every tool is greyed out, that is the switch, and the card at the top of the popup says so.

4. Look at the worker's own console

chrome://extensions, then Inspect views: service worker. It opens onto a banner with the build number, what the worker currently thinks is happening, and a qaw handle you can type into:

qaw.state()      // what the worker thinks is happening
qaw.sessions()   // every session it has stored
qaw.used()       // which tools this session has used
qaw.handlers()   // every message it answers to
qaw.wake()       // arm the current window without the popup

If qaw.about.build is not the version on the extensions card, go back to step 1. That one check has cost this project two separate afternoons. Builds before 3.1.0 called the same handle njb, and it still answers to that.

The popup carries a plain Report a problem button, for the person who found the issue rather than the person who tests for a living: a colleague, a client, or a tester on a build without the repository beside them. It opens a single page: one box to describe what went wrong in a sentence or two, one button to send it.

You do not have to gather evidence by hand. The moment that page opens, QA Wrap attaches, without asking:

• a screenshot of the page in front of you;
• its address, and any errors it reported in its console;
• your browser and screen size.

Send it posts through whatever tracker or chat webhook you already configured in Settings, if any. Save it instead keeps everything as a session on your machine and sends nothing. If nothing is configured, that is the honest outcome of pressing Send too: it is saved, and you are told so plainly rather than shown a spinner that never finishes.

What the export does and does not contain, plainly: a Markdown session export holds what you did on the page under test, in your own words, and the evidence QA Wrap gathered automatically. It contains no cookie values and no password field values, by construction (the privacy policy is the mechanism). It is not a scrubbed document, though: it does contain the URLs you visited and the values you typed into ordinary, non-password fields on the page you were testing. Read it before you send it. If the page under test carried a real customer's data and you were not using QA Wrap's masking, that data is in the export, the same way it would be in a screen recording or a bug report written by hand. Mask what matters before you record, or redact the export file afterwards; this support flow cannot do either for you.

Please do not send a token, a webhook URL or a cookie value. Nothing here ever needs one to reproduce a bug, and a credential in a message is a credential you now have to rotate.

What makes a report actionable

In rough order of how much time each one saves, on top of what the flow above already attaches:

1. The build. qaw.about.build in the worker console, or the number on the extensions card.
2. The browser and version. Chrome or Edge, and the version number (see Known limits below). It is the difference between a bug and an expected refusal.
3. What you pressed, and what happened instead. "Nothing happened" is a real and useful answer. Say it plainly rather than guessing at a cause.

Not offered, said plainly

• No uptime commitment, because there is nothing hosted to be up.
• No data recovery. Nobody has a copy of your sessions. Export what matters.
• No guaranteed compatibility with a future Chrome. Manifest V3 is still moving, and the test suite is the early warning system.

Reporting a security issue

Privately, to the maintainer, not in a shared channel and not in a ticket anybody can read. The surface worth knowing: the extension holds <all_urls>, patches fetch and XMLHttpRequest in every page, and can read cookies. It records nothing until armed, per window, and goes back to that state when the browser closes. The thing genuinely worth reporting is anything that acts while the extension is asleep. That is the boundary the whole design rests on.

1. أعد تحميل الامتداد

chrome://extensions، ثم سهم إعادة التحميل على بطاقة QA Wrap.

يخزن Chrome العامل الخدمي مؤقتا داخل ملف المتصفح، ويستمر في تشغيل النسخة القديمة بعد التحديث. العرض محدد ومضلل: تعمل بعض الأشياء ولا تجيب أخرى إطلاقا، غالبا مع عبارة "أغلقت منفذ الرسالة قبل استلام رد" في وحدة التحكم. ليس عطلا وليس ملفك. إنه واجهة خلفية من الأمس تتحدث إلى واجهة اليوم.

2. أعد تحميل الصفحة التي تختبرها

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

3. تحقق من أنها مستيقظة

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

4. انظر إلى وحدة تحكم العامل نفسها

chrome://extensions، ثم Inspect views: service worker. تفتح على شريط يحمل رقم البنية، وما يظن العامل حاليا أنه يحدث، ومقبض qaw يمكنك الكتابة فيه:

qaw.state()      // ما يظن العامل أنه يحدث
qaw.sessions()   // كل جلسة خزنها
qaw.used()       // أي أدوات استخدمتها هذه الجلسة
qaw.handlers()   // كل رسالة يجيب عليها
qaw.wake()       // سلح النافذة الحالية من دون القائمة المنبثقة

إن لم يكن qaw.about.build هو النسخة الموجودة على بطاقة الإضافات، ارجع إلى الخطوة 1. كلف هذا التحقق وحده هذا المشروع فترتي بعد ظهر منفصلتين. كانت البنيات قبل 3.1.0 تسمي المقبض نفسه njb، ولا يزال يجيب على ذلك.

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

لست مضطرا لجمع الأدلة يدويا. بمجرد فتح تلك الصفحة، يرفق QA Wrap، من دون أن يسألك:

• لقطة شاشة للصفحة أمامك؛
• عنوانها، وأي أخطاء أبلغت عنها وحدة التحكم الخاصة بها؛
• متصفحك ومقاس شاشتك.

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

ما يحتويه التصدير وما لا يحتويه، بوضوح: يحمل تصدير جلسة بصيغة Markdown ما فعلته على الصفحة قيد الاختبار، بكلماتك أنت، والدليل الذي جمعه QA Wrap تلقائيا. لا يحتوي على قيم كعكات (cookies) ولا قيم حقول كلمات المرور، بحكم البنية (سياسة الخصوصية هي الآلية). لكنه ليس مستندا منقحا مع ذلك: يحتوي على العناوين التي زرتها والقيم التي كتبتها في حقول عادية غير حقول كلمات المرور في الصفحة التي كنت تختبرها. اقرأه قبل أن ترسله. إن حملت الصفحة قيد الاختبار بيانات عميل حقيقي ولم تكن تستخدم إخفاء QA Wrap، فتلك البيانات موجودة في التصدير، تماما كما لو كانت في تسجيل شاشة أو تقرير عطل مكتوب يدويا. أخف ما يهم قبل التسجيل، أو نقح ملف التصدير بعده؛ لا يستطيع مسار الدعم هذا فعل أي منهما نيابة عنك.

من فضلك لا ترسل رمزا، أو رابط ويب هوك، أو قيمة كعكة. لا شيء هنا يحتاج إلى واحد منها لإعادة إنتاج عطل، وأي بيانات اعتماد في رسالة أصبحت بيانات اعتماد عليك تدويرها الآن.

ما الذي يجعل التقرير قابلا للتنفيذ

بترتيب تقريبي لمقدار الوقت الذي يوفره كل بند، فوق ما يرفقه المسار أعلاه بالفعل:

1. البنية. qaw.about.build في وحدة تحكم العامل، أو الرقم على بطاقة الإضافات.
2. المتصفح ونسخته. Chrome أو Edge، ورقم النسخة (انظر القيود المعروفة أدناه). هو الفارق بين عطل ورفض متوقع.
3. ما ضغطته، وما حدث بدلا منه. "لم يحدث شيء" إجابة حقيقية ومفيدة. قلها بوضوح بدل تخمين سبب.

غير مقدم، بوضوح

• لا التزام بوقت تشغيل، لأنه لا شيء مستضاف ليكون قيد التشغيل.
• لا استرجاع بيانات. لا أحد يملك نسخة من جلساتك. صدر ما يهمك.
• لا ضمان توافق مع نسخة مستقبلية من Chrome. لا يزال Manifest V3 يتغير، ومجموعة الاختبارات هي نظام الإنذار المبكر.

الإبلاغ عن مشكلة أمنية

سرا، إلى القائم على الصيانة، لا في قناة مشتركة ولا في تذكرة يقرؤها أي أحد. السطح الجدير بمعرفته: يحمل الامتداد إذن <all_urls>، ويصحح fetch و XMLHttpRequest في كل صفحة، ويستطيع قراءة الكعكات. لا يسجل شيئا حتى يسلح، لكل نافذة على حدة، ويعود إلى ذلك حين يغلق المتصفح. الشيء الجدير حقا بالإبلاغ عنه هو أي شيء يعمل بينما الامتداد نائم. تلك هي الحدود التي يقوم عليها التصميم كله.