browser.extension

说明

chrome.extension API 具有可供任何扩展程序页面使用的实用程序。它支持在扩展程序与其内容脚本之间或扩展程序之间交换消息,如消息传递中所详述。

类型

ViewType

Chrome 44 及更高版本 browser.*(自 Chrome 148 起)

扩展程序视图的类型。

枚举

"tab"

"popup"

属性

inIncognitoContext

对于在无痕式标签页中运行的内容脚本,以及在无痕式进程中运行的扩展程序页面,此值为 true。后者仅适用于 incognito_behavior 为“split”的扩展程序。

类型

布尔值

方法

getBackgroundPage()

仅限前台
browser.extension.getBackgroundPage(): Window | undefined

返回当前扩展程序中运行的后台网页的 JavaScript“window”对象。如果扩展程序没有后台页面,则返回 null。

返回

  • Window | undefined

getViews()

仅限前台
browser.extension.getViews(
  fetchProperties?: object,
)
: Window[]

返回一个数组,其中包含当前扩展程序中运行的每个页面的 JavaScript“window”对象。

参数

  • fetchProperties

    对象(可选)

    • tabId

      number 可选

      Chrome 54 及更高版本 browser.*(自 Chrome 148 起)

      根据标签页 ID 查找视图。如果省略此字段,则会返回所有视图。

    • 类型

      ViewType 可选

      要获取的视图类型。如果省略,则返回所有视图(包括后台网页和标签页)。

    • windowId

      number 可选

      要将搜索范围限制在其中的窗口。如果省略,则返回所有视图。

返回

  • Window[]

    全局对象数组

isAllowedFileSchemeAccess()

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

检索扩展程序对“file://”架构的访问状态。此政策对应的是用户控制的“允许访问文件网址”设置,该设置针对每个扩展程序,可通过 chrome://extensions 页面访问。

返回

  • Promise<boolean>

    Chrome 99 及更高版本 browser.*(自 Chrome 148 起)

isAllowedIncognitoAccess()

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

检索扩展程序对无痕模式的访问状态。这对应于用户控制的、可通过 chrome://extensions 页面访问的每个扩展程序的“在无痕模式下启用”设置。

返回

  • Promise<boolean>

    Chrome 99 及更高版本 browser.*(自 Chrome 148 起)

setUpdateUrlData()

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

设置扩展程序更新网址中使用的 ap CGI 参数的值。对于托管在 Chrome 扩展程序库中的扩展程序,此值会被忽略。

参数

  • 数据

    字符串