Skip to content

samdenty/ios-vibrator-pro-max

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ios-vibrator-pro-max

npm version npm downloads Demo

Finally Safari added an unofficial™️ vibration API. I'm sorry to whoever who let this amazing feature/bug accidentally ship it's way into iOS 18. Tim cook please don't remove it, the web & PWAs need love too.

import "ios-vibrator-pro-max";

navigator.vibrate(1000);

⚠️ Limitations

This polyfill will work without any user interaction on iOS 18 to 18.3. In iOS 18.4 Apple made the vibration require user interaction. Unfortunately the way they did this, the only interaction that counts is a click (unfortunately dragging doesn't count) and the grant expires after 1s. There's no way to keep vibrating after that click grant expires, except to block the main thread - see below to enable that option

Durations longer than 1000ms

This will block the main thread for the duration of the vibration pattern. Only vibration patterns longer than 1s total will block. Blocking is required as it's the only way to extend the trusted event grant of the click handler (async vibrations have expiration)

import { enableMainThreadBlocking } from "ios-vibrator-pro-max";

enableMainThreadBlocking(true);

navigator.vibrate(2000);

About

Bringing the vibrate API for the first time to the web on iOS 18 Safari

Topics

Resources

Stars

Watchers

Forks

Sponsor this project

  •