contextualIdentities.update()

cookieStoreId

string. Идентификатор хранилища куки этой контекстной идентичности. Поскольку у каждой контекстной идентичности есть своё хранилище куки, это служит идентификатором самой контекстной идентичности.

details

object. Объект, содержащий новые значения для свойств, которые вы хотите изменить. Он может содержать следующие свойства:

name Необязательно

string. Новое имя для идентичности. Оно будет отображаться в пользовательском интерфейсе браузера, позволяя им открыть новую вкладку в идентичности. Оно также будет отображаться в строке адреса для вкладок, принадлежащих этой идентичности.

color Необязательно

string. Новый цвет для идентичности. Он будет использоваться для выделения вкладок, принадлежащих этой идентичности. Вы можете указать любое из следующих значений:

• "синий"
• "бирюзовый"
• "зелёный"
• "жёлтый"
• "оранжевый"
• "красный"
• "розовый"
• "фиолетовый"
• "панель инструментов"

icon Необязательно

string. Новый значок для идентичности. Вы можете указать любое из следующих значений:

• "отпечаток пальца"
• "портфель"
• "доллар"
• "корзина"
• "круг"
• "подарок"
• "отпуск"
• "еда"
• "фрукты"
• "животное"
• "дерево"
• "спокойствие"
• "забор"

A Promise, которое будет выполнено с ContextualIdentity, описывающим обновлённую идентичность. Если идентичность не может быть найдена или функция контекстных идентичностей не включена, обещание отклоняется.

В этом примере контекстная идентичность с ID «firefox-container-1» обновляется с новым именем, цветом и значком:

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