此页面由 Cloud Translation API 翻译。

chrome.extension

说明

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

类型

ViewType

Chrome 44 及更高版本

扩展程序视图的类型。

枚举

"tab"

"popup"

属性

inIncognitoContext

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

类型

布尔值

方法

getBackgroundPage()

仅限前台

chrome.extension.getBackgroundPage()

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

Window | undefined

getViews()

仅限前台

chrome.extension.getViews(
  fetchProperties?: object,
)

针对当前扩展程序中运行的每个网页返回 JavaScript“window”对象的数组。

参数

fetchProperties

对象（可选）
- tabId
  
  number 可选
  
  Chrome 54 及更高版本
  
  根据标签页 ID 查找视图。如果省略此字段，则返回所有视图。
- 类型
  
  ViewType（可选）
  
  要获取的视图类型。如果省略，则返回所有视图（包括后台页面和标签页）。
- windowId
  
  number 可选
  
  要将搜索范围限制在其中的窗口。如果省略，则返回所有视图。

Window[]

全局对象的数组

isAllowedFileSchemeAccess()

prometido

chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

检索扩展程序对“file://”架构的访问权限状态。这与用户可通过 chrome://extensions 页面控制的各个扩展程序的“允许访问文件网址”设置相对应。

参数

callback

函数（可选）

callback 参数如下所示：
```
(isAllowedAccess: boolean) => void
```
- isAllowedAccess
  
  布尔值
  
  如果扩展程序可以访问“file://”架构，则为 true，否则为 false。

Promise<boolean>

Chrome 99 及更高版本

清单 V3 及更高版本支持 Promise，但为了实现向后兼容性，我们提供了回调。您不能在同一函数调用中同时使用这两种方法。promise 的解析结果与传递给回调的类型相同。

isAllowedIncognitoAccess()