contextualIdentities.query()
Получает информацию обо всех контекстуальных идентификаторах или о тех, которые соответствуют заданному фильтру.
Это асинхронная функция, которая возвращает Promise.
Синтаксис
let getContext = browser.contextualIdentities.query( details // object )
Параметры
details-
object. Объект, который может использоваться для фильтрации возвращаемых контекстуальных идентификаторов. Он может содержать следующие свойства:-
nameНеобязательно -
string. Возвращать только контекстуальные идентификаторы с этим именем.
-
Возвращаемое значение
A Promise, который будет выполнен с массивом ContextualIdentity объектов, каждый из которых описывает отдельный идентификатор. Если функция контекстуальных идентификаторов не включена, обещание отклоняется.
Совместимость с браузерами
| Рабочий стол | Мобильные устройства | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari на IOS | Samsung Internet | |
query |
Нет | Нет | 53До версии 57 этот метод выполнял обещание сfalse если функция контекстуальных идентификаторов была отключена. |
? | Нет | Нет | ? | ? | 53До версии 57 этот метод выполнял обещание сfalse если функция контекстуальных идентификаторов была отключена. |
? | Нет | ? |
Примеры
Получить все контекстуальные идентификаторы и вывести их имена:
function onGot(contexts) { for (const context of contexts) { console.log(`Name: ${context.name}`); } } function onError(error) { console.error(error); } browser.contextualIdentities.query({}).then(onGot, onError);
Получить все контекстуальные идентификаторы, имена которых "my-thing", и вывести их имена:
function onGot(contexts) { for (const context of contexts) { console.log(`Name: ${context.name}`); } } function onError(error) { console.error(error); } browser.contextualIdentities .query({ name: "my-thing", }) .then(onGot, 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/query