抖音开放平台Logo
控制台

FileSystemManager.writeFileSync
收藏
我的收藏

基础库 1.15.0 开始支持本方法,这是一个同步方法。​
写文件。​

语法​

JavaScript
复制
FileSystemManager.writeFileSync(filePath, data, encoding)

参数说明​

filePath​

类型
默认值
必填
说明
最低支持版本
string​
是​
要写入的文件路径, 必须以 ttfile://user 开头​
1.15.0 ​

data​

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

encoding​

类型
默认值
必填
说明
最低支持版本
string​
否​
指定写入文件的字符编码​
1.15.0 ​

encoding 的合法值​

值​
说明​
最低支持版本​
ascii​
1.15.0​
base64​
1.15.0​
binary​
1.15.0​
hex​
1.15.0​
ucs2/ucs-2/utf16le/utf-16le​
以小端序读取​
1.15.0​
utf-8/utf8​
1.15.0​
latin1​
1.15.0​

返回值​

无。没有 throw 异常表示写入成功, throw Error 则表示写入失败。 error 对象会包含 errNo 和 errMsg 字段。​

错误说明​

errNo
errMsg
说明
最低支持版本
20000​
writeFileSync:fail {param_name} is invalid​
filePath 参数错误​
1.99.0​
20000​
writeFileSync:fail data is invalid​
data 传入参数类型不正确​
1.99.0​
20001​
writeFileSync:fail param should be xxx, but got xxx​
参数校验错误​
1.99.0​
21101​
writeFileSync:fail permission denied, writeFileSync {filePath_value}​
文件路径不可写​
1.99.0​
21103​
writeFileSync:fail user dir saved file size limit exceeded​
超出目录大小限制​
1.99.0​

代码示例​

js
复制
const fileSystemManager = tt.getFileSystemManager();
const filePath = `ttfile://user/example.txt`;
try {
fileSystemManager.writeFileSync(filePath, "example content", "utf8");
console.log("调用成功");
const data = fileSystemManager.readFileSync(filePath);
console.log("写入的内容为:", data);
} catch (err) {
console.log("调用失败", err);
}

Bug&Tip​

Tip: filePath 必须以 ttfile://user 开头。​