這是一篇讀Nodejs API的讀書筆記(抄書筆記)
path模塊
小總結(jié):
ext 擴(kuò)展名
base 文件全名
dir 路徑名(不包括文件名)
delimiter 分隔符
root 你懂的
----------------------------------------
path 路徑 用win32近零、posix
path.basename(path[, ext])
返回最后一部分如index.html, ext為擴(kuò)展名,加了后就不返回?cái)U(kuò)展名
path.delimiter 是分割符 ; 或 : 用split分割
path.sep 路徑分隔符 win: \, POSIX: /
path.dirname(path) 返回目錄名椅亚,不包括當(dāng)前
path.extname(path) 返回文件擴(kuò)展名
path.format(pathObject) 把dir顺囊、root姻乓、base晰搀、name、ext組合办斑,有優(yōu)先級
path.isAbsolute(path) 判斷是否為絕對路徑
path.join([...paths]) 組合路徑
path.normalize(path) 規(guī)范化路徑
path.parse(path) 和format 相反 返回對象dir外恕、root、base乡翅、name鳞疲、ext
path.relative(from, to) from到to的相對路徑,無參數(shù)有區(qū)別
path.resolve([...paths]) 把片段路徑解析為絕對路徑蠕蚜,無參數(shù)返回當(dāng)前
path(路徑)
path是nodejs的模塊尚洽,提供了一些工具函數(shù),用于處理文件與目錄的路徑
使用方法
const path = require('path')
path模塊在windows與POSIX環(huán)境下的不同
path模塊的默認(rèn)操作會(huì)因?yàn)閚ode運(yùn)行環(huán)境的不同而變化
在POSIX上
path.basename('C:\\temp\\myfile.html');
// 返回: 'C:\\temp\\myfile.html'
在 Windows 上:
path.basename('C:\\temp\\myfile.html');
// 返回: 'myfile.html'
處理windows文件路徑
path.win32.basename('C:\\temp\\myfile.html');
// 返回: 'myfile.html'
處理POSIX文件路徑
path.posix.basename('/tmp/myfile.html');
// 返回: 'myfile.html'
POSIX是UNIX的一套可移植性標(biāo)準(zhǔn)
path.basename(path[, ext])
- path
<string>
- ext
<string>
可選 - 返回
<string>
path.basename() 方法返回一個(gè) path 的最后一部分靶累,類似于 Unix 中的 basename 命令腺毫。
path.basename('/foo/bar/baz/asdf/quux.html')
// 返回: 'quux.html'
path.basename('/foo/bar/baz/asdf/quux.html', '.html')
// 返回: 'quux'
path.delimiter
path.delimiter是分隔符,windows上是;
挣柬,POSIX是:
在windows上:
console.log(process.env.PATH)
// 輸出: 'C:\Windows\system32;C:\Windows;C:\Program Files\node\'
process.env.PATH.split(path.delimiter)
// 返回: ['C:\\Windows\\system32', 'C:\\Windows', 'C:\\Program Files\\node\\']
在POSIX上:
console.log(process.env.PATH)
// 輸出: '/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin'
process.env.PATH.split(path.delimiter)
// 返回: ['/usr/bin', '/bin', '/usr/sbin', '/sbin', '/usr/local/bin']
```![在windows上給路徑分割了數(shù)組](http://upload-images.jianshu.io/upload_images/2155778-6fc1dbe9cd8917cf.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)
path.dirname(path)
- path
<string>
不是字符串就報(bào)錯(cuò)
path.dirname() 方法返回一個(gè) path 的目錄名潮酒,類似于 Unix 中的 dirname 命令。
path.dirname('/foo/bar/baz/asdf/quux')
// 返回: '/foo/bar/baz/asdf'
path.extname(path)
- path
<string>
非字符串報(bào)錯(cuò) - return
<string>
返回path的擴(kuò)展名邪蛔,有.
就返回.
急黎,沒有就返回空
path.format(pathObject)
- pathObject
<object>
- dir
<string>
- root
<string>
- base
<string>
- name
<string>
- ext
<string>
- dir
- return
<string>
path.format()方法會(huì)從一個(gè)對象返回一個(gè)路徑字符串。 與 path.parse()
相反。
當(dāng) pathObject 提供的屬性有組合時(shí)勃教,有些屬性的優(yōu)先級比其他的高:
在 POSIX 上:
// 如果提供了 `dir`淤击、`root` 和 `base`,則返回 `${dir}${path.sep}${base}`故源。
// `root` 會(huì)被忽略污抬。
path.format({
root: '/ignored',
dir: '/home/user/dir',
base: 'file.txt'
});
// 返回: '/home/user/dir/file.txt'
// 如果沒有指定 `dir`,則 `root` 會(huì)被使用心软。
// 如果只提供了 `root` 或 `dir` 等于 `root`壕吹,則平臺(tái)的分隔符不會(huì)被包含。
// `ext` 會(huì)被忽略删铃。
path.format({
root: '/',
base: 'file.txt',
ext: 'ignored'
});
// 返回: '/file.txt'
// 如果沒有指定 `base`耳贬,則 `name` + `ext` 會(huì)被使用。
path.format({
root: '/',
name: 'file',
ext: '.txt'
});
// 返回: '/file.txt'
在 Windows 上:
path.format({
dir : "C:\\path\\dir",
base : "file.txt"
});
// 返回: 'C:\\path\\dir\\file.txt'
path.isAbsolute(path)
- path
<string>
- return
<boolean>
path.isAbsolute() 方法會(huì)判定 path 是否為一個(gè)絕對路徑猎唁。
如果給定的 path 是一個(gè)長度為零的字符串咒劲,則返回 false。
例如诫隅,在 POSIX 上:
path.isAbsolute('/foo/bar') // true
path.isAbsolute('/baz/..') // true
path.isAbsolute('qux/') // false
path.isAbsolute('.') // false
在 Windows 上:
path.isAbsolute('//server') // true
path.isAbsolute('\\\\server') // true
path.isAbsolute('C:/foo/..') // true
path.isAbsolute('C:\\foo\\..') // true
path.isAbsolute('bar\\baz') // false
path.isAbsolute('bar/baz') // false
path.isAbsolute('.') // false
path.join([...paths])
-
...paths
一個(gè)路徑片段的序列
path.join() 方法使用平臺(tái)特定的分隔符把全部給定的 path 片段連接到一起腐魂,并規(guī)范化生成的路徑。
長度為零的 path 片段會(huì)被忽略逐纬。 如果連接后的路徑字符串是一個(gè)長度為零的字符串蛔屹,則返回 '.',表示當(dāng)前工作目錄豁生。
path.join('/foo', 'bar', 'baz/asdf', 'quux', '..')
// 返回: '/foo/bar/baz/asdf' 這里的`..`表示上一層
path.join('foo', {}, 'bar')
// 拋出 TypeError: path.join 的參數(shù)必須為字符串
path.normalize(path)
path.normalize() 方法會(huì)規(guī)范化給定的 path兔毒,并解析 '..' 和 '.' 片段。
當(dāng)發(fā)現(xiàn)多個(gè)連續(xù)的路徑分隔符時(shí)(如 POSIX 上的 / 與 Windows 上的 \)甸箱,它們會(huì)被單一的路徑分隔符替換育叁。 末尾的多個(gè)分隔符會(huì)被保留。
例如芍殖,在 POSIX 上:
path.normalize('/foo/bar//baz/asdf/quux/..')
// 返回: '/foo/bar/baz/asdf'
在 Windows 上:
path.normalize('C:\\temp\\\\foo\\bar\\..\\');
// 返回: 'C:\\temp\\foo\\'
path.parse(path) 和format 相反
path.parse() 方法返回一個(gè)對象豪嗽,對象的屬性表示 path 的元素。
返回的對象有以下屬性:
- dir
<string>
- root
<string>
- base
<string>
- name
<string>
- ext
<string>
例如豌骏,在 POSIX 上:
path.parse('/home/user/dir/file.txt')
// 返回:
// {
// root : "/",
// dir : "/home/user/dir",
// base : "file.txt",
// ext : ".txt",
// name : "file"
// }
在 Windows 上:
path.parse('C:\\path\\dir\\file.txt')
// 返回:
// {
// root : "C:\\",
// dir : "C:\\path\\dir",
// base : "file.txt",
// ext : ".txt",
// name : "file"
// }
path.posix (開頭講的)
path.posix 屬性提供了 path 方法針對 POSIX 的實(shí)現(xiàn)龟梦。
path.relative(from, to)
path.relative() 方法返回從 from 到 to 的相對路徑。 如果 from 和 to 各自解析到同一路徑(調(diào)用 path.resolve())肯适,則返回一個(gè)長度為零的字符串变秦。
如果 from 或 to 傳入了一個(gè)長度為零的字符串,則當(dāng)前工作目錄會(huì)被用于代替長度為零的字符串框舔。
在 POSIX 上:
path.relative('/data/orandea/test/aaa', '/data/orandea/impl/bbb')
// 返回: '../../impl/bbb'
在 Windows 上:
path.relative('C:\\orandea\\test\\aaa', 'C:\\orandea\\impl\\bbb')
// 返回: '..\\..\\impl\\bbb'
to為0就到當(dāng)前蹦玫,from為0就直接到to
path.resolve([...paths])
path.resolve() 方法會(huì)把一個(gè)路徑或路徑片段的序列解析為一個(gè)絕對路徑赎婚。
則 path.resolve() 會(huì)返回當(dāng)前工作目錄的絕對路徑。
如果沒有傳入 path 片段樱溉,則 path.resolve() 會(huì)返回當(dāng)前工作目錄的絕對路徑挣输。
path.sep
提供了平臺(tái)特定的路徑片段分隔符:
Windows 上是 , POSIX 上是`/
在 POSIX 上:
'foo/bar/baz'.split(path.sep)
// 返回: ['foo', 'bar', 'baz']
在 Windows 上:
'foo\\bar\\baz'.split(path.sep)
// 返回: ['foo', 'bar', 'baz']
path.win32
path.win32 屬性提供了 path 方法針對 Windows 的實(shí)現(xiàn)。
注意:在 Windows 上福贞,斜杠字符(/)和反斜杠字符(\)都可作為路徑分隔符撩嚼; 但返回值中只用到反斜杠(\)。