incognito

类型 String
必填
Manifest 版本 2 或更高
示例
json
"incognito": "spanning"
json
"incognito": "split"
json
"incognito": "not_allowed"

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

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

这是一个可以接受以下任一值的字符串

  • "spanning" (默认值):扩展程序可以看到来自隐私和非隐私窗口以及标签页的事件。窗口和标签页将获得一个 incognito 属性,该属性位于表示它们的 WindowTab 中。此属性指示该对象是否为私有

    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"

浏览器兼容性