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