USB:连接事件

可用性有限

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

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

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

当配对的设备连接时,USB 接口的 connect 事件会被触发。

语法

在诸如 addEventListener() 之类的方法中使用事件名称,或设置事件处理程序属性。

js
addEventListener("connect", (event) => {});

onconnect = (event) => {};

事件类型

事件属性

除了下面列出的属性之外,父接口 Event 的属性也可用。

device 只读

触发该事件的 USBDevice

示例

USB 设备连接后,您可能希望更新 UI。

js
navigator.usb.addEventListener("connect", (event) => {
  // Add event.device to the UI.
});

或者,您可以使用 USB.onconnect 事件处理程序属性为 connect 事件建立处理程序

js
navigator.usb.onconnect = (event) => {
  // Add event.device to the UI.
};

规范

规范
WebUSB API
# 连接
WebUSB API
# ref-for-dom-usb-onconnect

浏览器兼容性

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