SerialPort: disconnect 事件

可用性有限

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

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

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

注意:此功能在 专用 Web Workers 中可用。

SerialPort 接口的 disconnect 事件在端口与设备断开连接时触发。

描述

更具体地说,当一个先前已 逻辑连接 的端口(在用户授予网站访问权限后,在调用 Serial.requestPort() 后)不再连接时,就会触发 disconnect 事件。

事件冒泡

此事件会冒泡到返回此接口的 Serial 实例。event.target 属性指向冒泡上来的 SerialPort 对象。

有关更多信息,请参阅 事件冒泡

语法

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

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

ondisconnect = (event) => { }

事件类型

一个通用的 Event

示例

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

此处,事件监听器安装在特定的 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 Serial API
# dfn-disconnect
Web Serial API
# dom-serialport-ondisconnect

浏览器兼容性

另见