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 (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).