contextualIdentities.create()

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"

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.

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

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