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

对文件内容进行截断操作，只有用户目录ttfile://user下的文件可以截断。

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

语法

FileSystemManager.truncate(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
length	number	0	否	截断长度，要求是自然数。若 length < 文件长度（字节），则前 length 个字节内容会保留在文件中，其余内容删除；若 length > 文件长度，则会对文件进行扩展，扩展部分将填充空字节 '\0'	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

回调成功

object 类型，属性如下：

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

回调失败

object 类型，属性如下：

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

错误码

errNo	errMsg	说明	最低支持版本
20000	truncate:fail filePath is invalid	filePath 参数错误	3.1.0
21101	truncate:fail permission denied, truncate %s	文件路径不可写	3.1.0
21102	truncate:fail no such file or directory, truncate %s	filePath 文件不存在	3.1.0
21103	truncate:fail user dir saved file size limit exceeded	超出目录大小限制	3.1.0
21104	truncate:fail operation not permitted, truncate %s	filePath 类型不是文件	3.1.0

代码示例

const fs = tt.getFileSystemManager();
fs.truncate({
  filePath: `ttfile://user/example.txt`,
  length: 10,
  success(res) {
    console.log(res)
  },
  fail(res) {
    console.error(res)
  },
});
// 同步接口
try {
  fs.truncateSync(`ttfile://user/example.txt`, 10);
} catch (e) {
  console.error(e);
}