穩(wěn)定性: 3 - 穩(wěn)定
本模塊包含一系列處理和轉(zhuǎn)換文件路徑的工具集?;舅械姆磸?fù)都僅對(duì)字符串轉(zhuǎn)換。文件系統(tǒng)不會(huì)檢查路徑是否有效。
通過(guò) require('path')
來(lái)訪問(wèn)這個(gè)模塊。提供了以下方法:
規(guī)范化路徑,注意'..'
和 '.'
。
發(fā)現(xiàn)多個(gè)斜杠時(shí),會(huì)替換成一個(gè)斜杠。當(dāng)路徑末尾包含一個(gè)斜杠時(shí),保留。Windows 系統(tǒng)使用反斜杠。
例如:
path.normalize('/foo/bar//baz/asdf/quux/..')
// returns
'/foo/bar/baz/asdf'
連接所有的參數(shù),并規(guī)范化輸出路徑。
參數(shù)必須是字符串。在 v0.8 版本,非字符參數(shù)會(huì)被忽略。v0.10之后的版本后拋出異常。
例如:
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
將 to
參數(shù)解析為絕對(duì)路徑。
如果參數(shù) to
不是一個(gè)相對(duì)于參數(shù) from
的絕對(duì)路徑,to
會(huì)添加到 from
右側(cè),直到找到一個(gè)絕對(duì)路徑為止。如果使用所有 from
參數(shù)后,還是沒(méi)有找到絕對(duì)路徑,將會(huì)使用當(dāng)前工作目錄。返回的路徑已經(jīng)規(guī)范化過(guò),并且去掉了尾部的斜杠(除非是根目錄)。非字符串的參數(shù)會(huì)被忽略。
另一種思路就是在shell里執(zhí)行一系列的 cd
命令。
path.resolve('foo/bar', '/tmp/file/', '..', 'a/../subfile')
類似于:
cd foo/bar
cd /tmp/file/
cd ..
cd a/../subfile
pwd
不同點(diǎn)是,不同的路徑不需要存在的,也可能是文件。
例如:
path.resolve('/foo/bar', './baz')
// returns
'/foo/bar/baz'
path.resolve('/foo/bar', '/tmp/file/')
// returns
'/tmp/file'
path.resolve('wwwroot', 'static_files/png/', '../gif/image.gif')
// if currently in /home/myself/node, it returns
'/home/myself/node/wwwroot/static_files/gif/image.gif'
判斷參數(shù) path
是否是絕對(duì)路徑。一個(gè)絕對(duì)路徑解析后都會(huì)指向相同的位置,無(wú)論當(dāng)前的工作目錄在哪里。
Posix 例子:
path.isAbsolute('/foo/bar') // true
path.isAbsolute('/baz/..') // true
path.isAbsolute('qux/') // false
path.isAbsolute('.') // false
Windows 例子:
path.isAbsolute('//server') // true
path.isAbsolute('C:/foo/..') // true
path.isAbsolute('bar\\baz') // false
path.isAbsolute('.') // false
解決從 from
到 to
的相對(duì)路徑。
有時(shí)我們會(huì)有2個(gè)絕對(duì)路徑,需要從中找到相對(duì)目錄。這是 path.resolve
的逆實(shí)現(xiàn):
path.resolve(from, path.relative(from, to)) == path.resolve(to)
例如:
path.relative('C:\\orandea\\test\\aaa', 'C:\\orandea\\impl\\bbb')
// returns
'..\\..\\impl\\bbb'
path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb')
// returns
'../../impl/bbb'
返回路徑 p
所在的目錄。和 Unix dirname
命令類似。
例如:
path.dirname('/foo/bar/baz/asdf/quux')
// returns
'/foo/bar/baz/asdf'
返回路徑的最后一個(gè)部分。和 Unix basename
命令類似。
例如:
path.basename('/foo/bar/baz/asdf/quux.html')
// returns
'quux.html'
path.basename('/foo/bar/baz/asdf/quux.html', '.html')
// returns
'quux'
返回路徑 p
的擴(kuò)展名,從最后一個(gè) '.' 到字符串的末尾。如果最后一個(gè)部分沒(méi)有 '.' ,或者路徑是以 '.' 開(kāi)頭,則返回空字符串。例如。
path.extname('index.html')
// returns
'.html'
path.extname('index.coffee.md')
// returns
'.md'
path.extname('index.')
// returns
'.'
path.extname('index')
// returns
''
特定平臺(tái)的文件分隔符,'\\'
或 '/'
。
*nix 上的例子:
'foo/bar/baz'.split(path.sep)
// returns
['foo', 'bar', 'baz']
Windows 的例子:
'foo\\bar\\baz'.split(path.sep)
// returns
['foo', 'bar', 'baz']
特定平臺(tái)的分隔符, ;
or ':'
.
*nix 上的例子:
console.log(process.env.PATH)
// '/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin'
process.env.PATH.split(path.delimiter)
// returns
['/usr/bin', '/bin', '/usr/sbin', '/sbin', '/usr/local/bin']
Windows 例子:
console.log(process.env.PATH)
// 'C:\Windows\system32;C:\Windows;C:\Program Files\nodejs\'
process.env.PATH.split(path.delimiter)
// returns
['C:\\Windows\\system32', 'C:\\Windows', 'C:\\Program Files\\nodejs\\']
返回路徑字符串的對(duì)象。
*nix 上的例子:
path.parse('/home/user/dir/file.txt')
// returns
{
root : "/",
dir : "/home/user/dir",
base : "file.txt",
ext : ".txt",
name : "file"
}
Windows 例子:
path.parse('C:\\path\\dir\\index.html')
// returns
{
root : "C:\\",
dir : "C:\\path\\dir",
base : "index.html",
ext : ".html",
name : "index"
}
從對(duì)象中返回路徑字符串,和 path.parse
相反。
path.format({
root : "/",
dir : "/home/user/dir",
base : "file.txt",
ext : ".txt",
name : "file"
})
// returns
'/home/user/dir/file.txt'
提供上述 path
路徑訪問(wèn),不過(guò)總是以 posix 兼容的方式交互。
提供上述 path
路徑訪問(wèn),不過(guò)總是以 win32 兼容的方式交互。