contextualIdentities
Arbeiten Sie mit kontextuellen Identitäten: Listen Sie sie auf, erstellen, entfernen und aktualisieren Sie sie.
„Kontextuelle Identitäten“, auch „Container“ genannt, sind eine Browserfunktion, mit der Benutzer beim Surfen im Web mehrere Identitäten verwenden und diese voneinander getrennt halten können. Beispielsweise möchte ein Benutzer möglicherweise seine „Arbeitsidentität“ von seiner „privaten Identität“ trennen und Cookies nicht zwischen diesen beiden Kontexten teilen.
Bei dieser Funktion hat jede kontextuelle Identität einen Namen, eine Farbe und ein Symbol. Neue Tabs können einer Identität zugewiesen werden; Name, Symbol und Farbe werden in der Adressleiste angezeigt. Intern erhält jede Identität einen eigenen Cookie-Speicher, der nicht mit anderen Tabs geteilt wird. Dieser Cookie-Speicher wird in dieser und anderen APIs durch die cookieStoreId identifiziert.
Kontextuelle Identitäten sind in Firefox eine experimentelle Funktion und standardmäßig nur in Firefox Nightly aktiviert. Um sie in anderen Firefox-Versionen zu aktivieren, setzen Sie die Einstellung privacy.userContext.enabled auf true. Beachten Sie, dass kontextuelle Identitäten zwar in Firefox für Android verfügbar sind, es in dieser Browserversion aber keine Benutzeroberfläche für ihre Verwendung gibt.
Vor Firefox 57 ist die contextualIdentities-API nur verfügbar, wenn die Funktion für kontextuelle Identitäten selbst aktiviert ist. Versuchte eine Erweiterung, die contextualIdentities-API zu verwenden, ohne dass die Funktion aktiviert war, wurden die von den Methodenaufrufen zurückgegebenen Promises mit false erfüllt.
Ab Firefox 57 wird die Funktion für kontextuelle Identitäten automatisch aktiviert, wenn eine Erweiterung installiert wird, die die contextualIdentities-API verwendet. Benutzer können die Funktion jedoch weiterhin über die Einstellung privacy.userContext.enabled deaktivieren. In diesem Fall werden die von contextualIdentities-Methodenaufrufen zurückgegebenen Promises mit einer Fehlermeldung abgelehnt.
Weitere Informationen finden Sie unter Mit kontextuellen Identitäten arbeiten.
Kontextuelle Identitäten werden von keinem anderen Browser unterstützt.
Um diese API zu verwenden, müssen Sie die Berechtigungen „contextualIdentities“ und „cookies“ in Ihre Datei manifest.json aufnehmen.
Typen
contextualIdentities.ContextualIdentity-
Enthält Informationen über eine kontextuelle Identität.
Funktionen
contextualIdentities.create()-
Erstellt eine neue kontextuelle Identität.
contextualIdentities.get()-
Ruft eine kontextuelle Identität anhand ihrer Cookie-Speicher-ID ab.
contextualIdentities.getSupportedColors()-
Gibt die für kontextuelle Identitäten unterstützten Farben zurück.
contextualIdentities.getSupportedIcons()-
Gibt die für kontextuelle Identitäten unterstützten Symbole zurück.
contextualIdentities.move()-
Verschiebt eine oder mehrere kontextuelle Identitäten innerhalb der Liste der kontextuellen Identitäten.
contextualIdentities.query()-
Ruft alle kontextuellen Identitäten oder alle kontextuellen Identitäten mit einem bestimmten Namen ab.
contextualIdentities.update()-
Aktualisiert Eigenschaften einer bestehenden kontextuellen Identität.
contextualIdentities.remove()-
Löscht eine kontextuelle Identität.
Ereignisse
contextualIdentities.onCreated-
Wird ausgelöst, wenn eine kontextuelle Identität erstellt wird.
contextualIdentities.onRemoved-
Wird ausgelöst, wenn eine kontextuelle Identität entfernt wird.
contextualIdentities.onUpdated-
Wird ausgelöst, wenn eine oder mehrere Eigenschaften einer kontextuellen Identität aktualisiert werden.