Контекстные идентификаторы
Работа с контекстными идентификаторами: список, создание, удаление и обновление контекстных идентификаторов.
«Контекстные идентификаторы», также известные как «контейнеры», — это функция браузера, которая учитывает то, что пользователи принимают на себя несколько идентичностей при просмотре веб-страниц и хотят сохранить некоторое разделение между этими идентичностями. Например, пользователь может рассматривать свою «рабочую идентичность» отдельно от своей «личной идентичности» и не хочет совмещать куки между этими двумя контекстами.
С помощью функции контекстных идентификаторов каждый контекстный идентификатор имеет имя, цвет и значок. Новые вкладки могут быть назначены идентичности, и имя, значок и цвет будут отображаться в адресной строке. Внутренне каждая идентичность получает свой собственный хранилище куки, которое не делится с другими вкладками.
Контекстные идентификаторы — экспериментальная функция в 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 если заданная идентичность не была найдена."] |
? | Нет | ? |
Примеры расширений
© 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