此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

contextualIdentities.query()

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

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

语法

参数

details

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

name 可选

string。仅返回具有此名称的场景身份。

返回值

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

浏览器兼容性

示例

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

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

示例扩展