DIV CSS 佈局教程網

Node.js 中的 fs.readdirSync 方法詳解
編輯:關於JavaScript     

方法說明

同步版本的 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,既保有可讀性又不犧牲併發能力。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved