DIV CSS 佈局教程網

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

方法說明

以異步方式建立一個目錄。若目標目錄已存在,則會拋出異常。

語法

fs.mkdir(path, [mode], [callback(err)])

該方法屬於 fs 模塊,使用前需先引入:

var fs = require("fs");

參數說明

  • path:要建立的目錄路徑。
  • mode:目錄的讀寫權限,預設為 0777。可省略;若省略並直接傳入函式,Node 會自動把它當作 callback 處理。
  • callback:回調函式,接收一個異常參數 err。

使用範例

var fs = require('fs');
fs.mkdir('creatdir', 0777, function (err) {
  if (err) {
    console.log(err);
  } else {
    console.log("creat done!");
  }
});

源碼解析

fs.mkdir = function(path, mode, callback) {
  if (util.isFunction(mode)) callback = mode;
  callback = makeCallback(callback);
  if (!nullCheck(path, callback)) return;
  binding.mkdir(pathModule._makeLong(path),
                modeNum(mode, 511 /*=0777*/),
                callback);
};

從源碼可以看出幾件事:util.isFunction(mode) 這行解釋了為什麼第二個參數可以省略——偵測到傳入的是函式時,就把它挪到 callback 的位置。makeCallback 確保回調一定是函式,避免呼叫時拋出類型錯誤。nullCheck 則攔下路徑中含有空字節的情況,因為那會讓底層系統呼叫失敗。pathModule._makeLong 是 Windows 平台上的長路徑轉換,而 511 正是十進制的 0777。

實務提醒

異步版本的錯誤必須在回調裡處理,否則等於靜默失敗。若希望程式碼更接近同步風格、又不想阻塞後續流程,可以搭配 util.promisify 或直接用 fs.promises.mkdir 搭配 await。另外,fs.mkdir 預設不會一口氣建立多層目錄;若想一次建好 a/b/c 這樣的路徑,較新的 Node 版本支援傳入 { recursive: true } 選項,設為 true 時即使目錄已存在也不會報錯。

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