Triggering vibrations from your website
11 Dec, 2018
Most common mobile browsers (excluding safari) allow you to trigger the device's vibration motor from your web application using the Vibration API. The Vibration API is provided to you by the mobile browser itself, it allows for varying lengths of vibration to be specified, as well as letting you set vibration patterns to be followed in the form of an array.
Everything you need to start/stop and create vibration patterns can be accomplished with just the navigator.vibrate() function. It accepts either an integer representing milliseconds or an array of integers representing a vibration pattern.
Starting and stopping vibrations
Simply input the time in milliseconds you want the vibration to last. To stop the vibration, call the function with the value 0ms or an empty array.
//Vibrate for 1 second
//Vibrate for 2 second
Creating vibration patterns
This is done using an array with alternating values for "vibration length" and "wait length". The best way to understand is to see the code.
// Vibrate for one second, wait for half a second, then vibrate for two second
navigator.vibrate([1000, 500, 2000]);
//The pattern can be as long as you desire
navigator.vibrate([500, 200, 1000, 500, 1000]);
If you're reading this on your phone (provided it has a vibration motor and you aren't on safari) you should be able to tap the button in the CodePen below and experience the vibration API in action.
There are quite a few potential applications for this API. For example, haptic feedback in a web-based game, or alerting the user to notifications in a web app just to name a few. Whatever you use it for, always to remember to keep the user's experience in mind so you don't irritate them away from your site.