以異步方式讀取一個符號鏈接所指向的路徑。
fs.readlink(path, [callback(err, linkString)])
屬於 fs 模塊,使用前先引入:
var fs = require("fs");
path:鏈接的路徑。callback:回調函式,接收兩個參數——異常物件 err,以及回傳的鏈接目標字串 linkString。fs.readlink = function(path, callback) {
callback = makeCallback(callback);
if (!nullCheck(path, callback)) return;
binding.readlink(pathModule._makeLong(path), callback);
};
短短四行,卻示範了 fs 模塊的固定套路:先用 makeCallback 確保回調是函式,再用 nullCheck 攔下含空字節的路徑(這種路徑會讓底層系統呼叫失敗,且錯誤訊息往往不夠直觀),最後才把路徑交給底層 binding 執行。前面我們看過的 mkdir、readdir 等方法,開頭幾行都是同樣的模式。
符號鏈接(symbolic link)是 Unix-like 系統的檔案類型,類似 Windows 的捷徑但層次更底層。要區分幾個容易搞混的 API:fs.readlink 讀的是鏈接本身指向哪裡;fs.readFile 讀的是鏈接最終指向的檔案內容;而 fs.lstat 取得的是鏈接自身的狀態資訊,fs.stat 則會追蹤到目標檔案。若要在程式裡判斷某路徑是否為鏈接,通常靠 lstat 回傳物件上的 isSymbolicLink()。
另外提醒,Windows 上的 .lnk 檔案並不是 POSIX 意義下的符號鏈接,fs.readlink 無法解析它;它只認得 junction 與真正的 symbolic link。