开发
API
自2022年9月6日起,本文档站不再更新内容,相关文档已迁移至全新“抖音开放平台”前往

FileSystemManager.appendFile

基础库 2.60.0 开始支持本方法,低版本需做兼容处理,这是一个异步方法。

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

语法

FileSystemManager.appendFile(options)

参数说明

options 为 object 类型,属性如下:

属性名类型默认值必填说明最低支持版本
filePathstring要追加内容的文件路径,必须以 ttfile://user 开头2.60.0
datastring | arraybuffer要写入的文本或二进制数据2.60.0
encodingstringutf-8指定写入文件的字符编码2.60.0
successfunction接口调用成功的回调函数2.60.0
failfunction接口调用失败的回调函数2.60.0
completefunction接口调用结束的回调函数2.60.0

encoding 的合法值

说明最低支持版本
asciiMDN2.60.0
base64RFC 4648, Section 52.60.0
binary/latin1ISO-8859-12.60.0
hex十六进制2.60.0
ucs2/ucs-2/utf16le/utf-16le以小端序读取2.60.0
utf-8/utf8RFC 3629, Section 42.60.0

回调成功

object 类型,属性如下:

属性名类型说明最低支持版本
errMsgstring"appendFile:ok"2.60.0

回调失败

object 类型,属性如下:

属性名类型说明最低支持版本
errNonumber错误码2.60.0
errMsgstring"appendFile:fail " + 详细错误信息2.60.0

错误说明

errNoerrMsg说明最低支持版本
20000appendFile:fail filePath is invalidfilePath 参数错误2.60.0
21101appendFile:fail permission denied, appendFile %sfilePath 路径不可写2.60.0
21102appendFile:fail no such file or directory, appendFile %sfilePath 文件不存在2.60.0
21103appendFile:fail user dir saved file size limit exceeded超出目录大小限制2.60.0
21104appendFile:fail operation not permitted, appendFile %sfilepath 类型不是文件2.60.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);
}

Bug & Tip

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助