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
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:
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:
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
Loading…