chrome.extension

الوصف

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

الأنواع

ViewType

Chrome 44 والإصدارات الأحدث

نوع عرض الإضافة

Enum

"tab"

"popup"

الخصائص

inIncognitoContext

تكون القيمة "صحيح" بالنسبة إلى نصوص المحتوى البرمجية التي يتم تشغيلها داخل علامات التبويب في وضع التصفّح المتخفي، وبالنسبة إلى صفحات الإضافة التي يتم تشغيلها داخل عملية التصفّح المتخفي. لا ينطبق الخيار الأخير إلا على الإضافات التي تتضمّن incognito_behavior بقيمة "split".

النوع

قيمة منطقية

الطُرق

getBackgroundPage()

في المقدّمة فقط 
chrome.extension.getBackgroundPage(): Window | undefined

تعرض هذه الدالة عنصر JavaScript "window" لصفحة الخلفية التي يتم تشغيلها داخل الإضافة الحالية. تعرِض قيمة فارغة إذا لم يكن للإضافة صفحة خلفية.

المرتجعات

  • نافذة | غير محدّد

getViews()

في المقدّمة فقط 
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

تعرض هذه الطريقة صفيفًا من عناصر JavaScript "window" لكل صفحة يتم تشغيلها داخل الإضافة الحالية.

المعلمات

  • fetchProperties

    العنصر اختياري

    • tabId

      number اختياري

      الإصدار 54 من Chrome أو إصدار أحدث

      البحث عن طريقة عرض حسب معرّف علامة تبويب في حال حذف هذا الحقل، سيتم عرض جميع طرق العرض.

    • النوع

      ViewType اختياري

      نوع العرض المطلوب الحصول عليه. في حال عدم تحديدها، تعرض جميع طرق العرض (بما في ذلك الصفحات وعلامات التبويب في الخلفية).

    • windowId

      number اختياري

      النافذة التي سيتم حصر البحث فيها في حال عدم تحديدها، يتم عرض جميع طرق العرض.

المرتجعات

  • Window[]

    مصفوفة تتضمّن عناصر عامة

isAllowedFileSchemeAccess()

chrome.extension.isAllowedFileSchemeAccess(): Promise<boolean>

تعرض هذه السمة حالة إذن الوصول إلى مخطط "file://" الممنوح للإضافة. يتوافق هذا الإعداد مع إعداد "السماح بالوصول إلى عناوين URL للملفات" الذي يتحكّم فيه المستخدم لكل إضافة ويمكن الوصول إليه من خلال الصفحة chrome://extensions.

المرتجعات

  • Promise<boolean>

    الإصدار 99 من Chrome والإصدارات الأحدث

isAllowedIncognitoAccess()

chrome.extension.isAllowedIncognitoAccess(): Promise<boolean>

تعرض هذه السمة حالة إذن الوصول إلى "وضع التصفّح المتخفي" الممنوح للإضافة. يتوافق ذلك مع إعداد "مسموح به في وضع التصفُّح المتخفي" الذي يتحكّم فيه المستخدم لكل إضافة ويمكن الوصول إليه من خلال صفحة chrome://extensions.

المرتجعات

  • Promise<boolean>

    الإصدار 99 من Chrome والإصدارات الأحدث

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
): void

تضبط هذه السياسة قيمة مَعلمة ap CGI المستخدَمة في عنوان URL الخاص بتحديث الإضافة. يتم تجاهل هذه القيمة للإضافات المستضافة في "معرض إضافات Chrome".

المعلمات

  • البيانات

    سلسلة

الفعاليات