contextualIdentities.query()

Obtient des informations sur toutes les identités contextuelles ou sur les identités contextuelles correspondant à un argument de filtre donné.

C'est une fonction asynchrone qui renvoie une Promise.

Syntaxe

var getContext = browser.contextualIdentities.query(
  details                  // object
)

Paramètres

details

object. Un objet qui peut être utilisé pour filtrer les identités contextuelles renvoyées. Cela peut contenir l'une des propriétés suivantes :

name Facultatif
string. Renvoie uniquement les identités contextuelles avec ce nom.

Valeur retournée

Une Promise qui sera remplie avec un tableau d'objets  ContextualIdentity chacun décrivant une seule identité. Si la fonctionnalité d'identités contextuelles n'est pas activée, la promesse est rejetée.

Compatibilité du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Aucun support NonEdge Aucun support NonFirefox Support complet 53
Notes
Support complet 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.
Opera Aucun support NonFirefox Android Support complet 53
Notes
Support complet 53
Notes
Notes Before version 57, this method resolves its promise with false if the contextual identities feature is disabled.

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Voir les notes d'implémentation.
Voir les notes d'implémentation.

Exemples

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

Récupérez toutes les identités contextuelles dont les noms sont "my-thing", et consignez leurs noms :

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

Étiquettes et contributeurs liés au document

Contributeurs à cette page : hellosct1
Dernière mise à jour par : hellosct1,