Spec-Zone.ru › Web Extensions

contextualIdentities.create()

Создаёт новую контекстную идентичность. После создания пользователь сможет создавать новые вкладки, принадлежащие этой контекстной идентичности, так же, как и с встроенными идентичностями.

Это асинхронная функция, которая возвращает Promise.

Синтаксис

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

Параметры

details

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

name

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

color

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

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

string. Имя значка для отображения в адресной строке для вкладок, принадлежащих данной идентичности. Здесь можно указать любое из следующих значений:

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

Возвращаемое значение

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

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet
create Нет Нет
53Перед версией 57, этот метод разрешает своё обещание с false если функция контекстных идентичностей отключена.
? Нет Нет ? ?
53Перед версией 57, этот метод разрешает своё обещание с false если функция контекстных идентичностей отключена.
? Нет ?

Примеры

В этом примере создаётся новая контекстная идентичность и выводится её идентификатор хранилища cookie:

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

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/contextualIdentities/create

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API