contextualIdentities.query()

Liefert Informationen über alle kontextuellen Identitäten oder über die kontextuellen Identitäten, die einem bestimmten Filterargument entsprechen.

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

Syntax

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.

Ein Promise, das mit einem Array von ContextualIdentity Objekten erfüllt wird, wobei jedes eine einzelne Identität beschreibt. Wenn die kontextuelle Identitätsfunktion nicht aktiviert ist, wird das Promise abgelehnt.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Abrufen aller kontextuellen Identitäten und Protokollierung ihrer Namen:

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

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

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

contextual-identities