contextualIdentities.query()

Erhält Informationen über alle kontextuellen Identitäten oder über jene 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 die 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, die jeweils eine einzelne Identität beschreiben. Wenn die Funktion für kontextuelle Identitäten nicht aktiviert ist, wird das Promise abgelehnt.

Browser-Kompatibilität

Beispiele

Rufen Sie alle kontextuellen Identitäten ab und geben Sie ihre Namen aus:

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

Rufen Sie alle kontextuellen Identitäten ab, deren Namen "my-thing" sind, und geben Sie ihre Namen aus:

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