串口: connect 事件

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

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

注意: 此功能在专用 Web 工作者中可用。

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

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

语法

在像 addEventListener() 这样的方法中使用事件名称，或者设置事件处理程序属性。

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

onconnect = (event) => {};

事件类型

一个通用的 Event。

冒泡

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

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

示例

在特定端口连接时通知

Serial.requestPort() 方法返回一个 Promise，该 Promise 解析为用户选择的 SerialPort。

// Prompt user to choose a serial port
const port = await navigator.serial.requestPort();

port.addEventListener("connect", (event) => {
  // notify that the chosen port is connected
});

监听任何新连接的端口

connect 事件冒泡到 Serial 对象，您可以在其中监听任何新连接的端口。

navigator.serial.addEventListener("connect", (event) => {
  // notify that a new port is available
  // use `event.target` to refer to the newly-added port
});

规范

规范
Web 串口 API # dfn-connect
Web 串口 API # dom-serialport-onconnect

浏览器兼容性

BCD 表格仅在浏览器中加载

另请参阅

disconnect 事件