path.parse(path)

• path <string>
• 返回: <Object>

path.parse() 方法返回一个对象，其属性表示 path 的重要组成部分。尾随的目录分隔符会被忽略，详见 path.sep。

【The path.parse() method returns an object whose properties represent significant elements of the path. Trailing directory separators are ignored, see path.sep.】

返回的对象将具有以下属性：

【The returned object will have the following properties:】

• dir <string>
• root <string>
• base <string>
• name <string>
• ext <string>

例如，在 POSIX 上：

【For example, on POSIX:】

path.parse('/home/user/dir/file.txt');
// Returns:
// { root: '/',
//   dir: '/home/user/dir',
//   base: 'file.txt',
//   ext: '.txt',
//   name: 'file' } 拷贝

┌─────────────────────┬────────────┐
│          dir        │    base    │
├──────┬              ├──────┬─────┤
│ root │              │ name │ ext │
"  /    home/user/dir / file  .txt "
└──────┴──────────────┴──────┴─────┘
(All spaces in the "" line should be ignored. They are purely for formatting.) 拷贝

在 Windows 上：

【On Windows:】

path.parse('C:\\path\\dir\\file.txt');
// Returns:
// { root: 'C:\\',
//   dir: 'C:\\path\\dir',
//   base: 'file.txt',
//   ext: '.txt',
//   name: 'file' } 拷贝

┌─────────────────────┬────────────┐
│          dir        │    base    │
├──────┬              ├──────┬─────┤
│ root │              │ name │ ext │
" C:\      path\dir   \ file  .txt "
└──────┴──────────────┴──────┴─────┘
(All spaces in the "" line should be ignored. They are purely for formatting.) 拷贝

如果 path 不是字符串，则会抛出 TypeError。

【A TypeError is thrown if path is not a string.】