contextualIdentities.update()
Aktualisiert Eigenschaften einer kontextuellen Identität anhand ihrer Cookie-Store-ID.
Dies ist eine asynchrone Funktion, die ein Promise
zurückgibt.
Syntax
let createContext = browser.contextualIdentities.update(
cookieStoreId, // string
details // object
)
Parameter
-
string
. Die ID des Cookie-Stores dieser kontextuellen Identität. Da kontextuelle Identitäten jeweils ihren eigenen Cookie-Store haben, dient dies als Identifikator für die kontextuelle Identität selbst. details
-
object
. Ein Objekt, das neue Werte für die Eigenschaften enthält, die Sie ändern möchten. Es kann folgende Eigenschaften enthalten:name
Optional-
string
. Ein neuer Name für die Identität. Dieser wird in der Benutzeroberfläche des Browsers angezeigt und ermöglicht es ihnen, einen neuen Tab in der Identität zu öffnen. Er wird auch in der URL-Leiste für Tabs angezeigt, die zu dieser Identität gehören. color
Optional-
string
. Eine neue Farbe für die Identität. Diese wird verwendet, um Tabs hervorzuheben, die zu dieser Identität gehören. Sie können einen der folgenden Werte angeben:- "blue"
- "turquoise"
- "green"
- "yellow"
- "orange"
- "red"
- "pink"
- "purple"
- "toolbar"
icon
Optional-
string
. Ein neues Symbol für die Identität. Sie können einen der folgenden Werte angeben:- "fingerprint"
- "briefcase"
- "dollar"
- "cart"
- "circle"
- "gift"
- "vacation"
- "food"
- "fruit"
- "pet"
- "tree"
- "chill"
- "fence"
Rückgabewert
Ein Promise
, das mit einem ContextualIdentity
erfüllt wird, das die aktualisierte Identität beschreibt. Wenn die Identität nicht gefunden werden konnte oder die Funktionalität für kontextuelle Identitäten nicht aktiviert ist, wird das Versprechen abgelehnt.
Beispiele
Dieses Beispiel aktualisiert die kontextuelle Identität, deren ID "firefox-container-1" ist, um einen neuen Namen, eine neue Farbe und ein neues Symbol zu erhalten:
function onUpdated(context) {
console.log(`New identity's name: ${context.name}.`);
}
function onError(e) {
console.error(e);
}
browser.contextualIdentities
.update("firefox-container-1", {
name: "my-thing",
color: "purple",
icon: "briefcase",
})
.then(onUpdated, onError);