Navigator: метод vibrate()

Ограниченная доступность

Эта функция не относится к Baseline, так как она не работает в некоторых из наиболее широко используемых браузеров.

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

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

Синтаксис

vibrate(pattern)

Параметры

pattern: Задает шаблон вибрации и пауз. Каждое значение указывает количество миллисекунд для вибрации или паузы, поочередно. Вы можете указать одно значение (для однократной вибрации на это количество миллисекунд) или массив значений для чередования вибрации, паузы и повторной вибрации. Подробности см. в API вибрации.

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

Возвращаемое значение

Булево значение.

Безопасность

Требуется активизация пользователя. Пользователь должен взаимодействовать со страницей или элементом пользовательского интерфейса для работы этой функции.

Примеры

navigator.vibrate(200); // vibrate for 200ms
navigator.vibrate([
  100, 30, 100, 30, 100, 30, 200, 30, 200, 30, 200, 30, 100, 30, 100, 30, 100,
]); // Vibrate 'SOS' in Morse.

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

Спецификация
API вибрации # dom-navigator-vibrate

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

	Рабочие столы					Мобильные устройства
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на IOS	Samsung Internet	WebView Android
`vibrate`	32	79	16–129 ["До Firefox 26 включительно, если шаблон вибрации был слишком длинным или какой-либо его элемент слишком большим, Firefox выбрасывал исключение вместо возвращения `false` (ошибка 884935).", "Начиная с Firefox 32, если шаблон вибрации слишком длинный или любой из его элементов слишком большой, возвращается `true`, но шаблон усекается (ошибка 1014581).", "Начиная с Firefox 72, это не поддерживается в фреймах с разными доменами."] 11–16	19	Нет	32 ["Начиная с Chrome 55, это не поддерживается в фреймах с разными доменами.", "Начиная с Chrome 60, для этого метода требуется действие пользователя. В противном случае возвращается `false`."]	79 Вибрация отключена. Если окно отображается, то `navigator.vibrate()` возвращает `true`, но вибрации не происходит (независимо от поддержки аппаратного обеспечения). Изначально задумывалось отключить это только для фреймов с разными доменами (ошибка 1591113), но функция не была включена обратно из-за опасений злоупотребления (ошибка 1653318). 16–79 ["До Firefox 26 включительно, если шаблон вибрации был слишком длинным или какой-либо его элемент слишком большим, Firefox выбрасывал исключение вместо возвращения `false` (ошибка 884935).", "Начиная с Firefox 32, если шаблон вибрации слишком длинный или любой из его элементов слишком большой, возвращается `true`, но шаблон усекается (ошибка 1014581)."] 14–16	19 ["Начиная с Opera 42, это не поддерживается в фреймах с разными доменами.", "Начиная с Opera 47, для этого метода требуется действие пользователя. В противном случае возвращается `false`."]	Нет	2.0 ["Начиная с Chrome 55, это не поддерживается в фреймах с разными доменами.", "Начиная с Chrome 60, для этого метода требуется действие пользователя. В противном случае возвращается `false`."]	4.4.3 ["Начиная с версии 55, это не поддерживается в фреймах с разными доменами.", "Начиная с версии 60, для этого метода требуется действие пользователя. В противном случае возвращается `false`."]

См. также

API вибрации

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Navigator/vibrate