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

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 teableu de zéro arrêtera toutes les vibrations.

Exemple

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 Status Comment
Vibration API Recommendation

Linked to spec is the latest editor's draft; W3C version is a REC.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
vibrateChrome Support complet 32Edge ? Firefox Support complet 16
Notes
Support complet 16
Notes
Notes Until Firefox 26 included, when the vibration pattern was too long or any of its elements too large, Firefox threw an exception instead of returning false (bug 884935).
Notes From Firefox 32 onwards, when the vibration pattern is too long or any of its elements too large, it returns true but truncates the pattern (bug 1014581).
Support complet 11
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : moz
IE Aucun support NonOpera Aucun support NonSafari Aucun support NonWebView Android Support complet 4.4.3
Notes
Support complet 4.4.3
Notes
Notes Beginning in version 55, this is not supported in cross-origin iframes.
Notes Beginning in version 60, this method requires a user gesture. Otherwise it returns false.
Chrome Android Support complet 32
Notes
Support complet 32
Notes
Notes Beginning in Chrome 55, this is not supported in cross-origin iframes.
Notes Beginning in Chrome 60, this method requires a user gesture. Otherwise it returns false.
Firefox Android Support complet 16
Notes
Support complet 16
Notes
Notes Until Firefox 26 included, when the vibration pattern was too long or any of its elements too large, Firefox threw an exception instead of returning false (bug 884935).
Notes From Firefox 32 onwards, when the vibration pattern is too long or any of its elements too large, it returns true but truncates the pattern (bug 1014581).
Support complet 14
Préfixée
Préfixée Nécessite l'utilisation d'un préfixe : moz
Opera Android Support complet Oui
Notes
Support complet Oui
Notes
Notes Beginning in Opera 47, this method requires a user gesture. Otherwise it returns false.
Safari iOS Aucun support NonSamsung Internet Android Support complet Oui

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Compatibilité inconnue  
Compatibilité inconnue
Voir les notes d'implémentation.
Voir les notes d'implémentation.
Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.
Cette fonctionnalité nécessite un préfixe particulier ou utilise un autre nom.

Voir aussi