MDN’s new design is in Beta! A sneak peek: https://blog.mozilla.org/opendesign/mdns-new-design-beta/

Type String
Mandatory No
Example
"incognito": "spanning"
"incognito": "split"
"incognito": "not_allowed"

Use the incognito key to control how the add-on works with private browsing windows.

This is a string which may take any of the following values:

  • "spanning" (the default): the add-on will see events from private and non-private windows and tabs. Windows and tabs will get an incognito property in the Window or Tab 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 add-on will be split between private and non-private windows. There are effectively two copies of the add-on 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 storage.local is shared.
  • "not_allowed": private tabs and windows are invisible to the add-on.

Example

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

Browser compatibility

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic supportYesNo4848Yes
splitYesNoNoNoYes
not_allowedYesNoNoNoYes

Document Tags and Contributors

 Contributors to this page: Brettz9, wbamberg
 Last updated by: Brettz9,