跳到主要内容

# 列出中控文件 (LCC.web_file.list)

## 声明​

    list, err = LCC.web_file.list(path, recursive?, timeout?)

## 参数​

- path
  字符串型，要查看的中控目录路径
- recursive
  布尔型，可选；为 `true` 时递归列出子目录，默认 `false`
- timeout
  数值型，可选；请求超时时间（秒），默认 `60`

## 返回值​

- list
  表类型，中控返回的文件/目录数组，失败时为 `nil`
- err
  字符串型或 `nil`，失败时为错误描述

## 说明​

> 列出指定目录下的文件和子目录。
> 需要提前设置中控地址或由中控启动脚本。
> 返回的每个元素包含 `name`、`path`、`dir`、`symlink`、`size`、`modification` 字段。
> 其中 `symlink` 表示该项是否为符号链接；链接目标可访问时，`dir` 和 `size` 反映目标状态。

## 示例​

    local nodes, err = LCC.web_file.list("/脚本", true)
    if not nodes then
        error(err)
    end