跳转到内容

Web Bluetooth API 浏览器支持

发布于 更新于

navigator.bluetooth.requestDevice() 返回一个 Promise,兑现值是符合所给条件的蓝牙设备。浏览器没有设备选择器界面时,它会返回第一个符合条件的设备。它的浏览器支持数据来自 BCD 的 api.Bluetooth.requestDevice 键。

Chrome 桌面版与 Android 版从 56 起支持 requestDevice(),Edge 从 79 起支持,Samsung Internet 从 6.0 起支持,Opera 从 43 起支持。BCD 没有记录 Firefox 桌面版和 Android 版、macOS 与 iOS 上的 Safari,以及 Android WebView 的支持。Firefox 与 WebKit 的实现跟踪地址列在对应行中。

  • 图例
  • 支持
  • 部分支持
  • 需开启标志
  • 不支持
  • 未知
浏览器 / 平台支持版本置信度来源备注
Chrome (Desktop)#支持56高来源—
Chrome (Android)#支持56高来源1
Edge (Desktop)#支持79高来源2
Firefox (Desktop)#不支持—高来源3
Firefox (Android)#不支持—高来源45
Safari (macOS)#不支持—高来源6
Safari (iOS)#不支持—高来源78
Samsung Internet#支持6.0高来源9
WebView (Android)#不支持—高来源10
Opera#支持43高来源11
  1. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  2. 由 browser-compat-data 镜像自 Chrome 的数据推导。
  3. 实现跟踪:https://bugzil.la/674737。
  4. 实现跟踪:https://bugzil.la/674737。
  5. 由 browser-compat-data 镜像自 Firefox 的数据推导。
  6. 实现跟踪:https://webkit.org/b/101034。
  7. 实现跟踪:https://webkit.org/b/101034。
  8. 由 browser-compat-data 镜像自 Safari 的数据推导。
  9. 由 browser-compat-data 镜像自 Chrome Android 的数据推导。
  10. browser-compat-data 未记录 WebView Android 的支持。
  11. 镜像 Chrome 的实现(BCD `opera: mirror`):Linux 上有支持,但默认未启用。

源数据: /compatibility/web-bluetooth.json · 全球使用占比: 77 % (StatCounter 2026-09, CC BY-SA 4.0)

来源: 规范 · MDN · 最近核验 2026-10-03 · 置信度: 高 (由来源计算)

navigator.bluetooth 返回当前文档的 Bluetooth 对象。requestDevice() 接收筛选选项,并返回一个 Promise;兑现值是符合条件的 BluetoothDevice。接口只在安全上下文中开放,WorkerNavigator 不提供它,因此设备选择要从文档发起。

选项中必须提供 filters,或把 acceptAllDevices 设为 true。筛选条件可以匹配广播出来的 GATT 服务、设备名或名称前缀。用户选定设备后,当前源只能访问 filters.services 与 optionalServices 列出的服务。若筛选条件只写设备名,还要把应用需要的服务放进 optionalServices。

网站首次请求某台设备时,requestDevice() 会显示权限提示;调用所在的全局对象还要有瞬时用户激活。因此应把调用直接放进点按处理函数。下面的代码先检测接口;没有支持时禁用按钮并显示页内说明。

const button = document.createElement('button');
button.textContent = '连接蓝牙设备';
const status = document.createElement('p');
document.body.append(button, status);
if (!('bluetooth' in navigator)) {
button.disabled = true;
status.textContent = '此浏览器无法连接蓝牙设备。';
} else {
button.addEventListener('click', async () => {
try {
const device = await navigator.bluetooth.requestDevice({
filters: [{ services: ['battery_service'] }],
});
status.textContent = device.name ?? '已选择蓝牙设备';
} catch (error) {
status.textContent = `${error.name}: ${error.message}`;
}
});
}

检测分支会在请求权限之前准备好可见的兜底结果。浏览器支持接口时,点按按钮会查找广播 Battery Service 的设备。Promise 返回的对象标识用户选定的设备;如何打开 GATT 连接、读取 characteristic,可继续查看 Web Bluetooth 参考条目。

bluetooth Permissions Policy 控制接口访问。默认允许列表为 self,同源嵌套 frame 可以使用,第三方内容默认不能使用。跨源 frame 需要同时在 Permissions-Policy 响应头与 iframe 的 allow 属性中写入允许的源。策略拦截后,权限提示不会出现。

Bluetooth.getDevices() 可以返回此前已获当前网站授权的设备。Permissions API 查询 bluetooth 权限时,状态为 granted、denied 或 prompt。这些相关方法各有自己的 BCD 支持数据。