Клавиатура: метод lock()

Метод lock() интерфейса Keyboard возвращает Promise, который разрешается после включения захвата нажатий клавиш для любой или всех клавиш на физической клавиатуре. Данный метод может захватывать только те клавиши, которым предоставлен доступ основной операционной системой.

Если lock() вызывается несколько раз, то будут заблокированы только коды клавиш, указанные в последнем вызове. Любые клавиши, заблокированные предыдущим вызовом lock(), разблокируются.

keyCodes Необязательно

Массив Array одного или нескольких кодов клавиш для блокировки. Если коды клавиш не указаны, будут заблокированы все клавиши. Список допустимых значений кодов можно найти в спецификации значений кодов UI-событий KeyboardEvent.

Promise, который разрешается со значением undefined при успешной блокировке.

AbortError DOMException

Выбрасывается, если новый вызов lock() выполнен до завершения текущего.

InvalidAccessError DOMException

Выбрасывается, если какая-либо клавиша в keyCodes не является допустимым значением атрибута кода клавиши.

InvalidStateError DOMException

Выбрасывается, если lock() не вызывается в активном контексте верхнего уровня браузера.

Требуется временная активация пользователя. Пользователь должен взаимодействовать со страницей или элементом пользовательского интерфейса, чтобы эта функция работала.

Следующий пример захватывает все нажатия клавиш.

navigator.keyboard.lock();

Следующий пример захватывает клавиши "W", "A", "S" и "D". Он захватывает эти клавиши независимо от используемых модификаторов при нажатии. Предполагая стандартную раскладку US QWERTY, регистрация "KeyW" гарантирует, что "W", Shift+"W", Control+"W", Control+Shift+"W", и все другие сочетания клавиш с "W" будут отправлены в приложение. То же самое относится к "KeyA", "KeyS" и "KeyD".

navigator.keyboard.lock(["KeyW", "KeyA", "KeyS", "KeyD"]);