FileSystemManager.writeFile

简介

写文件。

使用限制

基础库 3.0.0 或更高版本支持。

参数

Object object

属性	类型	默认值	必填	说明
filePath	string		是	要写入的文件路径 (相对路径)
data	string		是	写入的内容，类型为 String (暂时不支持 ArrayBuffer)
encoding	string	utf8	否	只在 data 类型是 String 时有效，指定写入文件的字符编码，默认为 utf8。 合法值： 1. ascii 2. base64 3. binary 4. hex 5. ucs2 以小端序读取 6. ucs-2 以小端序读取 7. utf16le 以小端序读取 8. utf-16le 以小端序读取 9. utf-8 10. utf8 11. latin1
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

object.success 回调函数

参数

Object res

属性	类型	说明
bytesWritten	number	实际被写入到文件中的字节数（注意，被写入的字节数不一定与被写入的字符串字符数相同）
success	string	true-成功

object.fail 回调函数

参数

Object res

属性	类型	说明
errMsg	string	错误信息
success	string	false-失败

errMsg 说明

错误信息	说明
parameter error: F10001	参数不合法
fail sdcard not mounted: F10002	Android sdcard 挂载失败
fail the maximum size of the file storage limit exceeded: F10004	存储空间不足
fail permission denied: F10005, open ${filePath}	指定的 filePath 路径没有读权限
fail no such file or directory: F10007，open ${filePath}	指定的 filePath 所在目录不存在
the named is ${encoding} charset is not supported!	当前字符编码不支持

示例代码

// pages/index/index.js

Page({
  writeFile() {
    const fs = dlt.getFileSystemManager();
    fs.writeFile({
      filePath: `${dlt.env.USER_DATA_PATH}/hello.txt`,
      data: "some text",
      encoding: "utf8",
      success(res) {
        console.log(res);
      },
      fail(res) {
        console.error(res);
      },
    });
  },
});