# FileSystemManager.stat(Object object)

异步获取文件或目录的 Stats 信息。

# 支持情况

项 说明
兼容性 兼容微信

# 语法

const fs = mt.getFileSystemManager()
fs.stat({ path, recursive, success, fail, complete })

# 参数

Object object

属性 类型 默认值 必填 说明
path string — 是 文件/目录路径
recursive boolean false 否 是否递归获取目录下所有文件/子目录的 Stats
success function — 否 成功回调
fail function — 否 失败回调
complete function — 否 完成回调(成功或失败均触发)

success 回调参数

属性 类型 说明
stats Stats | Object[] recursive 为 false 时为单个 Stats 对象;为 true 时为 { path, stats } 数组

# 返回值

无返回值。

# 示例代码

const fs = mt.getFileSystemManager()
// 获取单个文件信息
fs.stat({
  path: `${mt.env.USER_DATA_PATH}/test.txt`,
  success(res) {
    console.log(res.stats.size)
    console.log(res.stats.isFile())
  },
  fail(err) {
    console.error(err.errMsg)
  }
})

// 递归获取目录下所有文件信息
fs.stat({
  path: `${mt.env.USER_DATA_PATH}`,
  recursive: true,
  success(res) {
    res.stats.forEach(item => {
      console.log(item.path, item.stats.size)
    })
  }
})

# 与微信差异

无差异(行为与微信小游戏一致)。

上次更新: 8/10/2026, 5:36:37 PM