navigator.vibrate() 是 web api 中用于触发动态硬件震动的接口,定义在 navigator 接口上,需 https/localhost 安全上下文及用户手势触发,支持安卓 chrome/firefox,ios safari 不支持,参数为毫秒数或震动/暂停数组,调用前须检测 'vibrate' in navigator。

navigator.vibrate() 是 Web API 中用于触发动态硬件震动的接口,但它并不属于 BOM 的 navigator 对象原生功能,而是 Navigator 接口的扩展方法(定义在 Navigator 接口上,可通过 navigator.vibrate 访问),需在支持振动 API 的移动端浏览器中使用(如 Chrome for Android、Firefox for Android),且必须满足安全上下文(HTTPS 或 localhost)和用户交互触发条件。
确认浏览器支持与权限前提
振动 API 受限严格,使用前必须验证支持性并确保运行环境合规:
- 仅工作在 HTTPS 站点或
localhost下;HTTP 页面会静默失败 - 必须由用户手势(如 click、touchstart)触发,不能在页面加载或定时器中直接调用
- 部分浏览器(如 Safari/iOS)完全不支持该 API(iOS WebKit 长期禁用 vibrate)
- 调用前建议检测:
if ('vibrate' in navigator) { ... }
基本震动模式:单次与多段节奏
vibrate 接收一个参数,可以是数字(毫秒)或数字数组(交替震动/暂停周期):
-
navigator.vibrate(200):震动 200ms 后停止 -
navigator.vibrate([100, 50, 150]):震动 100ms → 停 50ms → 震 150ms(总时长 300ms) - 数组长度为奇数时,末尾视为震动时长;偶数则按“震-停-震-停…”完整配对
- 传入
0、空数组[]或false会终止当前震动(但实际效果因系统而异)
常见使用场景与注意事项
典型用途包括表单提交反馈、游戏事件提示、无障碍操作确认等,但需注意兼容性和体验细节:
- 安卓 Chrome 中最大单次震动约 5s(超时会被截断),数组总长通常限制在 5s 内
- 连续多次调用 vibrate 会自动排队,但若前一次未结束,新调用可能被忽略或合并
- 避免高频短震动(如
[10,10,10]),易被系统过滤或用户感知模糊 - 推荐节奏示例(清晰可辨):
[150, 100, 150](提示成功)、[200, 100, 100, 100](错误三连短震)
安全调用示例(带检测与交互绑定)
以下是一个可靠触发震动的最小可行代码:
button.addEventListener('click', () => {
if ('vibrate' in navigator) {
try {
// 模拟「确认」节奏:震150ms → 停100ms → 震150ms
navigator.vibrate([150, 100, 150]);
} catch (err) {
console.warn('震动失败:', err);
}
} else {
console.log('当前浏览器不支持振动 API');
}
});
不复杂但容易忽略。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











