隐身模式

类型 字符串
必需
清单版本 2 或更高版本
示例
json
"incognito": "spanning"
json
"incognito": "split"
json
"incognito": "not_allowed"

使用incognito键控制扩展程序如何在私密浏览窗口中运行。

注意:默认情况下,扩展程序不会在私密浏览窗口中运行。扩展程序是否可以访问私密浏览窗口由用户控制。有关详细信息,请参阅私密浏览中的扩展程序。您的扩展程序可以使用extension.isAllowedIncognitoAccess检查它是否可以访问私密浏览窗口。

这是一个可以采用以下任何值的字符串

  • "spanning"(默认值):扩展程序会看到来自私密和非私密窗口和选项卡的事件。窗口和选项卡在表示它们的WindowTab中获取incognito属性。此属性指示该对象是否为私密对象
    js
    browser.windows.getLastFocused().then((windowInfo) => {
      console.log(`Window is private: ${windowInfo.incognito}`);
    });
    
  • "split":扩展程序在私密和非私密窗口之间拆分。实际上,扩展程序运行了两个副本:一个只看到非私密窗口,另一个只看到私密窗口。每个副本都独立访问 Web API(例如,localStorage未共享)。但是,WebExtension API storage.local是共享的。

    注意:Firefox 不支持“split”模式。在 Firefox 中请求此选项的扩展程序将使用“not_allowed”进行安装。

  • "not_allowed":扩展程序看不到私密选项卡和窗口。

示例

json
"incognito": "spanning"
json
"incognito": "split"
json
"incognito": "not_allowed"

浏览器兼容性

BCD 表格仅在浏览器中加载