Gets information about all contextual identities, or about those contextual identities that match a given filter argument.
This is an asynchronous function that returns a Promise
.
Syntax
var getContext = browser.contextualIdentities.query( details // object )
Parameters
details
-
object
. An object that can be used to filter the contextual identities returned. This may contain any of the following properties:name
Optionalstring
. Return only contextual identities with this name.
Return value
A Promise
that will be fulfilled with an array of ContextualIdentity
objects, each describing a single identity. If the contextual identities feature is not enabled, the promise is rejected.
Browser compatibility
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Chrome | Edge | Firefox | Firefox for Android | Opera | |
---|---|---|---|---|---|
Basic support | No | No | 531 | 531 | No |
1. Before version 57, this method resolves its promise with false
if the contextual identities feature is disabled.
Examples
Retrieve all contextual identities, and log their names:
function onGot(contexts) { for (let context of contexts) { console.log(`Name: ${context.name}`); } } function onError(e) { console.error(e); } browser.contextualIdentities.query({}).then(onGot, onError);
Retrieve all contextual identities whose names are "my-thing", and log their names:
function onGot(contexts) { for (let context of contexts) { console.log(`Name: ${context.name}`); } } function onError(e) { console.error(e); } browser.contextualIdentities.query({ name: "my-thing" }).then(onGot, onError);