HIDConnectionEvent

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)中可用。

WebHID APIHIDConnectionEvent 接口表示 HID 连接事件,且当设备连接状态发生变化时,事件类型会传递给 connectdisconnect 事件处理器。

Event HIDConnectionEvent

构造函数

HIDConnectionEvent() 实验性

返回一个新的 HIDConnectionEvent 对象。通常不会使用这个构造函数,因为当设备连接状态发生变化时,就会创建事件。

实例属性

此接口也从其父接口 Event 继承属性。

HIDConnectionEvent.device 只读 实验性

返回表示与此连接事件有关联的 HIDDevice 实例。

示例

以下示例为 connectdisconnect 事件注册监听器,然后把 HIDDevice.productName 打印到控制台。

js
navigator.hid.addEventListener("connect", ({ device }) => {
  console.log(`HID 已连接:${device.productName}`);
});

navigator.hid.addEventListener("disconnect", ({ device }) => {
  console.log(`HID 断开连接:${device.productName}`);
});

规范

Specification
WebHID API
# dom-hidconnectionevent

浏览器兼容性

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
HIDConnectionEvent
Experimental
HIDConnectionEvent() constructor
Experimental
device
Experimental
Available in workers
Experimental

Legend

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

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
See implementation notes.
Has more compatibility info.