filehandle.readFile(options)
options
<Object> | <string>encoding
<string> | <null> 默认值:null
signal
<AbortSignal> 允许中止正在进行的读取文件
- 返回: <Promise> 成功读取时将使用文件内容履行。
如果未指定编码(使用
options.encoding
),则数据作为 <Buffer> 对象返回。 否则,数据将为字符串。
异步地读取文件的全部内容。
如果 options
是字符串,则它指定 encoding
。
<FileHandle> 必须支持读取。
如果在文件句柄上进行了一次或多次 filehandle.read()
调用,然后进行 filehandle.readFile()
调用,则将从当前位置读取数据,直到文件末尾。
它并不总是从文件的开头读取。
options
<Object> | <string>encoding
<string> | <null> Default:null
signal
<AbortSignal> allows aborting an in-progress readFile
- Returns: <Promise> Fulfills upon a successful read with the contents of the
file. If no encoding is specified (using
options.encoding
), the data is returned as a <Buffer> object. Otherwise, the data will be a string.
Asynchronously reads the entire contents of a file.
If options
is a string, then it specifies the encoding
.
The <FileHandle> has to support reading.
If one or more filehandle.read()
calls are made on a file handle and then a
filehandle.readFile()
call is made, the data will be read from the current
position till the end of the file. It doesn't always read from the beginning
of the file.