以異步方式建立一個目錄。若目標目錄已存在,則會拋出異常。
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 時即使目錄已存在也不會報錯。