O que é a Vibration API?

A Vibration API (navigator.vibrate()) é um padrão de navegador que permite que páginas web acionem o motor de vibração física integrado em smartphones e alguns tablets. Ela aceita uma única duração em milissegundos ou um array alternado de durações de vibração/pausa — chamado de padrão de vibração. A API é suportada na maioria dos navegadores Android; iOS não expõe vibração para páginas web devido a restrições da plataforma.

Padrões de vibração são descritos como arrays onde valores em índices ímpares representam durações de vibração e valores em índices pares representam durações de pausa. Por exemplo, [200, 100, 200] significa vibrar 200 ms, pausar 100 ms, vibrar 200 ms. Chamar navigator.vibrate(0) ou navigator.vibrate([]) cancela qualquer vibração em andamento imediatamente.

Descrição da ferramenta

Esta ferramenta permite testar se seu dispositivo suporta a Vibration API e experimentar padrões de vibração diretamente no navegador. Você pode acionar um único pulso com duração configurável, inserir um padrão totalmente personalizado separado por vírgulas ou escolher entre predefinições integradas como SOS, batida cardíaca e pulsos duplos/triplos. Um registro de eventos documenta cada tentativa de vibração com um timestamp e o padrão exato usado, para que você possa comparar resultados em diferentes dispositivos e navegadores.

Exemplos

Entrada de padrão O que acontece
300 Pulso único durando 300 ms
200,100,200 Vibrar 200 ms → pausar 100 ms → vibrar 200 ms
150,100,150,100,150 Três pulsos curtos com intervalos de 100 ms entre eles
0 Cancela qualquer vibração em andamento

Recursos

  • Detecta se o dispositivo e navegador suportam a Vibration API e exibe o status ao carregar
  • Duração de pulso único ajustável de 10 ms a 5000 ms via controle deslizante
  • Entrada de padrão personalizado aceita qualquer sequência separada por vírgulas de durações de vibração e pausa
  • Seis predefinições prontas para usar: Pulso Curto, Pulso Longo, Pulso Duplo, Pulso Triplo, Padrão SOS e Batida Cardíaca
  • Registro de eventos com timestamps mostrando cada padrão acionado e se foi aceito ou rejeitado pelo navegador

Casos de uso

  • Desenvolvimento web móvel: Verifique se o feedback háptico implementado com a Vibration API realmente funciona em um dispositivo alvo antes de lançar o recurso.
  • Testes de dispositivo QA: Confirme rapidamente se o motor de vibração funciona em um smartphone recém-recebido ou reparado sem instalar um aplicativo nativo.
  • Prototipagem de padrão: Itere em sequências de vibração personalizadas (alertas de notificação, feedback de jogos, dicas de acessibilidade) testando-as ao vivo no navegador.

Como funciona

A ferramenta chama navigator.vibrate(pattern) com o valor que você fornece. O navegador retorna true se a chamada foi aceita e false se foi rejeitada — por exemplo, porque o documento não está em foco ou o dispositivo não suporta a API. Ambos os resultados são registrados no registro de eventos. Todo o processamento acontece inteiramente no dispositivo; nenhum dado é enviado para nenhum servidor.

Limitações

  • iOS (Safari, Chrome no iOS): Apple não expõe navigator.vibrate() no iOS, portanto a API é sempre reportada como não suportada em iPhones e iPads.
  • Navegadores desktop: Computadores desktop geralmente não possuem motor de vibração, portanto mesmo quando a API está disponível não tem efeito físico.
  • Abas em segundo plano: Alguns navegadores rejeitam silenciosamente chamadas de vibração quando a página não está em primeiro plano.
  • Duração máxima: Segmentos de vibração individuais são limitados pelo navegador (comumente em torno de 10 segundos); valores muito grandes podem ser truncados silenciosamente.