incognito

Typ String
Verpflichtend Nein
Manifest-Version 2 oder höher
Beispiel
json
"incognito": "spanning"
json
"incognito": "split"
json
"incognito": "not_allowed"

Verwenden Sie den incognito-Schlüssel, um zu steuern, wie die Erweiterung mit privaten Browsing-Fenstern arbeitet.

Hinweis: Standardmäßig laufen Erweiterungen nicht in privaten Browsing-Fenstern. Ob eine Erweiterung auf private Browsing-Fenster zugreifen kann, liegt in der Kontrolle des Benutzers. Für Details siehe Erweiterungen im privaten Modus. Ihre Erweiterung kann prüfen, ob sie auf private Browsing-Fenster zugreifen kann, indem sie extension.isAllowedIncognitoAccess verwendet.

Dies ist ein String, der einen der folgenden Werte annehmen kann:

  • "spanning" (Standard): Die Erweiterung sieht Ereignisse aus privaten und nicht-privaten Fenstern und Tabs. Fenster und Tabs erhalten eine incognito-Eigenschaft im Window oder Tab, die sie repräsentiert. Diese Eigenschaft zeigt an, ob das Objekt privat ist oder nicht:

    js
    browser.windows.getLastFocused().then((windowInfo) => {
      console.log(`Window is private: ${windowInfo.incognito}`);
    });
    
  • "split": Die Erweiterung ist zwischen privaten und nicht-privaten Fenstern aufgeteilt. Es laufen effektiv zwei Kopien der Erweiterung: eine sieht nur nicht-private Fenster, die andere sieht nur private Fenster. Jede Kopie hat isolierten Zugriff auf Web-APIs (zum Beispiel wird localStorage nicht geteilt). Allerdings wird die WebExtension API storage.local geteilt.

    Hinweis: Firefox unterstützt den "split"-Modus nicht. Erweiterungen, die diese Option in Firefox anfordern, werden mit der Einstellung "not_allowed" installiert.

  • "not_allowed": Private Tabs und Fenster sind für die Erweiterung unsichtbar.

Beispiel

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

Browser-Kompatibilität

BCD tables only load in the browser