Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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