contextualIdentities.update()

Aktualisiert Eigenschaften einer kontextuellen Identität anhand ihrer Cookie-Store-ID.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let createContext = browser.contextualIdentities.update(
  cookieStoreId,           // string
  details                  // object
)

Parameter

cookieStoreId

string. Die ID des Cookie-Stores dieser kontextuellen Identität. Da jede kontextuelle Identität ihren eigenen Cookie-Store hat, 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. Dies kann eine der 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 es, 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 einer ContextualIdentity erfüllt wird, die die aktualisierte Identität beschreibt. Wenn die Identität nicht gefunden werden konnte oder die kontextuellen Identitätsfunktionen nicht aktiviert sind, wird das Promise abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

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 haben:

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