Skip to content

ما هي إضافة المتصفح: من يعرف الويب يعرف الإضافات ​

💡 الخلاصة في جملة: إضافة المتصفح هي برنامج مصغّر يعمل داخل Chrome — يمكن بناؤها بنفس HTML/CSS/JS المستخدمة في صفحات الويب، وتستطيع تعديل الواجهة وتعديل صفحات الويب واعتراض الطلبات؛ ومن جهة المطوّر، الذكاء الاصطناعي يكتب الكود وأنت مسؤول عن الفكرة والتحقق.

عند البحث عن «تطوير إضافات المتصفح»، تلقي الدروس في النتائج الأولى أمامك مباشرةً مصطلحات manifest_version وMV3 وservice worker وسكربتات المحتوى، فينسحب المبتدئ بعد فقرتين. هذا الدرس لا يكتب سطر كود واحدًا، بل يوضّح أولًا الأمور الأهم: ما هي إضافة المتصفح فعلًا، وماذا يمكنها أن تفعل، ولماذا «من يعرف الويب يعرف الإضافات»، وكم مرحلة يجب اجتيازها من الفكرة إلى النشر.

هذا هو الدرس 1 من مسار C للتطبيقات العملية على السيناريوهات (صناعة إضافة متصفح)، وهو أيضًا أساس المسار بأكمله — كل عملية في الدروس الستة اللاحقة تُبنى على مفاهيم هذا الدرس.

ماذا ستستطيع أن تفعل بعد إتمام الدرس ​

  • أن تشرح «ما هي إضافة المتصفح» بتعريف Chrome الرسمي: تخصيص الواجهة، مراقبة أحداث المتصفح، تعديل صفحات الويب
  • أن تعدّد الفئات الخمس للقدرات الأساسية للإضافة: نافذة منبثقة في شريط الأدوات، شريط جانبي، اعتراض طلبات الشبكة، حقن سكربتات في صفحات الويب، مراقبة الأحداث في الخلفية
  • أن توضّح لماذا «من يعرف الويب يعرف الإضافات»: حزمة التقنيات هي HTML/CSS/JS مع ملف manifest.json إضافي
  • أن تحفظ الخطوط الثلاثة للنشر في متجر تطبيقات Chrome: غرض واحد، الالتزام بالسياسات، حزم كل الكود
  • أن ترسم خريطة الدروس السبعة لمسار C وتعرف في أي درس يُشرح كل مفهوم

مأزقك الحالي ​

  • «الترجمة، لقطات الشاشة، حجب الإعلانات… هذه الإضافات التي أستخدمها كل يوم، كيف صُنعت فعلًا؟»
  • «عند البحث عن تطوير إضافات chrome، أول ما يظهر في الدروس هو manifest وMV3 وservice worker، ولا أعرف أيًّا من هذه الكلمات»
  • «أستطيع أن أجعل الذكاء الاصطناعي يكتب صفحات ويب، لكن الإضافات تبدو عالمًا آخر — هل كتابة الإضافات بالذكاء الاصطناعي موثوقة؟»

متى تستخدم هذه الطريقة ​

عندما تحتاج إلى:

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

ولا تريد أن:

  • تتعلم لغة جديدة — فالإضافات تستخدم نفس HTML/CSS/JS الخاصة بالويب
  • تبني مشروعًا من الصفر — فأصغر إضافة ليست سوى مجلد وبضعة ملفات
  • تعتني بخادم — فالإضافة تعمل داخل المتصفح، وتُحمّل محليًا وتعمل مباشرة دون نشر

إذا كنت تريد أن يصل أي شخص إلى ما تصنعه عبر عنوان URL، فتلك مهمة مسار A، ارجع إلى A1 صناعة موقع بالذكاء الاصطناعي.

🎒 التحضير قبل البدء ​

  • إتمام 4.0 تطبيقات عملية على السيناريوهات: اختر مسارك، والتأكد من أن ما تريده هو «أداة داخل المتصفح»
  • متصفح Chrome مثبّت على حاسوبك (مسار C يعتمد على Chrome، وهذا الدرس للمشاهدة فقط دون تنفيذ)
  • 8 دقيقة وقت قراءة، ولا يتطلب هذا الدرس كتابة أي كود

الفكرة الأساسية ​

لنتفق أولًا على الاسم: ما تسميه الوثائق الرسمية Chrome extensions يعتاد المجتمع الصيني على تسميته «إضافة متصفح» أو «إضافة Chrome»، ويستخدم هذا المقرر الاسمين بالتبادل.

أعطت وثائق Chrome الرسمية تعريفًا من جملة واحدة للإضافة:

Chrome extensions enhance the browsing experience by customizing the user interface, observing browser events, and modifying the web. (تعمل امتدادات Chrome على تحسين تجربة التصفح من خلال تخصيص الواجهة، ومراقبة أحداث المتصفح، وتعديل صفحات الويب.)

وبالترجمة إلى لغة مفهومة: الإضافة هي برنامج مصغّر «يسمح لك المتصفح رسميًا بتعديله من خلاله»، ويقوم بثلاثة أمور:

#التعريف الرسميبلغة مفهومة
1customizing the user interfaceإضافة واجهتك الخاصة إلى المتصفح (أزرار، نوافذ منبثقة، شريط جانبي)
2observing browser eventsمراقبة كل ما يفعله المتصفح (فتح علامة تبويب، إغلاقها، حذف إشارة مرجعية)
3modifying the webتعديل صفحة الويب التي تشاهدها (إضافة عناصر، تغيير الأنماط، اعتراض الطلبات)

الأهم للمبتدئ هو هذه العبارة الرسمية الأصلية:

You can build extensions using the same web technologies that are used to create web applications: HTML, CSS, and JavaScript. (يمكنك بناء الإضافات باستخدام نفس تقنيات الويب المستخدمة في إنشاء تطبيقات الويب: HTML وCSS وJavaScript.)

من هنا جاء عنوان هذا الدرس — من يعرف الويب يعرف الإضافات. فأنت بات بإمكانك أن تجعل الذكاء الاصطناعي يكتب أساسيات الويب الثلاثة، والإضافة ليست سوى إضافة ملف manifest.json«وصف» يخبر Chrome باسم إضافتك وما الأذونات التي تحتاجها.

💡 لماذا نقول إن كتابة الإضافات بالذكاء الاصطناعي موثوقة

كود الإضافة بالكامل هو HTML/CSS/JS مع ملف إعداد JSON — لا يوجد تجميع ولا عتبة أطر عمل. ووثائق Chrome الرسمية منظمة ومنهجية، تغطي كل شيء من البداية إلى manifest والتصحيح والنشر في مسار واحد، وكل الحقائق في دروس مسار C مصدرها هذه الوثائق، يكفيك أن تمررها إلى الذكاء الاصطناعي.

اتبعني خطوة بخطوة ​

الخطوة 1: جَرِّد الإضافات التي تستخدمها يوميًا (تبدأ المقدمة من «الاستخدام») ​

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

الخطوات: افتح Chrome، وأدخل chrome://extensions في شريط العنوان ثم اضغط Enter (يمكنك أيضًا النقر على زر القطعة في شريط الأدوات → Manage Extensions).

ما يجب أن تراه: قائمة بالإضافات المثبتة لديك. الترجمة، ولقطات الشاشة، وحجب الإعلانات…… كل إضافة تعرف اسمها هي في جوهرها برنامج مصغّر مبني من «مجلد واحد + manifest.json + HTML/CSS/JS».

  • فحص صغير: اختر إضافة تستخدمها كثيرًا، وفكّر هل عملها «تعديل الواجهة» أم «مراقبة الأحداث» أم «تعديل صفحة الويب»

الخطوة 2: أجب عن سؤال «ماذا تستطيع الإضافة فعله» باستخدام قائمة القدرات الرسمية ​

لماذا: عند تقديم متطلباتك للذكاء الاصطناعي، فإن قدرتك على قول «ما أريده هو نافذة منبثقة أم حقن سكربت في الصفحة» ترفع كثيرًا احتمال أن يصيب من أول مرة. هذا الجدول هو «فهرس قطع» الإضافة.

القدرةالشرح الرسميالاستخدام النموذجي
زر شريط الأدوات (Action)تنفيذ كود عند النقر على أيقونة شريط الأدوات، أو فتح نافذة صغيرة منبثقة (popup)تشغيل ميزة بنقرة واحدة: ترجمة، لقطة شاشة، تلخيص
الشريط الجانبي (Side Panel)عرض واجهة مخصصة في الشريط الجانبي للمتصفحقاموس دائم، ملاحظات، شريط محادثة ذكاء اصطناعي
اعتراض طلبات الشبكة (DeclarativeNetRequest)اعتراض طلبات الشبكة أو حجبها أو تعديلهاحجب الإعلانات، منع سكربتات التتبع
سكربتات المحتوى (Content scripts)تشغيل JavaScript داخل بيئة صفحة الويبإضافة أزرار إلى الصفحة، تعديل الأنماط، قراءة محتوى الصفحة
الخدمات الخلفية (Service workers)تعمل في الخلفية وتعالج أحداث المتصفح (مثل حذف إشارة مرجعية أو إغلاق تبويب)مراقبة تغيّرات التبويبات، إرسال الإشعارات

إلى جانب هذه الفئات الخمس، يمكن للإضافات استخدام Web APIs العادية ومجموعة كاملة من Chrome Extension APIs — والمرجع في حدود القدرات هو الوثائق الرسمية.

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

الخطوة 3: اعرف الحزمة التقنية — لماذا «من يعرف الويب يعرف الإضافات» ​

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

الخبر السار: كل هذا رأيته بالكامل في المسار A.

التقنيةفي صفحات الويب (المسار A)في الإضافات
HTMLبنية الصفحةبنية صفحات النافذة المنبثقة والشريط الجانبي وصفحة الإعدادات
CSSأنماط الصفحةنفس الأسلوب تمامًا
JavaScriptمنطق الصفحةنفس اللغة، مع استدعاء Chrome Extension APIs حسب الحاجة

الأمر الجديد الوحيد هو: manifest.json — ملف تهيئة JSON يوضع في المجلد الجذري للإضافة، يخبر Chrome باسم الإضافة ورقم إصدارها والأذونات التي تحتاجها. إنه «بطاقة الهوية + دليل الاستخدام» للإضافة، وسيتم شرح كل حقل فيه في الدرس C3.

وهناك قاعدة احفظها الآن: عند تطوير الإضافات اكتب Manifest V3 (MV3) فقط. الحقل manifest_version في manifest يدعم 3 فقط؛ وكثير من الدروس القديمة على الإنترنت ما زال يستخدم MV2، ونسخها كما هي هدر للجهد — فإضافات MV2 محظورة تمامًا في Chrome (بدءًا من Chrome 138 في 2025/7، لم يعد المستخدمون في جميع القنوات قادرين على تشغيلها).

ما يجب أن تراه: صار لديك اطمئنان — لا لغة جديدة، بل ملف جديد واحد وبضع مجموعات من APIs تُراجع عند الحاجة.

الخطوة 4: احفظ الخطوط الحمراء الثلاثة للنشر في تطوير إضافات المتصفح ​

لماذا: هذه الثلاثة هي الخطوط التي رسمتها Chrome رسميًا لـ«أي الإضافات يمكن نشرها». معرفتها قبل البدء توفر جولة إعادة عمل كاملة؛ أما اكتشافها بعد الانتهاء فتصحيحها هو الأوجع.

المتطلبات الرسمية الثلاثة لنشر إضافة:

  1. غرض واحد (single purpose): يجب أن تكون للإضافة غرض واحد فقط واضح وسهل الفهم — صندوق أدوات «يفعل كل شيء» لن يجتاز المراجعة
  2. الالتزام بسياسات برنامج المطورين (developer program policies): هناك قواعد للمحتوى والسلوك والخصوصية
  3. تضمين كل الكود في الحزمة: النص الرسمي — «all logic must be included in the extension package. This means no additional JavaScript code may be downloaded at runtime.» (يجب أن تُضمَّن كل المنطق في حزمة الإضافة، ولا يجوز تنزيل أي كود JavaScript إضافي وقت التشغيل)

البند 3 مهم بشكل خاص في vibe coding: تريد أن «تجلب الإضافة أحدث المنطق من الخادم» لتفادي التحديثات؟ هذا الطريق مغلق، فالحظر مذكور صراحة في النص الرسمي.

ما يجب أن تراه: صار لديك فحص ذاتي إضافي عند اختيار المنتج — هل يمكنني وصف الغرض الواحد لإضافتي في جملة واحدة؟ وهل كل الكود داخل الحزمة؟

الخطوة 5: ارسم خريطة الدروس السبعة للمسار C ​

لماذا: إذا حفظت الخريطة، فإن الدروس الستة التالية مجرد ملء فراغات — كل درس يحل خانة واحدة.

يتكون المسار C من سبعة دروس، وهذا الدرس (C1) هو الأساس، وبقيت ست خانات:

الدرسما الذي يحله
C2 أول إضافة Chrome لكتشغيل Hello World خلال 15 دقيقة: أصغر مثال لـ manifest + ثلاث خطوات للتحميل المحلي
C3 شرح manifest.json بالتفصيلمعنى كل حقل، وما يجب ملؤه إضافيًا للنشر
C4 Content Script و Service Workerما الذي يديره «اليدان والقدمان» و«الدماغ» في الإضافة، ومتى يُستخدم كل منهما
C5 ماذا تفعل إذا لم تعمل الإضافةأين تجد السجلات، وكيف تقرأ رسائل الخطأ
C6 النشر على Chrome Web Storeتسجيل المطور، وحزم zip، وكل خطوات تقديم المراجعة
C7 استراتيجية مراجعة المتجر والنشرالمراجعة تنتهي خلال 3 أيام في الغالب، والنشر التدريجي والتراجع

::: نصيحة 💡 هل يمكن للمطورين الصينيين التسجيل؟ نعم. قائمة الدول والمناطق التي يدعم متجر Chrome Web Store التسجيل منها تتضمن China (البر الرئيسي الصيني). يتطلب التسجيل دفع رسم تسجيل لمرة واحدة، والمبلغ يُعتمد وفق صفحة الدفع الفعلية في لوحة تحكم المطور — C6 شرح مفصّل. :::

يجب أن تكون قد رأيت: خريطة الدروس السبعة في ذهنك، والدرس التالي هو كتابة Hello World عمليًا.

نقطة تحقق ✅ ​

  • تستطيع إعادة سرد الأمور الثلاثة من التعريف الرسمي: تخصيص الواجهة، مراقبة أحداث المتصفح، تعديل صفحات الويب
  • تستطيع ذكر ثلاث فئات من فئات القدرات الخمس: نافذة منبثقة لشريط الأدوات، شريط جانبي، اعتراض الطلبات، سكربتات المحتوى، خدمة الخلفية
  • تعرف أن حزمة تقنيات الإضافة هي HTML/CSS/JS + ملف manifest.json واحد، دون أي لغة جديدة
  • تستطيع ذكر الخطوط الحمراء الثلاثة للنشر: غرض واحد، الالتزام بالسياسات، حزم كل الشيفرة (لا يُسمح بتحميل JS عن بُعد)
  • تعرف أنك الآن تكتب MV3 فقط، وأن الدروس القديمة عن MV2 على الإنترنت لا يمكن نسخها كما هي

تنبيه من العثرات ​

❌ الظن أن تطوير الإضافات يتطلب تعلم تقنية جديدة ​

بمجرد سماع كلمة «تطوير» تتجه لقراءة الكتب؟ لا داعي. تقول الوثائق الرسمية بوضوح أن الإضافات تستخدم HTML/CSS/JS، والجديد الوحيد هو ملف manifest.json واحد وواجهات Chrome API التي تُراجع حسب الحاجة.

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

❌ نسخ شيفرة MV2 من الدروس القديمة على الإنترنت ​

كثير من الدروس الشائعة كُتبت في عصر MV2. الآن manifest_version في manifest يدعم 3 فقط، وإضافات MV2 محظورة تمامًا في Chrome — نسخ الشيفرة القديمة يعني عملًا بلا فائدة.

الطريقة الصحيحة: إذا رأيت "manifest_version": 2 في أي درس أغلقه فورًا، واعتمد على الوثائق الرسمية وC3 المرجع السريع للحقول.

❌ محاولة تحقيق منطق ديناميكي عبر «تنزيل الشيفرة من الخادم أثناء التشغيل» ​

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

الطريقة الصحيحة: تحديثات الوظائف تسلك الطريق الصحيح — عدّل الشيفرة، ارفع رقم الإصدار، أعد التقديم (يُشرح الإيقاع في C6/C7).

❌ حشر كل الوظائف في إضافة واحدة ​

إضافة على طراز سكين الجيش السويسري «تترجم وتلتقط لقطات شاشة وتدير التبويبات معًا» تخالف متطلب الغرض الواحد، ولن تستطيع توضيح استخدامها عند النشر.

الطريقة الصحيحة: إضافة واحدة تحل أمرًا واحدًا. فكرة ثانية؟ اصنع إضافة ثانية.

حيل متقدمة (اختياري) ​

🚀 قائمة الدروس الرسمية هي مسار متقدم جاهز. رتبت Chrome رسميًا للمبتدئين سلسلة دروس: Hello World → Run scripts on every page (إضافة عناصر تلقائيًا إلى موقع محدد) → Inject scripts into the active tab (تغيير نمط الصفحة الحالية بالنقر على أيقونة شريط الأدوات) → Create a tab manager (نافذة منبثقة لإدارة التبويبات) → Handle events with service workers → Debug your extension. الدروس الأخيرة من مسار C تسير على امتداد هذه السلسلة، وبعد إنهاء الدروس السبعة ستكون قادرًا على متابعة إنجاز جميع الدروس الرسمية.

إذا كنت تكتب الإضافة بـ TypeScript، يمكنك تثبيت حزمة npm chrome-types للحصول على الإكمال التلقائي لواجهات Chrome API — هذه الحزمة تُحدَّث تلقائيًا مع الشيفرة المصدرية لـ Chromium، فتذكّر ترقيتها باستمرار.

خلاصة هذا الدرس ​

✅ في الدرس الأول من تطوير إضافات المتصفح، حصلت على هذه الخريطة:

  • إضافة المتصفح = برنامج مصغّر يسمح لك رسميًا بتعديل المتصفح: تخصيص الواجهة، مراقبة أحداث المتصفح، تعديل صفحات الويب
  • مجموعة القدرات الخمس: نافذة منبثقة لشريط الأدوات (Action)، شريط جانبي، اعتراض الطلبات (DeclarativeNetRequest)، سكربتات المحتوى، خدمة الخلفية
  • صفر إضافات في حزمة التقنيات: HTML/CSS/JS + manifest.json؛ الآن نكتب MV3 فقط
  • الخطوط الحمراء الثلاثة للنشر: غرض واحد، الالتزام بالسياسات، حزم كل الشيفرة
  • دروس مسار C السبعة: هذا الدرس (الأساس) → Hello World → manifest → السكربتان → التصحيح → النشر → سياسة المراجعة
المفهوم الرئيسيتذكّر بجملة واحدةأي درس يتوسع فيه
manifest.jsonبطاقة هوية الإضافة + دليل استخدامهاC3
MV3الإصدار الوحيد حاليًا، لا تنسخ الدروس القديمة عن MV2C2
content script / service workerأطراف الإضافة ودماغهاC4
التحميل المحلي والتصحيحchrome://extensions + مواضع السجلاتC5
النشر والمراجعةرسم تسجيل لمرة واحدة، تُنجز المراجعة خلال 3 أيام في الغالبC6 · C7

إطلالة على الدرس التالي ​

الدرس التالي C2 أول إضافة Chrome: إنجاز Hello World في 15 دقيقة. ستتعلم:

  • كيف يبدو الحد الأدنى القابل للاستخدام من manifest.json (مثال رسمي حرفيًا)
  • تفعيل وضع المطوّر في chrome://extensions، وتحميل محلي عبر Load unpacked في ثلاث خطوات
  • بعد تعديل الشيفرة، أي الملفات تتطلب تحديث الإضافة وأيها لا يتطلب
  • كيفية تثبيت (Pin) الإضافة في شريط الأدوات لاستخدامها بالنقر في أي وقت

إذا كنت مستعدًا فادخل إلى C2 →

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.