# FileSystemManager.read(Object object)

基础库 2.16.1 开始支持，低版本需做兼容处理。

以 Promise 风格调用：不支持

微信鸿蒙 OS 版：支持

相关文档: 文件系统

# 功能描述

读文件

# 参数

# Object object

属性	类型	默认值	必填	说明
fd	string		是	文件描述符。fd 通过 FileSystemManager.open 或 FileSystemManager.openSync 接口获得
arrayBuffer	ArrayBuffer		是	数据写入的缓冲区，必须是 ArrayBuffer 实例
offset	number	0	否	缓冲区中的写入偏移量，默认0
length	number	0	否	要从文件中读取的字节数，默认0
position	number		否	文件读取的起始位置，如不传或传 null，则会从当前文件指针的位置读取。如果 position 是正整数，则文件指针位置会保持不变并从 position 读取文件。
success	function		否	接口调用成功的回调函数
fail	function		否	接口调用失败的回调函数
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）

# object.success 回调函数

# 参数

# Object res

属性	类型	说明
bytesRead	number	实际读取的字节数
arrayBuffer	ArrayBuffer	被写入的缓存区的对象，即接口入参的 arrayBuffer

# 错误

错误码	错误信息	说明
1300001	operation not permitted	操作不被允许（例如，filePath 预期传入一个文件而实际传入一个目录）
1300002	no such file or directory ${path}	文件/目录不存在，或者目标文件路径的上层目录不存在
1300005	Input/output error	输入输出流不可用
1300009	bad file descriptor	无效的文件描述符
1300013	permission denied	权限错误，文件是只读或只写
1300014	Path permission denied	传入的路径没有权限
1300020	not a directory	dirPath 指定路径不是目录，常见于指定的写入路径的上级路径为一个文件的情况
1300021	Is a directory	指定路径是一个目录
1300022	Invalid argument	无效参数，可以检查length或offset是否越界
1300036	File name too long	文件名过长
1300066	directory not empty	目录不为空
1300201	system error	系统接口调用失败
1300202	the maximum size of the file storage limit is exceeded	存储空间不足，或文件大小超出上限（上限100M）
1300203	base64 encode error	字符编码转换失败（例如 base64 格式错误）
1300300	sdcard not mounted	android sdcard 挂载失败
1300301	unable to open as fileType	无法以fileType打开文件
1301000	permission denied, cannot access file path	目标路径无访问权限（usr目录）
1301002	data to write is empty	写入数据为空
1301003	illegal operation on a directory	不可对目录进行此操作（例如，指定的 filePath 是一个已经存在的目录）
1301004	illegal operation on a package directory	不可对代码包目录进行此操作
1301005	file already exists ${dirPath}	已有同名文件或目录
1301006	value of length is out of range	传入的 length 不合法
1301007	value of offset is out of range	传入的 offset 不合法
1301009	value of position is out of range	position值越界
1301100	store directory is empty	store目录为空
1301102	unzip open file fail	压缩文件打开失败
1301103	unzip entry fail	解压单个文件失败
1301104	unzip fail	解压失败
1301111	brotli decompress fail	brotli解压失败（例如，指定的 compressionAlgorithm 与文件实际压缩格式不符）
1301112	tempFilePath file not exist	指定的 tempFilePath 找不到文件
1302001	fail permission denied	指定的 fd 路径没有读权限/没有写权限
1302002	excced max concurrent fd limit	fd数量已达上限
1302003	invalid flag	无效的flag
1302004	permission denied when open using flag	无法使用flag标志打开文件
1302005	array buffer does not exist	未传入arrayBuffer
1302100	array buffer is readonly	arrayBuffer只读

# 示例代码

const fs = wx.getFileSystemManager()
const ab = new ArrayBuffer(1024)
// 打开文件
fs.open({
  filePath: `${wx.env.USER_DATA_PATH}/hello.txt`,
  flag: 'a+',
  success(res) {
    // 读取文件到 ArrayBuffer 中
    fs.read({
      fd: res.fd,
      arrayBuffer: ab,
      length: 10,
      success(res) {
        console.log(res)
      }
    })
  }
})

# 注意事项

小游戏 iOS 高性能模式（iOSHighPerformance）暂不支持 FileSystemManager.read 接口，请使用 FileSystemManager.readFile 接口代替