contextualIdentities.create()

语法

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

参数

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

浏览器兼容性