Spec-Zone.ru › Web Extensions

Контекстные идентификаторы

Работа с контекстными идентификаторами: список, создание, удаление и обновление контекстных идентификаторов.

«Контекстные идентификаторы», также известные как «контейнеры», — это функция браузера, которая учитывает то, что пользователи принимают на себя несколько идентичностей при просмотре веб-страниц и хотят сохранить некоторое разделение между этими идентичностями. Например, пользователь может рассматривать свою «рабочую идентичность» отдельно от своей «личной идентичности» и не хочет совмещать куки между этими двумя контекстами.

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

A context menu with "open in new container tab" submenu highlighted. The submenu shows personal, work, banking, and shopping contextual identities.Контекстные идентификаторы — экспериментальная функция в Firefox и по умолчанию включены только в Firefox Nightly. Чтобы включить их в других версиях Firefox, установите privacy.userContext.enabled значение true. Обратите внимание, что, хотя контекстные идентификаторы доступны в Firefox для Android, нет пользовательского интерфейса для работы с ними в этой версии браузера.

До Firefox 57, contextualIdentities API доступен только в том случае, если функция контекстных идентификаторов включена. Если расширение пыталось использовать contextualIdentities API без включенной функции, то вызовы методов разрешали свои обещания с false.

Начиная с Firefox 57, если установлено расширение, использующее contextualIdentities API, то функция контекстных идентификаторов будет включена автоматически. Однако пользователь по-прежнему может отключить функцию с помощью параметра «privacy.userContext.enabled». Если это произойдет, то вызовы методов contextualIdentities будут отклонять свои обещания с сообщением об ошибке.

Дополнительную информацию о контекстных идентификаторах в Firefox см. в этом руководстве.

В настоящее время контекстные идентификаторы не поддерживаются ни в одном другом браузере.

Для использования этого API вам необходимо включить «contextualIdentities» и «cookies» разрешения в вашем файле manifest.json.

Типы

contextualIdentities.ContextualIdentity

Содержит информацию о контекстном идентификаторе.

Функции

contextualIdentities.create()

Создает новый контекстный идентификатор.

contextualIdentities.get()

Извлекает один контекстный идентификатор, задав его идентификатор хранилища куки.

contextualIdentities.query()

Извлекает все контекстные идентификаторы или все контекстные идентификаторы с определённым именем.

contextualIdentities.update()

Обновляет свойства существующего контекстного идентификатора.

contextualIdentities.remove()

Удаляет контекстный идентификатор.

События

contextualIdentities.onCreated

Вызывается при создании контекстного идентификатора.

contextualIdentities.onRemoved

Вызывается при удалении контекстного идентификатора.

contextualIdentities.onUpdated

Вызывается при обновлении одного или нескольких свойств контекстного идентификатора.

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

Рабочий стол Мобильный
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet
create Нет Нет
53До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.
? Нет Нет ? ?
53До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.
? Нет ?
get Нет Нет
53["До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.", "До версии 57 этот метод разрешал своё обещание с null если заданная идентичность не была найдена."]
? Нет Нет ? ?
53["До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.", "До версии 57 этот метод разрешал своё обещание с null если заданная идентичность не была найдена."]
? Нет ?
onCreated Нет Нет 57 ? Нет Нет ? ? 57 ? Нет ?
onRemoved Нет Нет 57 ? Нет Нет ? ? 57 ? Нет ?
onUpdated Нет Нет 57 ? Нет Нет ? ? 57 ? Нет ?
query Нет Нет
53До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.
? Нет Нет ? ?
53До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.
? Нет ?
remove Нет Нет
53["До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.", "До версии 57 этот метод разрешал своё обещание с null если заданная идентичность не была найдена."]
? Нет Нет ? ?
53["До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.", "До версии 57 этот метод разрешал своё обещание с null если заданная идентичность не была найдена."]
? Нет ?
update Нет Нет
53["До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.", "До версии 57 этот метод разрешал своё обещание с null если заданная идентичность не была найдена."]
? Нет Нет ? ?
53["До версии 57 этот метод разрешал своё обещание с false если функция контекстных идентификаторов была отключена.", "До версии 57 этот метод разрешал своё обещание с null если заданная идентичность не была найдена."]
? Нет ?

Примеры расширений

  • contextual-identities

© 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

Spec-Zone.ru

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