蓝牙:getDevices() 方法

可用性有限

此功能并非基础功能,因为它在一些最常用的浏览器中无法正常工作。

实验性: 这是一个 实验性技术
在生产环境中使用此功能前,请仔细查看 浏览器兼容性表格

安全上下文: 此功能仅在 安全上下文(HTTPS)中可用,并且仅在某些或所有 支持的浏览器 中可用。

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

语法

js
getDevices()

参数

无。

返回值

一个 Promise,它解析为一个包含 BluetoothDevice 对象的数组。

异常

SecurityError DOMException

如果由于 安全问题(例如,在当前文档的访问被 权限策略 指令 bluetooth 阻止时调用)导致此操作在此上下文中不被允许,则会抛出此异常。

规范

规范
Web 蓝牙
# dom-bluetooth-getdevices

浏览器兼容性

BCD 表格仅在启用了 JavaScript 的浏览器中加载。