FileSystemManager.open

简介

打开文件，返回文件描述符。

使用限制

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

参数

Object object

属性	类型	默认值	必填	说明
filePath	string		是	文件路径 (相对路径)
flag	string	r	否	文件系统标志，默认值: 'r'。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

文件系统标志 flag 合法值说明

合法值	说明
a	打开文件用于追加。 如果文件不存在，则创建该文件。
a+	打开文件用于读取和追加。 如果文件不存在，则创建该文件。
ax	类似于 'a'，但如果路径存在，则失败。
ax+	类似于 'a+'，但如果路径存在，则失败。
w	打开文件用于写入。 如果文件不存在则创建文件，如果文件存在则截断文件。
w+	打开文件用于读取和写入。 如果文件不存在则创建文件，如果文件存在则截断文件。
wx	类似于 'w'，但如果路径存在，则失败。
wx+	类似于 'w+'，但如果路径存在，则失败。
r	打开文件用于读取。 如果文件不存在，则会发生异常。
r+	打开文件用于读取和写入。 如果文件不存在，则会发生异常。

object.success 回调函数

参数

Object res

属性	类型	说明
fd	string	文件描述符
success	string	true-成功

object.fail 回调函数

参数

Object res

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

errMsg 说明

错误信息	说明
parameter error: F10001	参数不合法
fail sdcard not mounted: F10002	Android sdcard 挂载失败
fail no such file or directory: F10007 ${dirPath}.	上级目录不存在

示例代码

// pages/index/index.js

Page({
  open() {
    const fs = dlt.getFileSystemManager();
    fs.open({
      filePath: `${dlt.env.USER_DATA_PATH}/hello.txt`,
      flag: "a+",
      success: (res) => {
        console.log("success", res);
      },
      fail: (res) => {
        console.log("fail", res);
      },
      complete: (res) => {
        console.log("complete", res);
      },
    });
  },
});