LockManager: метод query()

Базовая поддержка Широко доступна

Эта функция хорошо отработана и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с марта 2022 года.

Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.

Примечание: Эта функция доступна в Web Workers.

Метод query() интерфейса LockManager возвращает Promise, который разрешается объектом, содержащим информацию о захваченных и ожидающих блокировках.

Синтаксис

query()

Параметры

Нет.

Возвращаемое значение

A Promise, который разрешается объектом, содержащим моментальный снимок состояния LockManager. Объект имеет следующие свойства:

held: Массив объектов LockInfo для захваченных блокировок.
pending: Массив объектов LockInfo для ожидающих запросов на блокировку.

Объект LockInfo может иметь следующие свойства:

name: Имя, переданное в LockManager.request() при запросе блокировки.
mode: Режим доступа, переданный в LockManager.request() при запросе блокировки. Режим может быть "exclusive" или "shared".
clientId: Уникальный идентификатор контекста, в котором вызывается LockManager.request(). Это то же самое значение, что и Client.id.

Исключения

Этот метод может возвратить промис, отклоненный с 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}`);
}

Спецификации

Спецификация
API веб-блокировок # api-lock-manager-query

Совместимость браузеров

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`query`	69	79	96	56	15.4	69	96	48	15.4	10.0	69

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/LockManager/query