同步版本的 fs.readdir(),直接回傳一個陣列,內容為指定目錄底下所有項目的名稱。
fs.readdirSync(path)
屬於 fs 模塊,使用前先引入:
var fs = require("fs");
path:目錄路徑。var fs = require('fs');
var readDir = fs.readdirSync('readdirtest11');
console.log(readDir);
由於是同步版本,錯誤不會透過回調傳遞,而是直接拋出異常。目錄不存在、路徑指向的是檔案而非目錄、權限不足等情況都會引發 throw,因此正式環境請務必包上 try...catch:
var fs = require('fs');
try {
var files = fs.readdirSync('readdirtest11');
console.log(files);
} catch (err) {
console.error('讀取目錄失敗:', err.message);
}
fs.readdirSync = function(path) {
nullCheck(path);
return binding.readdir(pathModule._makeLong(path));
};
比異步版本更精簡:沒有 callback 需要處理,因此省掉了 makeCallback,只保留 nullCheck 與長路徑轉換,最後直接回傳底層結果。
同步 API 的簡潔很吸引人,但代價是阻塞。在伺服器請求處理流程中呼叫 readdirSync,會讓整個事件迴圈停下來等磁碟回應,影響的是全部併發連線。它真正合適的位置是:程式啟動時掃描一次靜態資源目錄、命令列工具的一次性執行、建置腳本或測試輔助程式。除此之外,請優先使用異步版本,或直接採用 fs.promises.readdir 搭配 await,既保有可讀性又不犧牲併發能力。