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

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

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

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

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

• Vibration API