Bluetooth:getDevices() 方法

可用性有限

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

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

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

语法

js
getDevices()

参数

无。

返回值

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

异常

SecurityError DOMException

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

规范

规范
Web 蓝牙
# dom-bluetooth-getdevices

浏览器兼容性