串口：断开事件

安全上下文：此功能仅在 安全上下文（HTTPS）中可用，并且在某些或所有 支持的浏览器中可用。

实验性：这是一个 实验性技术
在生产环境中使用此功能之前，请仔细查看 浏览器兼容性表。

注意：此功能在 专用 Web 工作线程中可用。

当端口与设备断开连接时，SerialPort 接口的 disconnect 事件将被触发。此事件仅针对与可移动设备（例如通过 USB 连接的设备）关联的端口触发。

此事件将冒泡到返回此接口的 Serial 实例。

语法

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

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

ondisconnect = (event) => {};

事件类型

一个通用的 Event。

冒泡

此事件将冒泡到 Serial。event.target 属性引用冒泡的 SerialPort 对象。

有关更多信息，请参见 事件冒泡。

示例

通知何时特定端口断开连接

此处，事件监听器安装在特定的 SerialPort 对象上。

js
port.addEventListener("disconnect", (event) => {
  // notify that the port has become unavailable
});

监听任何变得不可用的端口

disconnect 事件将冒泡到 Serial 对象，您可以在此处监听任何变得不可用的端口。

js
navigator.serial.addEventListener("disconnect", (event) => {
  // notify that a port has become unavailable
  // use `event.target` to refer to the unavailable port
});

规范

规范
Web 串行 API
# dfn-disconnect
Web 串行 API
# dom-serialport-ondisconnect

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参见