Navigator.vibrate()

La méthode Navigator.vibrate() active le module matériel de vibration de l'appareil, si ce dernier est présent. Si l'appareil ne supporte pas les vibrations, cette méthode n'a aucun effet. Si une série de vibration est déjà en cours, la précédente série est stopée et la nouvelle série est lancée.

Si la méthode ne peut pas vibrer en raison d'arguments invalides, elle retournera false, sinon elle retournera true. Si la série contient de trop longue vibration, elle sera tronqué; la longueur maximale dépend de l'implémentation.

Syntaxe

js
var successBool = window.navigator.vibrate(motif);
motif

Fournit un motif de vibration et d'intervalle de pause. Chaque valeur indique un nombre de milisecondes de vibration ou de pause, en alternance. Vous pouvez fournir une valeur (pour vibrer une fois) ou un tableau de valeur (vibration, pause, vibration ...). Voir l'API Vibration pour plus de détails.

Passer la valeur 0, un tableau vide, ou un tableau de zéro arrêtera toutes les vibrations.

Exemple

js
window.navigator.vibrate(200); // vibre pendant 200ms
window.navigator.vibrate([
  100, 30, 100, 30, 100, 30, 200, 30, 200, 30, 200, 30, 100, 30, 100, 30, 100,
]); // Vibre 'SOS' en Morse.

Spécifications

Specification
Vibration API (Second Edition)
# dom-navigator-vibrate

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi