开发
API

tt.getFileSystemManager

基础库 1.15.0 开始支持本方法,低版本需做兼容处理

获取全局唯一的文件管理器。

目录说明

小程序文件系统分为以下 3 个部分

用户目录

ttfile://user 开头, 开发者拥有读写权限

临时目录

ttfile://temp 开头, 开发者拥有读权限, 无写权限

包目录

小程序包体目录, 开发者拥有读权限, 无写权限

注意access accessSync readFile readFileSync 外其他 API 均不可以访问包目录

访问 包目录不需要填写前缀, 例如读取包内 app.js 文件

const fileSystemManager = tt.getFileSystemManager();

fileSystemManager.readFile({
  filePath: "app.js",
  encoding: "utf8",
  success(res) {
    // app.js 文件内容
    console.log(res.data);
  },
  fail(res) {
    //
    console.error("读取失败", res.errMsg);
  },
});

语法

tt.getFileSystemManager()

参数说明

无传入参

返回值

返回 FileSystemManager 对象, 方法如下:

方法描述
access判断文件/目录是否存在
accessSync同步判断文件/目录是否存在
saveFile保存临时文件到本地。此接口会移动临时文件,因此调用成功后,tempFilePath 将不可用。
saveFileSync同步保存临时文件到本地。此接口会移动临时文件,因此调用成功后,tempFilePath 将不可用。
getSavedFileList获取该小程序下已保存的本地缓存文件列表
removeSavedFile删除该小程序下已保存的本地缓存文件
copyFile复制文件
copyFileSync同步复制文件
getFileInfo获取该小程序下的 本地临时文件 或 本地缓存文件 信息
mkdir创建目录
mkdirSync同步创建目录
readdir读取目录内文件列表
readdirSync同步读取目录内文件列表
readFile读取本地文件内容
readFileSync同步读取本地文件内容
rename重命名文件,可以把文件从 oldPath 移动到 newPath
renameSync同步重命名文件,可以把文件从 oldPath 移动到 newPath
rmdir删除目录
rmdirSync同步删除目录
stat获取文件 Stats 对象
statSync同步获取文件 Stats 对象
unlink删除文件
unlinkSync同步删除文件
unzip解压文件
writeFile写文件
writeFileSync同步写文件

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

const fileSystemManager = tt.getFileSystemManager();

Bug & Tip

点击纠错
评价此篇文档