contextualIdentities.query()
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
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
Report problems with this compatibility data on GitHubwebextensions-desktop | webextensions-mobile | |||||
---|---|---|---|---|---|---|
query | ChromeNo supportNo | EdgeNo supportNo | FirefoxFull support53
| OperaNo supportNo | SafariNo supportNo | Firefox for AndroidFull support53
|
Legend
- Full support
- Full support
- No support
- No support
- See implementation notes.
The compatibility table on 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.
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);