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.
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 | 53 | 53 | No |
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);