incognito
Typ | String |
---|---|
Verpflichtend | Nein |
Manifest-Version | 2 oder höher |
Beispiel |
json
json
json
|
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 imWindow
oderTab
, die sie repräsentiert. Diese Eigenschaft zeigt an, ob das Objekt privat ist oder nicht:jsbrowser.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 APIstorage.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
"incognito": "spanning"
"incognito": "split"
"incognito": "not_allowed"
Browser-Kompatibilität
BCD tables only load in the browser