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

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
open
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.