contextualIdentities.create()

details

object。包含新场景身份属性的对象。这包含以下属性：

name

string。新标识的名称。这将显示在浏览器的用户界面中，使用户能够打开属于此身份的新标签。它还将在属于此身份的标签的 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(`新身份的 ID 是：${context.cookieStoreId}。`);
}

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

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