contextualIdentities.query()

获取有关所有场景身份的信息，或获取与给定过滤参数匹配的场景身份的信息。

这是一个返回 Promise 的异步函数。

语法

let getContext = browser.contextualIdentities.query(
  details                  // 对象
)

参数

details

object。一个用于过滤返回的场景身份的对象。可以包含以下任意属性：

name 可选: string。仅返回具有此名称的场景身份。

返回值

一个 Promise，在场景身份查询完成时其会兑现一个 ContextualIdentity 对象数组，每个对象描述一个身份。如果未启用场景身份特性，则 promise 将被拒绝。

浏览器兼容性

BCD tables only load in the browser

示例

检索所有场景身份，并记录它们的名称：

function onGot(contexts) {
  for (const context of contexts) {
    console.log(`名称：${context.name}`);
  }
}

function onError(error) {
  console.error(error);
}

browser.contextualIdentities.query({}).then(onGot, onError);

检索所有名称为“my-thing”的场景身份，并记录它们的名称：

function onGot(contexts) {
  for (const context of contexts) {
    console.log(`名称：${context.name}`);
  }
}

function onError(error) {
  console.error(error);
}

browser.contextualIdentities
  .query({
    name: "my-thing",
  })
  .then(onGot, onError);

示例扩展

contextual-identities