Bluetooth：getDevices() 方法

有限可用

此特性不属于基线，因为它尚未在主流浏览器中得到支持。

实验性: 这是一项实验性技术
在将其用于生产之前，请仔细检查浏览器兼容性表格。

安全上下文: 此特性仅在一些支持的浏览器的安全上下文（HTTPS）中可用。

Bluetooth 接口的 getDevices() 方法返回包含此来源被允许访问的蓝牙设备（包括那些超出范围和已关闭电源的设备）的数组。

语法

getDevices()

无。

一个 Promise，其会兑现为一个 BluetoothDevice 对象数组。

SecurityError DOMException: 如果由于安全问题，例如在当前文档的访问被权限策略指令 bluetooth 阻止时调用，则会抛出此异常。

规范
Web Bluetooth # dom-bluetooth-getdevices

此页面最后更新于 2025年9月25日，由 MDN 贡献者更新。