FileSystemManager.fstat

简介

获取文件 Stats 对象。

使用限制

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

参数

Object object

属性	类型	默认值	必填	说明
fd	string		是	文件描述符。fd 通过 FileSystemManager.open 接口获得
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
stats	Stats	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	参数不合法
bad file descriptor: F10003	无效的文件描述符
fail permission denied: F10005	指定的 fd 路径没有读权限

示例代码

// pages/index/index.js

Page({
  fstat() {
    const fs = dlt.getFileSystemManager();
    // 打开文件
    fs.open({
      filePath: `${dlt.env.USER_DATA_PATH}/hello.txt`,
      flag: "a+",
      success(res) {
        // 获取文件的状态信息
        fs.fstat({
          fd: res.fd,
          success(res) {
            console.log(res.stats);
          },
        });
      },
    });
  },
});