Serial: getPorts() 方法

可用性有限

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

安全上下文： 此功能仅在安全上下文（HTTPS）中可用，且支持此功能的浏览器数量有限。

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

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

Serial 接口的 getPorts() 方法返回一个 Promise，该 Promise 解析为一个 SerialPort 对象数组，表示已连接到主机并且源（origin）有权访问的串行端口。

语法

getPorts()

无。

一个 Promise，解析为 SerialPort 对象数组。

SecurityError DOMException

在以下任一情况下，返回的 Promise 会被拒绝并显示此错误：

以下示例使用 getPorts() 来初始化可用端口列表。

navigator.serial.getPorts().then((ports) => {
  // Initialize the list of available ports with `ports` on page load.
});

规范
Web Serial API # dom-serial-getports

此页面最后修改于 2025年3月13日，由 MDN 贡献者修改。