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

读文件

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

语法

FileSystemManager.readSync(params)

参数说明

params 类型说明

object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
position	number		否	文件读取的起始位置，如不传或传 null，则会从当前文件指针的位置读取。如果 position 是正整数，则文件指针位置会保持不变并从 position 读取文件。	3.74.0
length	number	0	否	要从文件中读取的字节数，默认 0	3.74.0
arrayBuffer	arrayBuffer		是	数据写入的缓冲区，必须是 ArrayBuffer 实例	3.74.0
fd	string		是	文件描述符。fd 通过 FileSystemManager.open 或 FileSystemManager.openSync 接口获得	3.74.0
offset	number	0	否	缓冲区中的写入偏移量，默认 0	3.74.0

返回值

返回值为 object 类型，详细参数描述如下：

属性名	类型	说明	最低支持版本
arrayBuffer	arrayBuffer	被写入的缓存区的对象，即接口入参的 arrayBuffer	3.74.0
bytesRead	number	实际读取的字节数	3.74.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

try {
  const fs = tt.getFileSystemManager();
  const arrayBuffer = new ArrayBuffer(1024);
  const res = fs.readSync({
    fd,
    arrayBuffer,
    offset: 0,
    position: 0,
    length: 10,
  });
  console.log("文件同步读取成功", res);
} catch (err) {
  console.error("文件同步读取失败", err);
}