الوصف
تتضمّن واجهة برمجة التطبيقات chrome.extension أدوات مساعدة يمكن استخدامها في أي صفحة إضافة. وتتضمّن هذه الواجهة إمكانية تبادل الرسائل بين الإضافة ونصوص المحتوى البرمجية الخاصة بها أو بين الإضافات، كما هو موضّح بالتفصيل في تمرير الرسائل.
الأنواع
ViewType
نوع عرض الإضافة
Enum
"علامة تبويب"
"popup"
الخصائص
inIncognitoContext
تكون القيمة "صحيح" للنصوص البرمجية للمحتوى التي يتم تشغيلها داخل علامات التبويب في وضع التصفّح المتخفي، ولصفحات الإضافات التي يتم تشغيلها داخل عملية في وضع التصفّح المتخفي. ينطبق الخيار الأخير فقط على الإضافات التي تتضمّن السمة incognito_behavior بقيمة split.
النوع
قيمة منطقية
الطُرق
getBackgroundPage()
browser.extension.getBackgroundPage(): Window | undefined
تعرض هذه الدالة عنصر "النافذة" في JavaScript لصفحة الخلفية التي يتم تشغيلها داخل الإضافة الحالية. تعرض القيمة "فارغ" إذا لم تكن الإضافة تحتوي على صفحة في الخلفية.
المرتجعات
-
نافذة | غير محدّد
getViews()
browser.extension.getViews(
fetchProperties?: object,
): Window[]
تعرض هذه السمة مصفوفة من عناصر "النافذة" في JavaScript لكل صفحة من الصفحات التي يتم تشغيلها داخل الإضافة الحالية.
المعلمات
-
fetchProperties
object اختياري
-
tabId
number اختيارية
الإصدار 54 من Chrome والإصدارات الأحدث browser.* منذ الإصدار 148 من Chromeللعثور على طريقة عرض وفقًا لرقم تعريف علامة التبويب في حال حذف هذا الحقل، يتم عرض جميع طرق العرض.
-
النوع
ViewType اختيارية
نوع العرض المطلوب الحصول عليه في حال حذف هذه المَعلمة، يتم عرض جميع طرق العرض (بما في ذلك الصفحات وعلامات التبويب في الخلفية).
-
windowId
number اختيارية
النافذة التي سيتم حصر البحث فيها في حال حذف هذه المَعلمة، يتم عرض جميع المشاهدات.
-
المرتجعات
-
Window[]
مصفوفة من العناصر العامة
isAllowedFileSchemeAccess()
browser.extension.isAllowedFileSchemeAccess(): Promise<boolean>
تسترد هذه الطريقة حالة وصول الإضافة إلى المخطط "file://". يتوافق ذلك مع إعداد "السماح بالوصول إلى عناوين URL للملفات" الذي يتحكّم فيه المستخدم لكل إضافة ويمكن الوصول إليه من خلال صفحة chrome://extensions.
المرتجعات
-
Promise<boolean>
الإصدار 99 من Chrome والإصدارات الأحدث browser.* منذ الإصدار 148 من Chrome
isAllowedIncognitoAccess()
browser.extension.isAllowedIncognitoAccess(): Promise<boolean>
تستردّ هذه الطريقة حالة وصول الإضافة إلى وضع التصفّح المتخفي. يتوافق ذلك مع إعداد "مسموح به في وضع التصفّح المتخفي" الذي يتحكّم فيه المستخدم لكل إضافة ويمكن الوصول إليه من خلال صفحة chrome://extensions.
المرتجعات
-
Promise<boolean>
الإصدار 99 من Chrome والإصدارات الأحدث browser.* منذ الإصدار 148 من Chrome
setUpdateUrlData()
browser.extension.setUpdateUrlData(
data: string,
): void
تحدِّد هذه السياسة قيمة مَعلمة CGI الخاصة بـ "ap" والمستخدَمة في عنوان URL الخاص بتحديث الإضافة. ويتم تجاهل هذه القيمة للإضافات التي تتم استضافتها في "معرض إضافات Chrome".
المعلمات
-
البيانات
سلسلة