browser.extension

شرح

chrome.extension API دارای ابزارهایی است که هر صفحه افزونه‌ای می‌تواند از آن‌ها استفاده کند. این شامل پشتیبانی از تبادل پیام بین یک افزونه و اسکریپت‌های محتوای آن یا بین افزونه‌ها می‌شود، همانطور که به‌طور مفصل در انتقال پیام توضیح داده شده است.

انواع

ViewType

Chrome نسخه ۴۴ و بالاتر browser.* از Chrome نسخه ۱۴۸

نوع نمای افزونه.

شمارشی

«برگه»

"popup"

مشخصات

inIncognitoContext

برای متون محتوایی که در داخل زبانه‌های ناشناس اجرا می‌شوند و برای صفحه‌های افزونه‌ای که در داخل فرایند ناشناس اجرا می‌شوند، True است. مورد دوم فقط برای افزونه‌هایی با incognito_behavior «تقسیم‌شده» اعمال می‌شود.

نوع

بولی

روش‌ها

getBackgroundPage()

فقط پیش‌زمینه 
browser.extension.getBackgroundPage(): Window | undefined

شیء «پنجره» جاوا اسکریپت را برای صفحه پس‌زمینه درحال اجرا در افزونه کنونی برمی‌گرداند. اگر افزونه صفحه پس‌زمینه نداشته باشد، مقدار تهی برمی‌گرداند.

بازگشتی‌ها

  • پنجره | undefined

getViews()

فقط پیش‌زمینه 
browser.extension.getViews(
  fetchProperties?: object,
): Window[]

آرایه‌ای از اشیاء «پنجره» جاوا اسکریپت را برای هریک از صفحه‌هایی که در افزونه فعلی اجرا می‌شوند برمی‌گرداند.

پارامترها

  • fetchProperties

    شیء اختیاری

    • tabId

      شماره اختیاری

      Chrome نسخه ۵۴ و بالاتر browser.* ‎ از Chrome نسخه ۱۴۸

      نمایی را براساس شناسه برگه پیدا کنید. اگر این فیلد حذف شود، همه نماها برگردانده می‌شود.

    • نوع

      ViewType اختیاری

      نوع نمای دریافتی. اگر حذف شود، همه نماها (ازجمله صفحه‌ها و برگه‌های پس‌زمینه) را برمی‌گرداند.

    • windowId

      شماره اختیاری

      پنجره‌ای که جستجو به آن محدود می‌شود. اگر حذف شود، همه نماها را برمی‌گرداند.

بازگشتی‌ها

  • پنجره[]

    آرایه اشیای سراسری

isAllowedFileSchemeAccess()

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

وضعیت دسترسی افزونه به طرح «file://» را بازیابی می‌کند. این با تنظیم «اجازه دسترسی به نشانی‌های وب فایل» برای هر افزونه که توسط کاربر کنترل می‌شود و ازطریق صفحه chrome://extensions قابل‌دسترسی است مطابقت دارد.

بازگشتی‌ها

  • Promise<boolean>

    Chrome نسخه ۹۹ و بالاتر browser.* از Chrome نسخه ۱۴۸

isAllowedIncognitoAccess()

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

وضعیت دسترسی افزونه به «حالت ناشناس» را بازیابی می‌کند. این تنظیم با تنظیم «مجاز در حالت ناشناس» برای هر افزونه که توسط کاربر کنترل می‌شود و ازطریق صفحه chrome://extensions قابل‌دسترسی است مطابقت دارد.

بازگشتی‌ها

  • Promise<boolean>

    Chrome نسخه ۹۹ و بالاتر browser.* از Chrome نسخه ۱۴۸

setUpdateUrlData()

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

مقدار پارامتر ap CGI را که در نشانی وب به‌روزرسانی افزونه استفاده می‌شود تنظیم می‌کند. این مقدار برای افزونه‌هایی که در «گالری افزونه Chrome» میزبانی می‌شوند نادیده گرفته می‌شود.

پارامترها

  • داده

    رشته