HIDDevice:open() 方法

有限可用性

此功能不是基线功能,因为它在某些最广泛使用的浏览器中无法正常工作。

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

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

HIDDevice接口的open()方法请求操作系统打开 HID 设备。

注意:HID 设备不会自动打开。因此,必须使用此方法打开由HID.requestDevice()返回的HIDDevice,然后才能用于传输数据。

语法

js
open()

参数

无。

返回值

一个Promise,在连接打开后解析为undefined

异常

InvalidStateError DOMException

如果连接已打开,则抛出此异常。

NotAllowedError DOMException

如果由于任何原因尝试打开连接失败,则抛出此异常。

示例

在以下示例中,我们等待 HID 连接打开,然后再尝试发送或接收数据。

js
await device.open();

规范

规范
WebHID API
# dom-hiddevice-open

浏览器兼容性

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