基础库 3.1.0 开始支持本方法，这是一个异步方法。

在文件结尾追加内容，文件不存在时会新建。只有用户目录 ttfile://user 下的文件可以追加。

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

语法

FileSystemManager.appendFile(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
encoding	enum	utf-8	否	指定写入文件的字符编码	3.1.0
data	string		是	要写入的文本或二进制数据。支持 string 和 arraybuffer 类型	3.1.0
filePath	string		是	要追加内容的文件路径，必须是用户目录，以 ttfile://user 开头	3.1.0
success	function		否	接口调用成功的回调函数	3.1.0
fail	function		否	接口调用失败的回调函数	3.1.0
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）	3.1.0

encoding 的合法值

值	说明	最低支持版本
utf-8	RFC 3629, Section 4	3.1.0
ascii	MDN	3.1.0
base64	RFC 4648, Section 5	3.1.0
binary	ISO-8859-1	3.1.0
hex	十六进制	3.1.0
ucs2	以小端序读取	3.1.0
ucs-2	以小端序读取	3.1.0
utf16le	以小端序读取	3.1.0
utf-16le	以小端序读取	3.1.0
utf8	RFC 3629, Section 4	3.1.0
latin1	ISO-8859-1	3.1.0

回调成功

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"FileSystemManager.appendFile:ok"	3.1.0

回调失败

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"FileSystemManager.appendFile:fail" + 详细错误信息	3.1.0

错误码

errNo	errMsg	说明	最低支持版本
20001	invalid param	参数错误	3.1.0
10401	error stack	小游戏框架内部错误，有需要请创建工单咨询	3.1.0
21101	permission denied, $filePath		3.1.0
21102	no such file or directory, $filePath		3.1.0
21103	user dir saved file size limit exceeded		3.1.0
21104	operation not permitted, $apiName $filePath		3.1.0
20000	data is invalid		3.1.0
20001	data is invalid		3.1.0
20000	internal error	小游戏框架内部错误，有需要请创建工单咨询	3.1.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

const fs = tt.getFileSystemManager()
fs.appendFile({
  filePath: `ttfile://user/example.txt`,
  data: "Hello World",
  encoding: "utf8",
  success(res) {
    console.log(res)
  },
  fail(res) {
    console.error(res)
  },
})
// 同步接口
try {
  fs.appendFileSync(`ttfile://user/example.txt`, "Hello World", "utf8")
} catch (e) {
  console.error(e)
}