Bluetooth - 返回一个 Promise，解析为带有特定选项的 BluetoothDevice 对象

非标准
该功能是非标准的。请尽量不要在生产环境中使用它：因为每个用户不一定会正常运行。它的实现可能存在很大的不兼容性，并且将来可能会改变行为。

Bluetooth 是 Web 蓝牙 API的接口，返回一个 Promise，解析为带有特定选项的 BluetoothDevice 对象。

接口

interface Bluetooth : EventTarget {
  [SecureContext] Promise<boolean> getAvailability();
  [SecureContext] attribute EventHandler onavailabilitychanged;
  [SecureContext, SameObject] readonly attribute BluetoothDevice? referringDevice;
  [SecureContext] Promise<BluetoothDevice> requestDevice(optional RequestDeviceOptions options);
};
Bluetooth implements BluetoothDeviceEventHandlers;
Bluetooth implements CharacteristicEventHandlers;
Bluetooth implements ServiceEventHandlers;

属性

继承了父类 EventTarget 的属性。

Bluetooth.referringDevice 只读

返回用户打开当前页面的设备引用（如果有）。例如，Eddystone 信标可能会公布用户代理允许用户打开的 URL。代表信标的 BluetoothDevice 可通过 navigator.bluetooth.referringDevice 获得。

事件

Bluetooth.onavailabilitychanged

在 availabilitychanged 事件触发时运行的事件处理程序。

方法

Bluetooth.getAvailability()

返回解析为 Boolean 的Promise，表示用户代理是否有能力支持蓝牙。某些用户代理有允许用户配置该值的选项。如果设置了该选项的值，那就是该方法返回的值。

Bluetooth.requestDevice()

返回一个 Promise，解析为带有特定选项的 BluetoothDevice 对象。

规范

规范 状态 备注
Web Bluetooth
Bluetooth 的定义		 草稿 初始定义。

桌面浏览器兼容性

特性 Chrome Edge Firefox Internet Explorer Opera Safari
基础支持 56 未知 未知 未知 43 未知
requestDevice 56 未知 未知 未知 43 未知

移动浏览器兼容性

特性 Android Chrome for Android Edge mobile Firefox for Android IE mobile Opera Android iOS Safari
基础支持 不支持 56 未知 未知 未知 43 未知
requestDevice 不支持 56 未知 未知 未知 43 未知