需要把多段路徑片段組合成一條完整路徑時,path.join 是最安全、最方便的方法,它會自動處理分隔符與 .. 的抵消。
它會把多個參數組合成一個 path。
path.join([path1], [path2], [...])
由於屬於 path 模組,使用前需先引入:
var path = require("path");
path.join('/foo', 'bar', 'baz/asdf', 'quux', '..')
// returns
'/foo/bar/baz/asdf'
path.join('foo', {}, 'bar')
// throws exception
TypeError: Arguments to path.join must be strings
第一個例子示範了正常拼接並把結尾的 .. 抵消;第二個例子則說明:如果傳入非字串參數,會拋出 TypeError。
以 Windows 版為例,它會先驗證每個參數都是字串,再以反斜線拼接,接著避免開頭出現兩個斜線被誤判為 UNC 路徑,最後呼叫 normalize 做正規化:
// windows version
exports.join = function() {
function f(p) {
if (!util.isString(p)) {
throw new TypeError('Arguments to path.join must be strings');
}
return p;
}
var paths = Array.prototype.filter.call(arguments, f);
var joined = paths.join('\\');
// 避免開頭兩個斜線被誤判為 UNC 路徑
if (!/^[\\\/]{2}[^\\\/]/.test(paths[0])) {
joined = joined.replace(/^[\\\/]{2,}/, '\\');
}
return exports.normalize(joined);
};
因此,拼接動態組成的路徑時,path.join 比手動用字串相加來得可靠得多。