Bluetooth：getDevices() 方法

可用性有限

此特性不是基线特性，因为它在一些最广泛使用的浏览器中不起作用。

实验性： 这是一项实验性技术
在生产中使用此技术之前，请仔细检查浏览器兼容性表格。

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

Bluetooth 接口的 getDevices() 方法返回一个数组，其中包含此源有权访问的蓝牙设备——包括那些超出范围和已关机的设备。

语法

getDevices()

无。

一个 Promise，它将解析为一个 BluetoothDevice 对象数组。

SecurityError DOMException: 如果由于安全方面的考虑（例如，在 Permissions Policy 指令 bluetooth 阻止对当前文档的访问时调用）在此上下文中不允许此操作，则会抛出此异常。

规范
Web 蓝牙 # dom-bluetooth-getdevices

此页面最后由 MDN 贡献者于 2025 年 3 月 13 日修改。