Navigator.vibrate()

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

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

Синтаксис

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

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

Примеры

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' на азбуке Морзе.

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

Спецификация Статус Комментарий
Vibration API Рекомендация Связанный со спецификацией недавний редакторский черновик; W3C версия REC.

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

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help! (en-US)
Свойство Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) webkit (en-US) 11.0 (11.0) moz (en-US)
16.0 (16.0) (no prefix) [1]
Нет Нет Нет
Свойство Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) webkit (en-US) 11.0 (11.0) moz (en-US)
16.0 (16.0) (no prefix) [1]
Нет Нет Нет

[1] Когда шаблон вибрации слишком долгий или какой-либо из его элементов слишком большой, до Firefox 26 и включая его , Gecko сбрасывал исключение, вместо возврата false (баг 884935). До Firefox 32 и далее, возвращалось true, но обрезался шаблон (баг 1014581).

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