Navigator.vibrate()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Метод Navigator.vibrate() пульсирует вибрационным оборудованием на устройстве, если такое аппаратное обеспечение существует. Если устройство не поддерживает вибрацию, этот метод не имеет ни какого эффекта. Если шаблон вибрации уже в процессе выполнения, когда метод вызван, предыдущий шаблон останавливается и вместо него начинается новый.

Если метод не в состоянии вибрировать из-за недействительных параметров, он вернёт false, иначе вернёт true. Если шаблон ведёт к слишком длинной вибрации, он усекается: максимальная длина зависит от конкретной реализации.

Синтаксис

var successBool = window.navigator.vibrate(pattern);
pattern

Определяет шаблон вибрации и интервал паузы. Значение указывает на число миллисекунд вибрации или паузы, при чередовании. Вы можете указать либо одно значение (вибрировать постоянно определённое количество миллисекунд) или массив значений, поочерёдно: вибрировать, пауза, затем снова вибрировать. См. Vibration API для уточнения деталей.

Переданное значение 0 или пустой массив, или массив содержащий все нули отменяет любой шаблон вибрации запущенный в текущий момент.

Примеры

js
window.navigator.vibrate(200); // Вибрировать 200ms
window.navigator.vibrate([
  100, 30, 100, 30, 100, 200, 200, 30, 200, 30, 200, 200, 100, 30, 100, 30, 100,
]); // Вибрировать 'SOS' на азбуке Морзе.

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

Specification
Vibration API (Second Edition)
# dom-navigator-vibrate

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

BCD tables only load in the browser

Смотрите также