抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台

FileSystemManager.stat
收藏
我的收藏

基础库 1.15.0 开始支持本方法,这是一个同步方法。

获取文件 Stats 对象。

前提条件
业务背景
使用限制
注意事项
相关教程

语法

FileSystemManager.statSync(path, recursive)

参数说明

path

类型默认值必填说明最低支持版本
string
文件/目录路径
1.15.0

recursive

类型默认值必填说明最低支持版本
boolean
是否递归获取目录下的每个文件的 Stat 信息
3.1.0

返回值

类型说明最低支持版本
Stats | array

StatItem[] | Stats。当查询结果是多个时,为数组类型;当结果唯一时,为 Stat 对象类型

1.15.0

stats 参数说明

StatItem 是个 object 类型,属性如下:

属性名

类型

说明

最低支持版本

path

string

以传参 path 为根路径的相对路径

3.1.0

stat

Stats

与路径相对应的 Stat 对象

3.1.0

错误码

errNoerrMsg说明最低支持版本
20001invalid param
参数错误
1.15.0
10401error stack
小游戏框架内部错误,有需要请创建工单咨询
1.15.0
21101permission denied, $apiName $dirPath
1.15.0
21102no such file or directory, $apiName $dirPath
1.15.0
20000internal error
小游戏框架内部错误,有需要请创建工单咨询
1.15.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

【代码示例 1】查询单一文件 stat:
const fileSystemManager = tt.getFileSystemManager(); tt.chooseImage({ success(res) { const tempFile = res.tempFilePaths[0]; try { const stat = fileSystemManager.statSync(tempFile); console.log("是否是目录:", res.stat.isDirectory()); console.log("是否是文件:", res.stat.isFile()); } catch (err) { console.log("调用失败", err); } }, });
【代码示例 2】递归查询用户目录 stat:
const fileSystemManager = tt.getFileSystemManager(); const stats = fs.statSync(`ttfile://user`, true) if (Array.isArray(stats)) { stats.forEach(({ path, stat }) => { console.log(path, stat.isDirectory()) }) } else { console.log(stats.isDirectory()) }