contextualIdentities.create()

details

object。包含新上下文标识属性的对象。它包含以下属性

name

string。新标识的名称。这将在浏览器的 UI 中显示，使他们能够打开属于该标识的新标签页。它还将在属于该标识的标签页的 URL 栏中显示。

color

string。与新标识关联的颜色。这将用于突出显示属于该标识的标签页。您可以在这里提供以下任何值

• "blue"
• "turquoise"
• "green"
• "yellow"
• "orange"
• "red"
• "pink"
• "purple"
• "toolbar"

icon

string。要在属于该标识的标签页的 URL 栏中显示的图标名称。您可以在这里提供以下任何值

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

一个 Promise，它将使用描述新标识的 ContextualIdentity 来完成。如果上下文标识功能未启用，则 promise 会被拒绝。

此示例创建一个新的上下文标识并记录其 Cookie 存储 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);