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:nameOptional-
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.
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);
Example extensions
Browser compatibility
| desktop | 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.