incognito
Type | String |
---|---|
Mandatory | No |
Example |
|
Use the incognito
key to control how the extension works with private browsing windows.
This is a string which may take any of the following values:
-
"spanning" (the default): the extension will see events from private and non-private windows and tabs. Windows and tabs will get an
incognito
property in theWindow
orTab
that represents them. This property indicates whether or not the object is private:browser.windows.getLastFocused().then((windowInfo) => { console.log(`Window is private: ${windowInfo.incognito}`); });
- "split": the extension will be split between private and non-private windows. There are effectively two copies of the extension running: one sees only non-private windows, the other sees only private windows. Each copy has isolated access to Web APIs (so, for example,
localStorage
is not shared). However, the WebExtension APIstorage.local
is shared. (Note: this setting is not supported by Firefox.) - "not_allowed": private tabs and windows are invisible to the extension.
Example
"incognito": "spanning"
"incognito": "split"
"incognito": "not_allowed"
Browser compatibility
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.