contextualIdentities.update()

cookieStoreId

string. Die ID des Cookie-Stores dieser kontextuellen Identität. Da kontextuelle Identitäten jeweils ihren eigenen Cookie-Store haben, dient dies als Bezeichner 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. Dies kann die folgenden 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 das Öffnen eines neuen Tabs in der Identität. 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 hier 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 hier einen der folgenden Werte angeben:

• "fingerprint"
• "briefcase"
• "dollar"
• "cart"
• "circle"
• "gift"
• "vacation"
• "food"
• "fruit"
• "pet"
• "tree"
• "chill"
• "fence"

Ein Promise, das mit einer ContextualIdentity erfüllt wird, die die aktualisierte Identität beschreibt. Wenn die Identität nicht gefunden werden konnte oder das Feature für kontextuelle Identitäten nicht aktiviert ist, wird das Promise abgelehnt.

Dieses Beispiel aktualisiert die kontextuelle Identität, deren ID "firefox-container-1" ist, mit einem neuen Namen, einer neuen Farbe und einem neuen Symbol:

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);