Wat is de Vibration API?

De Vibration API (navigator.vibrate()) is een browserstandaard waarmee webpagina's de fysieke trilmotor in smartphones en enkele tablets kunnen activeren. Deze accepteert ofwel een enkele duur in milliseconden, ofwel een afwisselende reeks van trillings- en pauzeduren — een trilpatroon genoemd. De API wordt ondersteund in de meeste Android-browsers; iOS stelt trillingen niet beschikbaar voor webpagina's vanwege platformbeperkingen.

Trilpatronen worden beschreven als arrays waarbij oneven-geïndexeerde waarden trillingsduren vertegenwoordigen en even-geïndexeerde waarden pauzeduren. Bijvoorbeeld: [200, 100, 200] betekent 200 ms trillen, 100 ms pauze, 200 ms trillen. Het aanroepen van navigator.vibrate(0) of navigator.vibrate([]) annuleert onmiddellijk eventuele lopende trillingen.

Gereedschapbeschrijving

Dit gereedschap laat u testen of uw apparaat de Vibration API ondersteunt en kunt u rechtstreeks in de browser met trilpatronen experimenteren. U kunt een enkele puls met instelbare duur activeren, een volledig aangepast kommagescheiden patroon invoeren, of kiezen uit ingebouwde voorinstellingen zoals SOS, hartslag en dubbele/driedubbele pulsen. Een gebeurtenissenlogboek registreert elke trillingpoging met een tijdstempel en het gebruikte patroon, zodat u resultaten op verschillende apparaten en browsers kunt vergelijken.

Voorbeelden

Patrooninvoer Wat gebeurt er
300 Enkele puls van 300 ms
200,100,200 Trillen 200 ms → pauze 100 ms → trillen 200 ms
150,100,150,100,150 Drie korte pulsen met 100 ms tussenruimten
0 Annuleert eventuele lopende trillingen

Functies

  • Detecteert of het apparaat en de browser de Vibration API ondersteunen en geeft de status bij het laden weer
  • Instelbare duur van enkele puls van 10 ms tot 5000 ms via een schuifregelaar
  • Aangepaste patrooninvoer accepteert elke kommagescheiden reeks trillings- en pauzeduren
  • Zes gebruiksklare voorinstellingen: Korte Puls, Lange Puls, Dubbele Puls, Driedubbele Puls, SOS-patroon en Hartslag
  • Gebeurtenissenlogboek met tijdstempels met elk geactiveerd patroon en of het door de browser werd geaccepteerd of afgewezen

Gebruiksscenario's

  • Mobiele webontwikkeling: Controleer of haptische feedback die met de Vibration API is geïmplementeerd, daadwerkelijk op een doelapparaat werkt voordat u de functie uitbrengt.
  • QA-apparaattesting: Bevestig snel dat de trilmotor op een nieuw ontvangen of gerepareerde smartphone werkt zonder een native app te installeren.
  • Patroonprototyping: Herhaal aangepaste trilreeksen (meldingswaarschuwingen, gamefeedback, toegankelijkheidssignalen) door deze live in de browser te testen.

Hoe het werkt

Het gereedschap roept navigator.vibrate(pattern) aan met de waarde die u opgeeft. De browser retourneert true als de aanroep werd geaccepteerd en false als deze werd afgewezen — bijvoorbeeld omdat het document niet in focus is of het apparaat de API niet ondersteunt. Beide resultaten worden in het gebeurtenissenlogboek vastgelegd. Alle verwerking vindt volledig op het apparaat plaats; er worden geen gegevens naar een server verzonden.

Beperkingen

  • iOS (Safari, Chrome op iOS): Apple stelt navigator.vibrate() niet beschikbaar op iOS, dus de API wordt altijd als niet ondersteund gerapporteerd op iPhones en iPads.
  • Desktopbrowsers: Desktopcomputers hebben over het algemeen geen trilmotor, dus zelfs wanneer de API beschikbaar is, heeft deze geen fysiek effect.
  • Achtergrondtabbladen: Sommige browsers wijzen trilverzoeken stilzwijgend af wanneer de pagina niet op de voorgrond staat.
  • Maximale duur: Individuele trilsegmenten worden door de browser beperkt (meestal rond 10 seconden); zeer grote waarden kunnen stilzwijgend worden afgekapt.