contextualIdentities.update()

Syntax

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 diese kontextuelle Identität.

details

object. Ein Objekt, das neue Werte für die Eigenschaften enthält, die Sie ändern möchten. Dieses Objekt kann jede dieser Eigenschaften enthalten:

name Optional

string. Ein neuer Name für die Identität. Dieser Name wird in der Benutzeroberfläche des Browsers angezeigt und ermöglicht es den Benutzern, eine neue Registerkarte in der Identität zu öffnen. Er wird auch in der URL-Leiste für Registerkarten angezeigt, die zu dieser Identität gehören.

color Optional

string. Eine neue Farbe für die Identität. Diese Farbe wird verwendet, um Registerkarten zu kennzeichnen, die zu dieser Identität gehören. Siehe contextualIdentities.getSupportedColors() für Details zu den unterstützten Farbwerten.

icon Optional

string. Ein neues Symbol für die Identität. Siehe contextualIdentities.getSupportedIcons() für Details zu den unterstützten Symbolwerten.

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.

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

Browser-Kompatibilität