Метод 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!

Свойство Chrome Firefox (Gecko) Internet Explorer Opera Safari
Базовая поддержка (Да) webkit 11.0 (11.0) moz
16.0 (16.0) (no prefix) [1]
Нет Нет Нет
Свойство Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile
Базовая поддержка (Да) webkit 11.0 (11.0) moz
16.0 (16.0) (no prefix) [1]
Нет Нет Нет

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

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

Метки документа и участники

Внесли вклад в эту страницу: AlexAlex
Обновлялась последний раз: AlexAlex,