微信小程序API 文件·文件管理器

vicky.yu

FileSystemManager
基础库 1.9.9 开始支持，低版本需做兼容处理。
文件管理器

方法：
FileSystemManager.access(Object object)
判断文件/目录是否存在

参数
Object object
属性        类型        默认值        必填        说明
path        string                是        要判断是否存在的文件/目录路径 (本地路径)
success        function                否        接口调用成功的回调函数
fail        function                否        接口调用失败的回调函数
complete        function                否        接口调用结束的回调函数（调用成功、失败都会执行）
object.fail 回调函数
参数
Object res
属性        类型        说明
errMsg        string        错误信息
res.errMsg 的合法值

值        说明        最低版本
fail no such file or directory ${path}        文件/目录不存在       


FileSystemManager.accessSync(string path)
FileSystemManager.access 的同步版本

参数
string path
要判断是否存在的文件/目录路径 (本地路径)

错误
错误码        错误信息        说明
fail no such file or directory ${path}        文件/目录不存在

FileSystemManager.appendFile(Object object)
基础库 2.1.0 开始支持，低版本需做兼容处理。
在文件结尾追加内容

参数
Object object
属性        类型        默认值        必填        说明
filePath        string                是        要追加内容的文件路径 (本地路径)
data        string/ArrayBuffer                是        要追加的文本或二进制数据
encoding        string        utf8        否        指定写入文件的字符编码
success        function                否        接口调用成功的回调函数
fail        function                否        接口调用失败的回调函数
complete        function                否        接口调用结束的回调函数（调用成功、失败都会执行）
object.encoding 的合法值

值        说明        最低版本
ascii               
base64               
binary               
hex               
ucs2        以小端序读取       
ucs-2        以小端序读取       
utf16le        以小端序读取       
utf-16le        以小端序读取       
utf-8               
utf8               
latin1               
object.fail 回调函数
参数
Object res
属性        类型        说明
errMsg        string        错误信息
res.errMsg 的合法值

值        说明        最低版本
fail no such file or directory, open ${filePath}        指定的 filePath 文件不存在       
fail illegal operation on a directory, open "${filePath}"        指定的 filePath 是一个已经存在的目录       
fail permission denied, open ${dirPath}        指定的 filePath 路径没有写权限       
fail sdcard not mounted        指定的 filePath 是一个已经存在的目录       

FileSystemManager.appendFileSync(string filePath, string|ArrayBuffer data, string encoding)
基础库 2.1.0 开始支持，低版本需做兼容处理。
FileSystemManager.appendFile 的同步版本

参数
string filePath
要追加内容的文件路径 (本地路径)

string|ArrayBuffer data
要追加的文本或二进制数据

string encoding
指定写入文件的字符编码

encoding 的合法值

值        说明        最低版本
ascii               
base64               
binary               
hex               
ucs2        以小端序读取       
ucs-2        以小端序读取       
utf16le        以小端序读取       
utf-16le        以小端序读取       
utf-8               
utf8               
latin1               
错误
错误码        错误信息        说明
fail no such file or directory, open ${filePath}        指定的 filePath 文件不存在
fail illegal operation on a directory, open "${filePath}"        指定的 filePath 是一个已经存在的目录
fail permission denied, open ${dirPath}        指定的 filePath 路径没有写权限
fail sdcard not mounted        指定的 filePath 是一个已经存在的目录