بعد قراءة قسم البدء، يمكنك استخدام هذا الدليل كمخطط تفصيلي لمكوّنات الإضافات وإمكانياتها في إصدار Manifest V3 وكيفية دمجها. تعرف أولاً على الإضافات التي بإمكانها: بعد ذلك، تعرَّف على كيفية دمج هذه الميزات باستخدام قسم المفاهيم الأساسية للإضافات.

تصميم واجهة المستخدم

لكي تعمل معظم الإضافات، يجب أن يتفاعل المستخدم معها. يوفر النظام الأساسي للإضافات مجموعة متنوعة من الطرق لإضافة تفاعلات إلى إضافتك. تتضمن هذه الطرق النوافذ المنبثقة التي يتم تشغيلها من شريط أدوات Chrome واللوحات الجانبية وقوائم السياقات والمزيد.
يمكنك استخدام واجهة برمجة التطبيقات chrome.sidePanel لاستضافة المحتوى في اللوحة الجانبية للمتصفّح إلى جانب المحتوى الرئيسي لصفحة الويب.
يمكنك التحكُّم في عرض رمز الإضافة في شريط الأدوات.
إضافة عناصر إلى قائمة السياقات في Google Chrome.

التحكم في المتصفح

تتيح لك واجهات برمجة التطبيقات للإضافات في Chrome تغيير طريقة عمل متصفحك.
إلغاءات الإعدادات هي طريقة تتيح للإضافات إلغاء إعدادات Chrome المحدّدة. بالإضافة إلى ذلك، يمكن للإضافات استخدام رمز HTML لتجاوز الصفحات لاستبدال أي صفحة يوفرها Google Chrome عادةً. ويمكن لإحدى الإضافات أن تلغي مدير الإشارات أو علامة تبويب السجل أو علامة التبويب الجديدة.
إضافات أدوات مطوري البرامج تضيف وظائف إلى أدوات مطوري البرامج في Chrome من خلال الوصول إلى واجهات برمجة تطبيقات الإضافات الخاصة بأدوات مطوري البرامج من خلال صفحة أدوات مطوري البرامج المضافة إلى الإضافة. يمكنك أيضًا استخدام واجهة برمجة التطبيقات chrome.debugger لاستدعاء بروتوكول تصحيح الأخطاء عن بُعد في Chrome. يمكنك إرفاق علامة تبويب واحدة أو أكثر بأداة التفاعل مع الشبكة وتصحيح أخطاء JavaScript وتغيير نموذج العناصر في المستند (DOM) والمزيد.
تتيح لك chrome.notifications API إنشاء إشعارات باستخدام النماذج وعرض هذه الإشعارات للمستخدمين في لوحة النظام لدى المستخدم.
استخدِم واجهة برمجة التطبيقات chrome.history للتفاعل مع سجلّ المتصفِّح للصفحات التي تمت زيارتها، وواجهة برمجة التطبيقات chrome.browsingData لإدارة بيانات التصفُّح الأخرى. يمكنك استخدام chrome.topSites للوصول إلى المواقع الإلكترونية الأكثر زيارة.
استخدِم واجهات برمجة تطبيقات، مثل chrome.tabs وchrome.tabGroups وchrome.windows لإنشاء متصفِّح المستخدم وتعديله وترتيبه.
استخدِم واجهة برمجة التطبيقات chrome.commands لإضافة اختصارات لوحة المفاتيح التي تؤدي إلى تشغيل الإجراءات في إضافتك. على سبيل المثال، يمكنك إضافة اختصار لفتح إجراء المتصفّح أو إرسال أمر إلى الإضافة.
استخدِم chrome.identity API للحصول على رموز الدخول عبر OAuth 2.0.
توفّر واجهة برمجة التطبيقات chrome.management طرقًا لإدارة قائمة الإضافات التي يتم تثبيتها وتشغيلها. وهذه الميزة مفيدة بشكل خاص للإضافات التي تتجاوز صفحة "علامة تبويب جديدة" المضمّنة.
تتيح لك واجهة برمجة التطبيقات chrome.omnibox تسجيل كلمة رئيسية في المربّع المتعدد الاستخدامات في Google Chrome (شريط العناوين).
يمكنك استخدام واجهة برمجة التطبيقات chrome.privacy للتحكّم في استخدام الميزات المتوفّرة في Chrome التي يمكن أن تؤثر في خصوصية المستخدم. يمكنك أيضًا الاطّلاع على واجهة برمجة التطبيقات chrome.proxy لإدارة إعدادات الخادم الوكيل في Chrome.
استخدِم واجهة برمجة التطبيقات chrome.downloads لبدء عمليات التنزيل ومراقبتها ومعالجتها والبحث عنها آليًا.
يمكنك استخدام واجهة برمجة التطبيقات chrome.bookmarks وواجهة برمجة التطبيقات chrome.readingList لإنشاء هذه القوائم وتنظيمها ومعالجتها.

التحكّم في الويب

تغيير محتوى صفحات الويب وسلوكها ديناميكيًا. يمكنك التحكّم في الويب وتعديله من خلال إدخال نصوص برمجية واعتراض طلبات الشبكة واستخدام واجهات برمجة تطبيقات الويب للتفاعل مع صفحات الويب.
النصوص البرمجية للمحتوى هي ملفات يتم تشغيلها في سياق صفحات الويب. وتستخدم هذه البرامج نموذج كائن المستند (DOM) القياسي لقراءة تفاصيل صفحات الويب التي يزورها المتصفح وإجراء تغييرات عليها وتمرير المعلومات إلى إضافتها الرئيسية.
يمنح إذن "activeTab" الإضافة إمكانية الوصول المؤقت إلى علامة التبويب النشطة حاليًا عندما يستدعي المستخدم الإضافة، مثلاً عن طريق النقر على إجراءها. ويستمر الوصول إلى علامة التبويب أثناء وجود المستخدم على هذه الصفحة، ويتم إبطاله عند انتقاله بعيدًا عن علامة التبويب أو إغلاقها.
يمكنك استخدام واجهات برمجة التطبيقات chrome.declarativeNetRequest وchrome.webRequest وchrome.webNavigation لمراقبة طلبات الشبكة وحظرها وتعديلها.
تعرَّف على أساليب مختلفة لتسجيل الصوت والفيديو من علامة تبويب أو نافذة أو شاشة باستخدام واجهات برمجة تطبيقات النظام الأساسي للويب مثل chrome.tabCapture أو getDisplayMedia().
يمكنك استخدام واجهة برمجة التطبيقات chrome.contentSettings للتحكّم في ما إذا كان بإمكان المواقع الإلكترونية استخدام ميزات، مثل ملفات تعريف الارتباط وJavaScript والمكوّنات الإضافية. وبشكل عام، تتيح لك إعدادات المحتوى تخصيص سلوك Chrome على أساس كل موقع إلكتروني بدلاً من تخصيص هذا السلوك على مستوى العالم.

المفاهيم الأساسية

باستخدام النظام الأساسي للويب وواجهات برمجة التطبيقات للإضافات، يمكنك إنشاء ميزات أكثر تعقيدًا من خلال الجمع بين مكونات واجهة المستخدم المختلفة وميزات النظام الأساسي للإضافات.
عامل خدمات الإضافات (service-factor.js) هو نص برمجي مستند إلى حدث يُشغّله المتصفّح في الخلفية. وغالبًا ما يتم استخدامها لمعالجة البيانات وتنسيق المهام في أجزاء مختلفة من الإضافة وكمدير حدث الإضافة.
فهم الأذونات: طريقة عملها ومتى يجب تجنُّب طلبها عندما لا تكون هناك حاجة إليها
في كثير من الأحيان، تحتاج النصوص البرمجية للمحتوى، أو صفحات الإضافات الأخرى، إلى إرسال معلومات أو تلقّيها من مشغّل خدمات الإضافات. في هذه الحالات، يمكن لأي من الطرفَين الاستماع إلى الرسائل المُرسَلة من الطرف الآخر والرد على الرسائل في القناة نفسها.
يُرجى تفعيل الإضافات لتبادل الرسائل مع التطبيقات الأصلية.
في الإصدار Manifest V3، يجب أن تتضمّن الإضافات جميع الرموز التي تستخدمها داخل الإضافة نفسها. تتوفر استراتيجيات مختلفة للقيام بذلك.
تتضمن إضافات Chrome واجهة برمجة تطبيقات تخزين مخصصة، ومتاحة لجميع مكونات الإضافات. وتتضمّن أربع مناطق تخزين منفصلة لحالات استخدام محدَّدة وأداة معالجة أحداث تتبَّع متى يتم تعديل البيانات.
لا يملك عاملو الخدمة إمكانية الوصول إلى نموذج العناصر في المستند (DOM). تسمح واجهة برمجة التطبيقات Offscreen للإضافة باستخدام واجهات برمجة تطبيقات DOM في مستند مخفي بدون مقاطعة تجربة المستخدم من خلال فتح نوافذ أو علامات تبويب جديدة.
من خلال ميزة "عزل البيانات من نطاقات أخرى"، يمكن لصفحة الويب استخدام ميزات فعّالة، مثل SharedArrayBuffer. يمكن للإضافة تفعيل ميزة حظر الوصول من نطاقات أخرى من خلال تحديد القيم المناسبة لمفتاحَي بيان "cross_origin_embedder_policy" و"cross_origin_opener_policy".