Skip to content
On this page

FileSystemManager.readFile

以 Promise 风格调用:不支持

读取本地文件内容

参数

参数类型默认值必填说明
filePathstring要读取的文件的路径 (本地路径)
encodingstringutf8指定读取文件的字符编码,如果不传 encoding,则以 ArrayBuffer 格式读取文件的二进制内容
合法值说明
ascii
base64
binary
hex
ucs2以小端序读取
ucs-2以小端序读取
utf16le以小端序读取
utf-16le以小端序读取
utf-8
utf8
latin1
positionnumber从文件指定位置开始读,如果不指定,则从文件头开始读。读取的范围应该是左闭右开区间 [position, position+length)。有效范围:[0, fileLength - 1]。单位:byte
lengthnumber指定文件的长度,如果不指定,则读到文件末尾。有效范围:[1, fileLength]。单位:byte
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

成功返回

属性类型说明
datastring | ArrayBuffer文件内容

Example

ts
const fs = ek.getFileSystemManager()
fs.readFile({
  filePath: `${ek.env.USER_DATA_PATH}/hello.txt`,
  encoding: 'utf8',
  position: 0,
  success: res => {
    console.log(res.data)
  },
  fail: err => {
    console.error(err)
  }
})