小程序开放平台

文档中心
基础
路由
跳转
转发
界面
网络
支付
数据缓存
媒体
位置
开放接口
设备
XHSML
性能
第三方平台
文件
removeSavedFile
openDocument
getFileSystemManager
FileSystemManager方法
access
accessSync
appendFile
appendFileSync
copyFile
copyFileSync
getSavedFileList
getFileInfo
mkdir
mkdirSync
readdir
readdirSync
rmdir
rmdirSync
rename
renameSync
readFile
readFileSync
removeSavedFile
stat
statSync
saveFile
saveFileSync
truncate
truncateSync
unlink
unlinkSync
unzip
writeFile
writeFileSync
Stats
FileStats
错误码
数据分析
画布

xhs.statSync

开发
>
JS API
>
文件
>
FileSystemManager方法
>
statSync
>
更新时间:2025-07-03 10:49:37

📌 从基础库 3.125.4 版本开始支持

功能描述

FileSystemManager.stat 的同步版本

参数

参数
类型
说明
最低版本
pathstring文件/目录路径 (本地路径)
recursiveboolean是否递归获取目录下的每个文件的 Stats 信息3.125.4

返回值

Stats|Array.<FileStats>

当 recursive 为 false 时返回 Stats 对象;当 recursive 为 true 且 path 是目录路径时返回包含 path 和 stats 的对象数组

示例代码

recursive 为 false 时

javascript
const fs = xhs.getFileSystemManager()

try {
  // 同步获取文件信息
  const stats = fs.statSync(`${xhs.env.USER_DATA_PATH}/testDir`, false)
  
  // 判断是否是目录
  console.log('是否是目录:', stats.isDirectory())
  // 获取文件大小(字节)
  console.log('文件大小:', stats.size)
  // 获取最后修改时间
  console.log('最后修改时间:', stats.lastModifiedTime)
} catch(e) {
  console.error('获取文件信息失败:', e)
}

recursive 为 true 时

javascript
const fs = xhs.getFileSystemManager()

try {
  // 同步递归获取目录信息
  const statsList = fs.statSync(`${xhs.env.USER_DATA_PATH}/testDir`, true)
  
  // 遍历目录下的所有文件和子目录
  statsList.forEach(item => {
    console.log('路径:', item.path)
    console.log('是否是目录:', item.stats.isDirectory())
    console.log('文件大小:', item.stats.size)
    console.log('最后修改时间:', item.stats.lastModifiedTime)
    console.log('-------------------')
  })
} catch(e) {
  console.error('获取目录信息失败:', e)
}
该文档是否对您有帮助?