LockManager：query() 方法

语法

query()

参数

无。

返回值

一个 Promise，解析为一个包含 LockManager 状态快照的对象。该对象具有以下属性：

held

已持有锁的 LockInfo 对象数组。

pending

待定锁请求的 LockInfo 对象数组。

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

name

请求锁时传递给 LockManager.request() 的名称。

模式

请求锁时传递给 LockManager.request() 的访问模式。模式为 "exclusive"（独占）或 "shared"（共享）。

clientId

调用 LockManager.request() 的上下文的唯一标识符。这与 Client.id 的值相同。

异常

此方法可能会返回一个被拒绝的 Promise，并带有以下类型的 DOMException：

InvalidStateError DOMException

如果环境的文档尚未完全激活，则抛出此异常。

SecurityError DOMException

如果无法获得当前环境的锁管理器，则抛出此异常。

示例

const state = await navigator.locks.query();
for (const lock of state.held) {
  console.log(`held lock: name ${lock.name}, mode ${lock.mode}`);
}
for (const request of state.pending) {
  console.log(`requested lock: name ${request.name}, mode ${request.mode}`);
}

规范

浏览器兼容性