device.list
device.list
功能
返回当前程序仍可见的已打开设备列表。
语法
device.list()
参数
无参数。
返回值
| 类型 | 说明 |
|---|---|
| Array | 返回已打开设备信息对象数组。 |
设备信息字段
数组中每个对象表示当前程序仍可见的一个已打开设备。
| 字段 | 类型 | 必定存在 | 说明 |
|---|---|---|---|
| type | String | 是 | 设备类型，当前为 serial。 |
| port | String | 是 | 打开设备时使用的串口名称。 |
| baud_rate | Int | 是 | 打开串口时使用的波特率。 |
| closed | Bool | 是 | 底层设备连接是否已经关闭。true 表示已经关闭，不能继续读写。 |
示例
// 打开一个串口后，device.list() 可以查看当前程序持有的设备句柄。 port = device.open({type: 'serial', port: 'COM3'}) items = device.list() result = items[0].closed // 输出：false print result port.close()
注意事项
- 已经被释放的弱引用会在 list 时清理。
-
device.list()只列出当前进程中打开过且仍被引用的设备，不是系统全量串口扫描。