FileSystemManager.stat

简介

获取文件 Stats 对象。

使用限制

基础库 3.0.0 或更高版本支持。

参数

Object object

属性	类型	默认值	必填	说明
path	string		是	文件/目录路径 (相对路径)
recursive	string		否	是否递归获取目录下的每个文件的 Stats 信息
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
stats	Stats[]	当 recursive 为 false 时，res.stats 是一个 Stats 对象。当 recursive 为 true 且 path 是一个目录的路径时，res.stats 是一个 Array，数组的每一项是一个对象，每个对象包含 path 和 stats。
success	string	true-成功

Stats 对象说明

属性	类型	说明
mode	string	文件的类型和存取的权限，对应 POSIX stat.st_mode
size	number	文件大小，单位：B，对应 POSIX stat.st_size
lastAccessedTime	number	文件最近一次被存取或被执行的时间，UNIX 时间戳，对应 POSIX stat.st_atime
lastModifiedTime	number	文件最后一次被修改的时间，UNIX 时间戳，对应 POSIX stat.st_mtime

object.fail 回调函数

参数

Object res

属性	类型	说明
errMsg	string	错误信息
success	string	false-失败

errMsg 说明

错误信息	说明
parameter error: F10001	参数不合法
fail sdcard not mounted: F10002	Android sdcard 挂载失败
fail permission denied: F10005, open "${filePath}"	指定的 filePath 路径没有写权限
fail no such file or directory: F10007 "${path}"	文件/目录不存在

示例代码

// pages/index/index.js

Page({
  stat() {
    const fs = dlt.getFileSystemManager();
    fs.stat({
      path: `${dlt.env.USER_DATA_PATH}/testDir`,
      recursive: true,
      success: (res) => {
        console.log(res);
      },
    });
  },
});