contextualIdentities.query() - Mozilla

语法

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

参数

details

object。一个可用于筛选返回的上下文标识的对象。这可能包含以下任何属性：

name 可选: string。仅返回名称为此字符串的上下文标识。

返回值

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

示例

检索所有上下文标识，并记录它们的名称

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

浏览器兼容性

帮助改进 MDN

了解如何贡献

此页面最后修改于 ⁨2025年7月17日⁩，作者为 MDN contributors。

在 GitHub 上查看此页面 • 报告此内容的错误