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