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

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, wobei jedes eine einzelne Identität beschreibt. Wenn die kontextuelle Identitätsfunktion nicht aktiviert ist, wird das Promise abgelehnt.

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Firefox for Android
Safari on iOS
query

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
See implementation notes.

Beispiele

Abrufen aller kontextuellen Identitäten und Protokollierung 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);

Abrufen aller kontextuellen Identitäten, deren Namen "my-thing" sind, und Protokollierung 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