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
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
incognito | ChromeFull supportYes | EdgeFull support18 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
not_allowed | ChromeFull supportYes | EdgeFull support17 | FirefoxFull support67 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support67 |
spanning | ChromeFull supportYes | EdgeFull support18 | FirefoxFull support48 | OperaFull supportYes | SafariNo supportNo | Firefox for AndroidFull support48 |
split | ChromeFull supportYes | EdgeFull support17 | FirefoxNo supportNo
| OperaFull supportYes | SafariNo supportNo | Firefox for AndroidNo supportNo
|
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
The compatibility table on 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.