# FileSystemManager.writeFile(Object object)

以 Promise 风格调用：不支持

小程序插件：支持，需要小程序基础库版本不低于 2.19.2

相关文档: 文件系统

# 功能描述

写文件

# 参数

# Object object

属性

类型

默认值

必填

说明

filePath

string

是

要写入的文件路径 (本地路径)

data

string/ArrayBuffer

是

要写入的文本或二进制数据

encoding

string

utf8

否

指定写入文件的字符编码

合法值	说明
ascii
base64
binary
hex
ucs2	以小端序读取
ucs-2	以小端序读取
utf16le	以小端序读取
utf-16le	以小端序读取
utf-8
utf8
latin1

success

function

否

接口调用成功的回调函数

fail

function

否

接口调用失败的回调函数

complete

function

否

接口调用结束的回调函数（调用成功、失败都会执行）

# object.fail 回调函数

# 参数

# Object res

属性

类型

说明

errMsg

string

错误信息

合法值	说明
fail no such file or directory, open ${filePath}	指定的 filePath 所在目录不存在
fail permission denied, open ${dirPath}	指定的 filePath 路径没有写权限
fail the maximum size of the file storage limit is exceeded	存储空间不足
fail sdcard not mounted	Android sdcard 挂载失败

# 示例代码

const fs = wx.getFileSystemManager()
fs.writeFile({
  filePath: `${wx.env.USER_DATA_PATH}/hello.txt`,
  data: 'some text or arrayBuffer',
  encoding: 'utf8',
  success(res) {
    console.log(res)
  },
  fail(res) {
    console.error(res)
  }
})

// 同步接口
try {
  const res = fs.writeFileSync(
    `${wx.env.USER_DATA_PATH}/hello.txt`,
    'some text or arrayBuffer',
    'utf8'
  )
  console.log(res)
} catch(e) {
  console.error(e)
}