contextualIdentities.create()

Erstellt eine neue kontextuelle Identität. Einmal erstellt, kann der Benutzer neue Tabs erstellen, die zu dieser kontextuellen Identität gehören, genauso wie bei den eingebauten Identitäten.

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

Syntax

js
let createContext = browser.contextualIdentities.create(
  details                  // object
)

Parameter

details

object. Ein Objekt, das Eigenschaften für die neue kontextuelle Identität enthält. Es enthält folgende Eigenschaften:

name

string. Der Name der neuen Identität. Dieser wird in der Benutzeroberfläche des Browsers angezeigt, wodurch der Benutzer einen neuen Tab öffnen kann, der zu dieser Identität gehört. Er wird auch in der URL-Leiste für Tabs angezeigt, die zu dieser Identität gehören.

color

string. Die mit der neuen Identität assoziierte Farbe. 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

string. Der Name eines Symbols, das in der URL-Leiste für Tabs angezeigt wird, die zu dieser Identität gehören. Sie können hier 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 neue Identität beschreibt. Ist die Funktion der kontextuellen Identitäten nicht aktiviert, wird das Promise abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Dieses Beispiel erstellt eine neue kontextuelle Identität und protokolliert deren Cookie-Store-ID:

js
function onCreated(context) {
  console.log(`New identity's ID: ${context.cookieStoreId}.`);
}

function onError(e) {
  console.error(e);
}

browser.contextualIdentities
  .create({
    name: "my-thing",
    color: "purple",
    icon: "briefcase",
  })
  .then(onCreated, onError);