串口:getPorts() 方法
注意:此功能在专用 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 表仅在浏览器中加载