contextualIdentities.query()

Erhält Informationen über alle kontextuellen Identitäten oder über diejenigen kontextuellen Identitäten, die einem angegebenen Filterargument entsprechen.

Dies ist eine asynchrone Funktion, die ein Promise zurückgibt.

Syntax

js
let getContext = browser.contextualIdentities.query(
  details                  // object
)

Parameter

details

object. Ein Objekt, das verwendet werden kann, um die zurückgegebenen kontextuellen Identitäten zu filtern. Es kann eine der folgenden Eigenschaften enthalten:

name Optional

string. Gibt nur kontextuelle Identitäten mit diesem Namen zurück.

Rückgabewert

Ein Promise, das mit einem Array von ContextualIdentity-Objekten erfüllt wird. Jedes beschreibt eine einzelne Identität. Wenn die Funktion für kontextuelle Identitäten nicht aktiviert ist, wird das Promise abgelehnt.

Beispiele

Abfrage aller kontextuellen Identitäten und Protokollieren ihrer Namen:

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

Abfrage aller kontextuellen Identitäten, deren Namen "my-thing" sind, und Protokollieren ihrer Namen:

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

Beispielerweiterungen

Browser-Kompatibilität