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.

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

Свойство 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,