同步版本的 fs.read(),從檔案描述符讀取資料並寫入緩衝區,回傳值為實際讀取到的位元組數 bytesRead。
fs.readSync(fd, buffer, offset, length, position)
屬於 fs 模塊,使用前先引入:
var fs = require("fs");
fd:檔案描述符,由 fs.open() 取得。buffer:資料將被寫入的緩衝區。offset:在 buffer 中的寫入偏移量。length:本次要讀取的位元組數。position:檔案中的讀取起始位置。若為 null,則從當前檔案指針位置開始讀取。var fs = require('fs');
fs.open('123.txt', 'r', function (err, fd) {
if (err) {
console.error(err);
return;
}
var buf = new Buffer(8);
var readfile = fs.readSync(fd, buf, 0, 8, null);
console.log(readfile);
});
fs.readSync = function(fd, buffer, offset, length, position) {
var legacy = false;
if (!util.isBuffer(buffer)) {
// 舊版字串介面 (fd, length, position, encoding, callback)
legacy = true;
var encoding = arguments[3];
assertEncoding(encoding);
position = arguments[2];
length = arguments[1];
buffer = new Buffer(length);
offset = 0;
}
var r = binding.read(fd, buffer, offset, length, position);
if (!legacy) {
return r;
}
var str = (r > 0) ? buffer.toString(encoding, 0, r) : '';
return [str, r];
};
源碼裡最值得注意的一段是開頭的相容性處理:如果第一個參數傳進來的不是 Buffer,就判定為使用了早期那種「fd、length、position、encoding」的字串介面,此時函式會自行建立緩衝區,最後把內容轉成字串,並以 [字串, 位元組數] 的形式回傳。新版介面則一律回傳位元組數。
範例中的 new Buffer(8) 已屬不建議使用的寫法,請改用 Buffer.alloc(8);若要從既有資料建立,則用 Buffer.from()。另外,同步 API 會阻塞事件迴圈,在伺服器請求路徑上大量使用會直接拖累吞吐量,適合用在啟動階段讀取設定檔這類一次性場景。真正的高併發讀檔,還是以 fs.read() 或 createReadStream() 為宜。最後别忘了,用完檔案描述符要呼叫 fs.close()(或 fs.closeSync())釋放,否則檔案描述符遲早會耗盡。