FileSystemManager.stat
收藏
我的收藏

基础库 1.15.0 开始支持本方法。

获取文件 Stats 对象。

语法

JavaScript复制
FileSystemManager.stat(options)

参数说明

options

options 为 object 类型，属性描述如下：

属性名	类型	默认值	必填	说明	最低支持版本
path	string		是	文件/目录路径	1.15.0
recursive	boolean	false	否	是否递归获取目录下每个文件的stat信息	3.1.0
success	Function		否	接口调用成功的回调函数	1.15.0
fail	Function		否	接口调用失败的回调函数	1.15.0
complete	Function		否	接口调用结束的回调函数（调用成功、失败都会执行）	1.15.0

回调成功

回调参数为 object 类型，属性如下：

属性	类型	说明	最低支持版本
errMsg	string		1.15.0
stats	StatItem[] \| Stats	当查询结果是多个时，为数组类型；当结果唯一时，为 Stat 对象类型	3.1.0

StatItem

object 类型，属性如下：

属性名	类型	说明	最低支持版本
path	string	以传参 path 为根路径的相对路径	3.1.0
stat	Stats	与路径相对应的 Stat 对象	3.1.0

回调失败

回调参数为 object 类型，属性如下：

属性	类型	说明	最低支持版本
errNo	number	错误码	1.99.0
errMsg	string	"stat:fail " + 详细错误信息	1.15.0

错误码说明：

errNo	errMsg	说明	最低支持版本
20000	stat:fail {param_name} is invalid	path 参数错误	1.99.0
20001	stat:fail param should be xxx, but got xxx	参数校验错误	1.99.0
21101	stat:fail permission denied, stat {path_value}	文件路径不可读	1.99.0
21102	stat:fail no such file or directory, stat {path_value}	文件不存在	1.99.0

代码示例

【示例 1】查询单一文件 stat：

JavaScript复制
const fileSystemManager = tt.getFileSystemManager();
tt.chooseImage({
  success(res) {
    const tempFile = res.tempFilePaths[0];
    fileSystemManager.stat({
      path: tempFile,
      success(res) {
        console.log("是否是目录:", res.stat.isDirectory());
        console.log("是否是文件:", res.stat.isFile());
      },
      fail(res) {
        console.log("调用失败", res.errMsg);
      },
    });
  },
});

【示例 2】递归查询用户目录 stat：

JavaScript复制
const fileSystemManager = tt.getFileSystemManager();
fs.stat({
  path: `ttfile://user`,
  recursive: true,
  success: (res) => {
    if (Array.isArray(res.stats)) {
      res.stats.forEach(({ path, stat }) => {
        console.log(path, stat.isDirectory());
      });
    } else {
      console.log(res.stats.isDirectory());
    }
  },
});