التطوير
بعد قراءة قسم البدء، يمكنك استخدام هذا الدليل كمخطط تفصيلي لمكوّنات الإضافات وإمكانياتها في إصدار Manifest V3 وكيفية دمجها. تعرف أولاً على الإضافات التي بإمكانها: بعد ذلك، تعرَّف على كيفية دمج هذه الميزات باستخدام قسم المفاهيم الأساسية للإضافات.
تصميم واجهة المستخدم
لكي تعمل معظم الإضافات، يجب أن يتفاعل المستخدم معها. يوفر النظام الأساسي للإضافات مجموعة متنوعة من الطرق لإضافة تفاعلات إلى إضافتك. تتضمن هذه الطرق النوافذ المنبثقة التي يتم تشغيلها من شريط أدوات Chrome واللوحات الجانبية وقوائم السياقات والمزيد.
اللوحة الجانبية
يمكنك استخدام واجهة برمجة التطبيقات
chrome.sidePanel
لاستضافة المحتوى في اللوحة الجانبية للمتصفّح إلى جانب المحتوى الرئيسي لصفحة الويب.
الإجراء
يمكنك التحكُّم في عرض رمز الإضافة في شريط الأدوات.
القوائم
إضافة عناصر إلى قائمة السياقات في Google Chrome.
![](https://developer.chrome.google.cn/static/docs/extensions/develop/images/develop-ui-sidepanel.png?authuser=9&%3Bhl=ar&hl=ar)
التحكم في المتصفح
تتيح لك واجهات برمجة التطبيقات للإضافات في 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
يمكنك استخدام واجهة برمجة التطبيقات
chrome.privacy
للتحكّم في استخدام الميزات المتوفّرة في Chrome التي يمكن أن تؤثر في خصوصية المستخدم. يمكنك أيضًا الاطّلاع على واجهة برمجة التطبيقات chrome.proxy
لإدارة إعدادات الخادم الوكيل في Chrome.
إدارة التنزيلات
استخدِم واجهة برمجة التطبيقات
chrome.downloads
لبدء عمليات التنزيل ومراقبتها ومعالجتها والبحث عنها آليًا.
استخدام الإشارات المرجعية وقائمة القراءة
يمكنك استخدام واجهة برمجة التطبيقات
chrome.bookmarks
وواجهة برمجة التطبيقات chrome.readingList
لإنشاء هذه القوائم وتنظيمها ومعالجتها.
التحكّم في الويب
تغيير محتوى صفحات الويب وسلوكها ديناميكيًا. يمكنك التحكّم في الويب وتعديله من خلال إدخال نصوص برمجية واعتراض طلبات الشبكة واستخدام واجهات برمجة تطبيقات الويب للتفاعل مع صفحات الويب.
إدخال JavaScript وCSS
النصوص البرمجية للمحتوى هي ملفات يتم تشغيلها في سياق صفحات الويب. وتستخدم هذه البرامج نموذج كائن المستند (DOM) القياسي لقراءة تفاصيل صفحات الويب التي يزورها المتصفح وإجراء تغييرات عليها وتمرير المعلومات إلى إضافتها الرئيسية.
الوصول إلى علامة التبويب النشطة
يمنح إذن
"activeTab"
الإضافة إمكانية الوصول المؤقت إلى علامة التبويب النشطة حاليًا عندما يستدعي المستخدم الإضافة، مثلاً عن طريق النقر على إجراءها. ويستمر الوصول إلى علامة التبويب أثناء وجود المستخدم على هذه الصفحة، ويتم إبطاله عند انتقاله بعيدًا عن علامة التبويب أو إغلاقها.
التحكّم في طلبات الويب
يمكنك استخدام واجهات برمجة التطبيقات
chrome.declarativeNetRequest
وchrome.webRequest
وchrome.webNavigation
لمراقبة طلبات الشبكة وحظرها وتعديلها.
التسجيل الصوتي وتصوير الشاشة
تعرَّف على أساليب مختلفة لتسجيل الصوت والفيديو من علامة تبويب أو نافذة أو شاشة باستخدام واجهات برمجة تطبيقات النظام الأساسي للويب مثل
chrome.tabCapture
أو getDisplayMedia()
.
تعديل إعدادات الموقع الإلكتروني
يمكنك استخدام واجهة برمجة التطبيقات
chrome.contentSettings
للتحكّم في ما إذا كان بإمكان المواقع الإلكترونية استخدام ميزات، مثل ملفات تعريف الارتباط وJavaScript والمكوّنات الإضافية. وبشكل عام، تتيح لك إعدادات المحتوى تخصيص سلوك Chrome على أساس كل موقع إلكتروني بدلاً من تخصيص هذا السلوك على مستوى العالم.
المفاهيم الأساسية
باستخدام النظام الأساسي للويب وواجهات برمجة التطبيقات للإضافات، يمكنك إنشاء ميزات أكثر تعقيدًا من خلال الجمع بين مكونات واجهة المستخدم المختلفة وميزات النظام الأساسي للإضافات.
مشغّلو الخدمات
عامل خدمات الإضافات (service-factor.js) هو نص برمجي مستند إلى حدث يُشغّله المتصفّح في الخلفية. وغالبًا ما يتم استخدامها لمعالجة البيانات وتنسيق المهام في أجزاء مختلفة من الإضافة وكمدير حدث الإضافة.
الأذونات
فهم الأذونات: طريقة عملها ومتى يجب تجنُّب طلبها عندما لا تكون هناك حاجة إليها
تصفية المحتوى
هناك طرق مختلفة لتنفيذ فلترة المحتوى والشبكات في إضافات Chrome. تعرَّف على إمكانات فلترة المحتوى المتاحة للإضافات وأساليب الفلترة وأساليبها وواجهات برمجة التطبيقات المختلفة التي يمكن أن تستخدمها إضافات Chrome.
المراسلة
في كثير من الأحيان، تحتاج النصوص البرمجية للمحتوى، أو صفحات الإضافات الأخرى، إلى إرسال معلومات أو تلقّيها من مشغّل خدمات الإضافات. في هذه الحالات، يمكن لأي من الطرفَين الاستماع إلى الرسائل المُرسَلة من الطرف الآخر والرد على الرسائل في القناة نفسها.
المراسلة الأصلية
يُرجى تفعيل الإضافات لتبادل الرسائل مع التطبيقات الأصلية.
تجنُّب الرموز البرمجية المستضافة عن بُعد
في الإصدار Manifest V3، يجب أن تتضمّن الإضافات جميع الرموز التي تستخدمها داخل الإضافة نفسها. تتوفر استراتيجيات مختلفة للقيام بذلك.
مساحة التخزين
تتضمن إضافات Chrome واجهة برمجة تطبيقات تخزين مخصصة، ومتاحة لجميع مكونات الإضافات. وتتضمّن أربع مناطق تخزين منفصلة لحالات استخدام محدَّدة وأداة معالجة أحداث تتبَّع متى يتم تعديل البيانات.
المستندات خارج الشاشة
لا يملك عاملو الخدمة إمكانية الوصول إلى نموذج العناصر في المستند (DOM). تسمح واجهة برمجة التطبيقات Offscreen للإضافة باستخدام واجهات برمجة تطبيقات DOM في مستند مخفي بدون مقاطعة تجربة المستخدم من خلال فتح نوافذ أو علامات تبويب جديدة.
حظر الوصول من نطاقات متعددة
من خلال ميزة "عزل البيانات من نطاقات أخرى"، يمكن لصفحة الويب استخدام ميزات فعّالة، مثل
SharedArrayBuffer
. يمكن للإضافة تفعيل ميزة حظر الوصول من نطاقات أخرى من خلال تحديد القيم المناسبة لمفتاحَي بيان "cross_origin_embedder_policy"
و"cross_origin_opener_policy"
.