node.js基础API（一）:Path

Path（路径）

path 模块提供了一些工具函数，用于处理文件与目录的路径。可以通过以下方式使用：

const path = require('path');

path.normalize()

path.normalize() 方法会规范化给定的 path，并解析 ‘..’ 和 ‘.’ 片段。如果 path 是一个长度为零的字符串，则返回 ‘.’，表示当前工作目录。

const {normalize} = require ('path');

console.log(normalize('/usr//local/bin'));       // '\usr\local\bin'
console.log(normalize('/usr//local/../bin'));   //  '\usr\bin'

path.join([…paths])

path.join() 方法使用平台特定的分隔符把全部给定的 path 片段连接到一起，并规范化生成的路径。长度为零的 path 片段会被忽略。 如果连接后的路径字符串是一个长度为零的字符串，则返回 ‘.’，表示当前工作目录。

const {join} = require ('path');

console.log(join('/usr','local','bin/'));       // '\usr\local\bin\'
console.log(join('/usr','../local','bin/'));    //  '\usr\bin'

path.resolve([…paths])

path.resolve() 方法会把一个路径或路径片段的序列解析为一个绝对路径。给定的路径的序列是从右往左被处理的，后面每个 path 被依次解析，直到构造完成一个绝对路径。

const {resolve} = require ('path');

console.log(resolve('/foo','/bar','./baz')); // 'H:\bar\baz'

/*生成的路径是规范化后的，且末尾的斜杠会被删除，除非路径被解析为根目录。*/
console.log(resolve('/foo','/bar/baz/'));       // 'H:\bar\baz'

console.log(resolve('foo','bar/baz/','../local')); // 'H:\web\node\foo\bar\local'

path.dirname(path)， path.extname(path)， path.basename(path[, ext])

path.dirname(path)：返回一个 path 的目录名
path.extname(path)：返回一个 path 的扩展名
path.basename(path[, ext])：返回一个 path 的文件名

const {basename,dirname,extname} = require ('path');

console.log(basename('/usr/local/bin/foo.js'));         //'foo.js'
console.log(basename('/usr/local/bin/foo.js','.js'));   //'foo'
console.log(dirname('/usr/local/bin/foo.js'));          //'/usr/local/bin'
console.log(extname('/usr/local/bin/foo.js'));          //'.js'

path.format(pathObject)，path.parse(path)

path.format(pathObject)：从一个对象返回一个路径字符串。如果提供了 pathObject.dir，则 pathObject.root 会被忽略；如果提供了 pathObject.base 存在，则 pathObject.ext 和 pathObject.name 会被忽略。
path.parse(path)：返回一个表示 path 的元素的对象。

const {parse,format} = require ('path');

const file = '/usr/local/bin/foo.js';
const ret = parse(file);
console.log(ret);               //''{ root: '/',
                                     dir: 'usr/local/bin',
                                     base: 'foo.js',
                                     ext: '.js',
                                     name: 'foo' }''

console.log(format(ret));       //'/usr/local/bin\foo.js'

path.sep，path.delimiter

path.sep：提供了平台特定的路径片段分隔符，Windows是‘\’，POSIX 上是 ‘/’
path.delimiter：提供平台特定的路径分隔符，Windows是‘；’，POSIX 上是 ‘：’

const {sep,delimiter,win32,posix} = require ('path');

console.log('win32.sep: ',win32.sep);                   //'win32.sep:  \'
console.log('posix.sep: ',posix.sep);                   //'posix.sep:  /'
console.log('posix.delimiter: ',posix.delimiter);       //'posix.delimiter:  :'
console.log('win32.delimiter: ',win32.delimiter);       //'win32.delimiter:  ;'

参考资料：http://nodejs.cn/api/path.html