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

規範

瀏覽器相容性