大网数据广告活动
Web 标准与前端开发

LockManager:query() 方法

· 52CE 我爱测

LockManager 接口的 **`query()`** 方法返回一个 Promise,该对象兑现一个包含持有中的锁和请求中的锁的信息的对象。

Web Locks API

LockManager 接口的 query() 方法返回一个 Promise,该对象兑现一个包含持有中的锁和请求中的锁的信息的对象。

语法

query()

参数

无。

返回值

一个 Promise,兑现一个包含 LockManager 状态快照的对象。该对象具有以下属性:

  • held
    • : 一个持有中的锁的 LockInfo 对象数组。
  • pending
    • : 一个请求中的锁的 LockInfo 对象数组。

LockInfo 对象可以具有以下属性:

  • name
    • : 请求锁时传递给 LockManager.request() 的名称。
  • mode
    • : 请求锁时传递给 LockManager.request() 的模式。该模式可以是 "exclusive" 或 "shared"。
  • clientId
    • : 调用 LockManager.request() 的上下文的唯一标识。该值与 Client.id 相同。

异常

此方法可能会返回一个被以下类型的 DOMException 之一拒绝的 promise:

  • InvalidStateError DOMException
    • : 如果当前环境的文档未完全激活,则抛出该异常。
  • SecurityError DOMException
    • : 如果无法获取当前环境的锁管理器,则抛出该异常。

示例

const state = await navigator.locks.query();
for (const lock of state.held) {
  console.log(`持有中的锁:名称 ${lock.name},模式 ${lock.mode}`);
}
for (const request of state.pending) {
  console.log(`请求中的锁:名称 ${request.name},模式 ${request.mode}`);
}

规范

浏览器兼容性

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。