contextualIdentities.update()

更新上下文身份的属性，给出其 Cookie 存储 ID。

这是一个异步函数，它返回一个 Promise。

语法

js
let createContext = browser.contextualIdentities.update(
  cookieStoreId,           // string
  details                  // object
)

参数

cookieStoreId

string。此上下文身份的 Cookie 存储的 ID。因为每个上下文身份都有自己的 Cookie 存储，所以它充当上下文身份本身的标识符。

details

object。一个对象，其中包含要更改的属性的新值。它可以包含以下任何属性

name 可选

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

color 可选

string。身份的新颜色。这将用于突出显示属于此身份的标签页。您可以在此处提供以下任何值

  • "蓝色"
  • "青绿色"
  • "绿色"
  • "黄色"
  • "橙色"
  • "红色"
  • "粉色"
  • "紫色"
  • "工具栏"
icon 可选

string。身份的新图标。您可以在此处提供以下任何值

  • "指纹"
  • "公文包"
  • "美元"
  • "购物车"
  • "圆圈"
  • "礼物"
  • "假期"
  • "食物"
  • "水果"
  • "宠物"
  • "树"
  • "放松"
  • "栅栏"

返回值

一个 Promise，它将使用一个 ContextualIdentity 来完成，该对象描述了更新后的身份。如果找不到身份或未启用上下文身份功能，则 promise 将被拒绝。

浏览器兼容性

BCD 表格仅在浏览器中加载

示例

此示例更新了 ID 为“firefox-container-1”的上下文身份，使其具有新的名称、颜色和图标

js
function onUpdated(context) {
  console.log(`New identity's name: ${context.name}.`);
}

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

browser.contextualIdentities
  .update("firefox-container-1", {
    name: "my-thing",
    color: "purple",
    icon: "briefcase",
  })
  .then(onUpdated, onError);