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

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

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxOperaFirefox for Android
Basic supportChrome No support NoEdge No support NoFirefox Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Opera No support NoFirefox Android Full support 53
Notes
Full support 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.

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);

Example extensions

Document Tags and Contributors

Contributors to this page: wbamberg
Last updated by: wbamberg,