HIDDevice:open() 方法

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

安全上下文: 此项功能仅在一些支持的浏览器安全上下文(HTTPS)中可用。

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

备注: 此特性在 Web Worker(不包括共享 Web Worker)中可用。

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

备注: HID 设备不会自动打开。因此,在 HID.requestDevice() 返回的 HIDDevice 可用于传输数据之前,必须使用此方法将其打开。

语法

js
open()

参数

无。

返回值

一个 Promise,会在连接打开时兑现为 undefined

异常

InvalidStateError DOMException

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

NotAllowedError DOMException

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

示例

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

js
await device.open();

规范

Specification
WebHID API
# dom-hiddevice-open

浏览器兼容性

BCD tables only load in the browser