El método Navigator.vibrate() usa el hardware de vibración en el dispositivo, si existe tal hardware. Si el dispositivo no admite vibración, este método no se verá afectado. Si un patrón de vibración ya había comenzado cuando se llamó a este método, el patrón anterior se detendrá y se iniciará el nuevo en su lugar.
Si colocamos parámetros inválidos dentro del método, entonces no vibrará y devolverá falso, de lo contrario, devolverá verdadero. Si la vibración es demasiado larga de nuestro patrón, entonces se trunca. La longitud máxima depende de la implementación.
Sintaxis:
var successBool = window.navigator.vibrate( pattern );
Parámetros: este método acepta un patrón de parámetro único que proporciona un patrón para los intervalos de vibración y pausa. Tanto los valores de vibración como los de intervalo están en alternancia y los valores están en milisegundos. Podemos proporcionar un valor único o una array de valores. Pasar 0, una array vacía o una array de ceros como parámetro cancelará cualquier vibración en curso actual.
Valor de retorno: devuelve verdadero en caso de éxito; de lo contrario, devuelve falso.
Los siguientes ejemplos ilustran el método Navigator.vibrate() en la API de vibración HTML:
Ejemplo 1:
// To check that is vibration API supported
if (navigator.vibrate) {
window.navigator.vibrate(200);
}
Producción:
Vibrates for 200 milliseconds
Ejemplo 2:
// To check that is vibration API supported
if (navigator.vibrate) {
window.navigator.vibrate(0);
}
Producción:
Will cancel any currently ongoing vibration pattern
Ejemplo 3:
// To check that is vibration API supported
if (navigator.vibrate) {
window.navigator.vibrate([100, 30, 100, 30, 100, 30, 200,
30, 200, 30, 200, 30, 100, 30, 100, 30, 100]);
}
Producción:
Vibrate 'SOS' in Morse
Navegadores compatibles: los navegadores compatibles con Web Vibration API Navigator.vibrate() Method se enumeran a continuación:
- Google Chrome 32 o superior
- Firefox 16 o superior