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
let 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
Optional-
string
. 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
Report problems with this compatibility data on GitHubdesktop | mobile | ||||||
---|---|---|---|---|---|---|---|
query |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- See implementation notes.
Examples
Retrieve all contextual identities, and log their names:
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);
Retrieve all contextual identities whose names are "my-thing", and log their names:
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);