串口:getPorts() 方法

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

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

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

getPorts() 方法是 Serial 接口的方法,它返回一个 Promise,该 Promise 解析为一个包含 SerialPort 对象的数组,这些对象表示连接到主机且源代码具有访问权限的串行端口。

语法

js
getPorts()

参数

无。

返回值

一个 Promise,它解析为一个包含 SerialPort 对象的数组。

异常

SecurityError DOMException

如果 权限策略阻止使用此功能或用户权限提示被拒绝,则返回的 Promise 将会拒绝此错误。

示例

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

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

规范

规范
Web 串行 API
# dom-serial-getports

浏览器兼容性

BCD 表仅在浏览器中加载