HIDDevice: open() 方法

可用性有限

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

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

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

注意:此功能在 Web Workers 中可用,但 共享 Web Workers 除外。

open() 方法是 HIDDevice 接口的一部分,用于请求操作系统打开 HID 设备。

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

语法

js
open()

参数

无。

返回值

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

异常

InvalidStateError DOMException

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

NotAllowedError DOMException

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

示例

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

js
await device.open();

规范

规范
WebHID API
# dom-hiddevice-open

浏览器兼容性