contextualIdentities.query()

获取所有上下文标识的信息，或获取与给定过滤器参数匹配的上下文标识的信息。

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

语法

let getContext = browser.contextualIdentities.query(
  details                  // object
)

参数

details

object. 可以用来过滤返回的上下文标识的对象。它可以包含以下任何属性

name 可选: string. 只返回名称为该名称的上下文标识。

返回值

一个 Promise，它将以一个 ContextualIdentity 对象数组的形式完成，每个对象描述一个单独的标识。如果未启用上下文标识功能，则 promise 将被拒绝。

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。

示例

检索所有上下文标识，并记录其名称

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

检索所有名称为“my-thing”的上下文标识，并记录其名称

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

扩展示例

contextual-identities