NodeJS之path模块
常用的主要有如下工具函数:
1. path.basename(path[, ext])
2. path.extname(path)
3. path.dirname(path)
4. path.parse(path)
5. path.format(pathObject)
6. path.isAbsolute(path);
7. path.join([...paths])
8. path.relative(from, to)
9. path.resolve([from...], to);
一:path.basename(path[, ext])
参数解析如下:
path: <string>
ext: <string> 可选的文件扩展名
返回:<string>
path.basename(filepath), 是获取路径的最后一部分。 可以看看如下代码:
const path = require('path'); console.log(path.basename("/node/base/path/xx/js/index.js")); // 最后输出 index.js console.log(path.basename("/node/base/path/xx/js")); // 输出js console.log(path.basename("/node/base/path/xx/js/")); // js/ 带反斜杠,也一样输出js
1.1 获取文件名
如果只想获取文件名,不需要扩展名则可以使用第二个参数,第二个参数可以指定文件的扩展名;如下代码:
const path = require('path'); console.log(path.basename("/node/base/path/xx/js/index.js", '.js')); // 最后输出 index
二:path.extname(path)
该方法返回path的扩展名,即从path的最后一部分中的最后一个.(句号)字符到字符串结束。如果path的最后一部分没有 . 或 path的文件名的第一个
字符是 . ,则返回一个空字符串。如下代码:
const path = require('path'); console.log(path.extname('index.html')); // .html console.log(path.extname('index.coffee.md')); // .md console.log(path.extname('index.')); // 返回 . console.log(path.extname('index')); // 返回 '' console.log(path.extname('.index')); // 返回 ''
如果path不是一个字符串,则抛出 TypeError; 如下:
console.log(path.extname(111)); // 抛出异常
三:path.dirname(path)
该方法返回一个path的目录名。如下代码:
const path = require('path'); const filepath = '/node/base/path/index.js'; console.log(path.dirname(filepath)); // 输出 /node/base/path
四:path.parse(path)
path.parse()方法返回一个对象,对象的属性表示path的元素。如下代码:
const path = require('path');
const filepath = '/node/base/path/index.js';
console.log(path.parse(filepath));
// 输出如下:
/*
{
root: '/',
dir: '/node/base/path',
base: 'index.js',
ext: '.js',
name: 'index'
}
*/
五:path.format(pathObject)
该方法会从一个对象返回一个路径字符串,与pase.parse()相反。
当pathObject提供的属性有组合时,有些属性的优先级比其他的高;
1. 如果提供了pathObject.dir,则pathObject.root 会被忽略。
2. 如果提供了 pathObject.base存在,则pathObject.ext 和 pathObject.name 会被忽略;
如下代码:
const path = require('path'); // 如果提供了pathObject.dir,则pathObject.root 会被忽略。
const str = {
root: '/ignored',
dir: '/node/base/path',
base: 'index.js',
ext: '.js',
name: 'index'
}; console.log(path.format(str)); // 输出 /node/base/path/index.js // 如果没有提供了pathObject.dir,则pathObject.root 会使用。
const str2 = {
root: '/',
base: 'index.js',
ext: '.js',
name: 'index'
}; console.log(path.format(str2)); // 输出 /index.js // 如果没有指定 'base', 则 'name' + 'ext' 会被使用 const str3 = {
root: '/',
ext: '.js',
name: 'index'
}; console.log(path.format(str3)); // 输出 /index.js
六:path.isAbsolute(path);
该方法会判定path是否为一个绝对路径。如果给定的path是一个长度为零的字符串,则返回false. 如下代码:
const path = require('path'); console.log(path.isAbsolute('/xxx/yy')); // true
console.log(path.isAbsolute('/xxx/')); // true
console.log(path.isAbsolute('xxxx/')); // false
console.log(path.isAbsolute('.')); // false
七:path.join([...paths])
该方法使用特定的分隔符把全部给定的path片段链接到一起,并规范生成的路径。
如下代码:
const path = require('path'); console.log(path.join('/node', 'www', 'local', 'html', ''));
// 输出 /node/www/local/html console.log(path.join('node', 11122, 'www'));
// 会报错,TypeError: Path must be a string. Received 11122
八:path.relative(from, to)
该方法返回从 from 到 to的相对路径(基于当前工作目录)。
如下代码:
const path = require('path'); console.log(path.relative('/data/xx/text/aa', '/data/xx/yyyy/bbb')); // 输出 ../../yyyy/bbb
九:path.resolve([from...], to);
将to分解成一个绝对路径。
如果to不是一个绝对路径的话,那么from会被优先考虑,直到找到一个绝对路径,如果在form内还没有找到绝对路径,就会使用当前的工作目录。
当然如果 to 是一个绝对路径的话,那么直接返回该绝对路径。
如下代码:
const path = require('path'); // to 不是一个绝对路径,form优先被考虑,直到找到一个绝对路径
console.log(path.resolve('/foo/bar', './baz')); // 返回 /foo/bar/baz // to 是一个绝对路径,那么久直接返回 to
console.log(path.resolve('/foo/bar', '/baz')); // 返回 /baz // 如果 from 和 to 都不是一个绝对路径的话,就会使用当前的工作目录 + form + to
console.log(path.resolve('foo', 'bar')); // 返回 /Users/tugenhua/个人demo/node0420/nodeUrl/foo/bar