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

FileSystemManager.appendFileSync

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

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

语法

FileSystemManager.appendFileSync(filePath, data[, encoding])

参数说明

filePath

类型默认值必填说明最低支持版本
string要追加内容的文件的路径,必须以 ttfile://user 开头2.60.0

data

类型默认值必填说明最低支持版本
string/ArrayBuffer要写入的文本或二进制数据2.60.0

encoding

类型默认值必填说明最低支持版本
stringutf-8指定写入文件的字符编码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

返回值

错误说明

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

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