方法說明:
回傳一個 ReadStream(檔案讀取流、輸入流、可讀流)物件。
語法:
代碼如下:
fs.createReadStream(path, [options])
由於此法屬於 fs 模組,使用前需先引入 fs 模組(var fs = require("fs"))。
參數:
path: (string) 欲讀取的檔案路徑
options : (object) 包含以下屬性
代碼如下:
{ flags: 'r',
encoding: null,
fd: null,
mode: 0666,
autoClose: true
}
options 可透過 start 與 end 設定可讀取的字節範圍,而不必讀取整個檔案。
若 start 與 end 都被包含,則會從 0 開始。
encoding 可為 'utf8'、'ascii' 或 'base64' 三種格式。
若 autoClose 為 false,即使發生錯誤,檔案描述符也不會被關閉。
最好還是把它關掉並確保不會出現檔案描述符洩漏。
若 autoClose 為 true(預設行為),當檔案發生錯誤或結束時,描述符會自動關閉。
範例:
以下範例會讀取一個 100KB 檔案中最後 10 個字節的內容。
代碼如下:
fs.createReadStream('sample.txt', {start: 90, end: 99});
源碼:
代碼如下:
fs.createReadStream = function(path, options) {
return new ReadStream(path, options);
};