关于node.js:细说nodejs的path模块

前言

path 模块是 nodejs 中用于解决文件/目录门路的一个内置模块，能够看作是一个工具箱，提供诸多办法供咱们应用，当然都是和门路解决无关的。同时在前端开发中 path 模块呈现的频率也是比拟高的，比方配置 webpack 的时候等。本文是对该模块中一些罕用的办法进行介绍，走，一起学习下吧。

• 须要留神下，nodejs 中所有的模块（内置，自定义）都须要应用 requier 进行导入，个别导入地位在文件顶部。

const path = require('path');

API

basename （获取门路根底名）

• path.basename(path[,ext])

  • path：文件/目录门路
  • ext：（可选）文件扩展名 例如 .js .css 等
  • 返回值：path 门路的最初一部分

• 留神：

  • 如果 path 不是字符串或者给定的 ext 参数不是字符串，则抛出 TypeError
  • 如果有 ext 参数，当 ext 后缀名与文件名匹配上时返回的文件名会省略文件后缀
  • 如果 path 尾部有目录分隔符则会被疏忽

const path = require("path");path.basename('./ext/test.js') //test.jspath.basename('./ext/test.js','.js') //test (当后缀名与文件名匹配上时返回的文件名会省略文件后缀)path.basename('./ext/test.js','.html') //test.js (没有匹配上时返回文件全名)path.basename('./ext/foo/') // foo (尾部目录分隔符被疏忽)

dirname （获取门路目录名）

• path.dirname(path)

  • path：文件/目录门路
  • 返回值：path 门路的目录名

• 留神：

  • 如果 path 不是字符串，则抛出 TypeError
  • 如果 path 尾部有目录分隔符则会被疏忽

const path = require("path");path.dirname('./foo/bar/baz'); //./foo/bar (相对路径/绝对路径均可)path.dirname('/foo/bar/baz/'); // /foo/bar (尾部目录分隔符被疏忽)path.dirname('/foo/bar/baz/test.js'); // /foo/bar/baz

extname （获取门路扩展名）

• path.extname(path)

  • path：文件/目录门路
  • 返回值：path 门路的扩展名，从最初一次呈现 '.' 字符到 path 最初一部分的字符串完结,无扩展名则返回空

• 留神：

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

const path = require("path");path.extname('foo/bar/baz/test.js'); // .jspath.extname('foo/bar/baz');// '' (无扩展名返回 '')path.extname('foo/bar/baz/.'); // ''path.extname('foo/bar/baz/test.'); // '.'path.extname('foo/bar/baz/.test'); // ''path.extname('foo/bar/baz/.test.js'); // '.js'

parse （解析门路）

• path.parse(path) ( str => obj )

  • path：文件/目录门路

  • 返回值：带有属性(dir,root,base,name,ext)的对象

    • root：根目录
    • dir： 文件所在的文件夹
    • base：残缺文件 ( index.js )
    • name：文件名
    • ext: 文件后缀名

• 留神：

  • 如果 path 不是字符串，则抛出 TypeError
  • 如果尾部有目录分隔符则会被疏忽
• 一图胜千言

┌──────────────────┬────────────┐│          dir     │    base    │├──────┬           ├──────┬─────┤│ root │           │ name │ ext │"  /    foo/bar/baz/ index  .js "

const path = require("path");path.parse('/foo/bar/baz/index.js')// {//     root: '/',//     dir: '/foo/bar/baz',//     base: 'index.js',//     ext: '.js',//     name: 'index'//   }path.parse('/foo/bar/baz') //尾部目录分隔符省略// {//     root: '/',//     dir: '/foo/bar',//     base: 'baz',//     ext: '',//     name: 'baz'//   }path.parse('./foo/bar/baz/index.js') //当门路为相对路径 ./ 或../时 解析后果中root(代表根目录,绝对路径才有值)为 ''// {//     root: '',//     dir: './foo/bar/baz',//     base: 'index.js',//     ext: '.js',//     name: 'index'//   }

format （序列化门路）

• path.format(pathObj) 序列化 path 门路,与 path.parse() 刚好相同

  • pathObj：path对象
  • 返回值：序列化后的字符串门路 ( obj => string )

• 留神：

  • 如果 pathObject 不是对象，则抛出 TypeError

  • pathObject 中的属性须要留神优先级：

    • 当 dir 属性存在则疏忽 root 属性
    • 当 base 属性存在则会疏忽 name 和 ext 属性

isAbsolute （是否是绝对路径）

• path.isAbsolute(path)

  • path：文件/目录门路
  • 返回值：true/false

• 留神：

  • 如果 path 不是字符串，则抛出 TypeError
  • 如果给定的 path 字符串长度为0，则返回 false

  参考nodejs进阶视频解说：进入学习

const path = require("path");path.isAbsolute('//foo'); // truepath.isAbsolute('\\\\foo'); // truepath.isAbsolute('C:/foo/..'); // truepath.isAbsolute('C:\\foo\\..'); // truepath.isAbsolute('./bar\\baz');  // falsepath.isAbsolute('../bar/baz'); // falsepath.isAbsolute('.'); // falsepath.isAbsolute('');  // false

join（拼接门路片段）

• path.join([...paths])

  • paths：门路片段
  • 返回值：应用平台特定的分隔符作为定界符将所有给定的 path 片段连贯在一起规范化后生成的门路

• 留神：

  • 如果 paths 不是字符串片段，则抛出 TypeError
  • 零长度的 path 片段会被疏忽
  • 如果连贯后的门路字符长度为0，则返回 '.'，示意当前工作目录
  • 目录分隔符有平台差别,windows 返回为 ' \ '

const path = require("path");path.join('') // '.'path.join('./') // '.\'path.join('../') // '..\'path.join('/foo/','bar','baz','../','index.js') // '\foo\bar\index.js'path.join('./bar','baz' ,'/','../','',index.js') // 'bar\index.js'path.join('foo', {}, 'bar'); // 'TypeError: Path must be a string. Received {}'

normalize（规范化门路）

• path.normalize(path)

  • path: 文件/目录门路
  • 返回值：标准后的门路字符串

• 留神：

  • 如果 path 不是字符串片段，则抛出 TypeError
  • 尾部的分隔符会保留
  • 如果 path字符串长度为0，则返回 '.'，示意当前工作目录
  • 门路中的目录分隔符均会被替换成平台特定的目录分隔符,windows 零碎 会将 '/' 或'' 均替换成 ''
  • 门路中间断的多个分隔符会被规范化为一个
  • 门路中最好不要呈现单个 ' \ ',因为当和字母在一起的时候会被当做本义符

const path = require("path");path.normalize('') // '.'path.normalize('temp//foo//bar//..//'); // temp\foo\path.normalize('C:////temp\\\\/\\/\\/foo/bar') // C:\temp\foo\barpath.normalize('..////foo//\bar/baz/') // ..\fooar\baz\ (转义字符呈现)path.normalize('temp//foo/\bar') // temp\fooar (转义字符呈现)

relative（获取 from 到 to 的相对路径）

• path.relative(from,to)

  • from，to: 文件/目录门路
  • 返回值：from 到 to 的相对路径（to 绝对于 form 的相对路径）

• 留神：

  • 如果 from 和 to 指向雷同门路雷同 则返回 ''
  • 如果 from 或 to 任何一方为空,则应用当前工作目录代替其空门路

const path = require("path");//当前工作目录为 \Stone\node\node\path_modulepath.relative('/foo/bar/baz','/foo/bar/dir/file.js') // ..\dir\file.jspath.relative('/foo/bar/baz','/foo/bar/baz') // ''path.relative('/foo/bar/baz/files.js','') // ..\..\..\..\Stone\node\node\path_modulepath.relative('','/foo/bar/baz/files.js') // ..\..\..\..\foo\bar\baz\files.jspath.relative('','./foo/bar/baz/files.js') // foo\bar\baz\files.js

这里针对 from 或 to 任何一方为空,则应用当前工作目录代替其空门路。稍作阐明下，
例如当前工作目录为 \Stone\node\node\path_module,则能够看到 path.relative('/foo/bar/baz/files.js','') 的输入后果为..\..\..\..\Stone\node\node\path_module，此时 to 为 \Stone\node\node\path_module，
要输入 to 绝对于 from 的相对路径，则 from 须要先 ../ 的模式 一层一层退出，来检索与 to 的公共父级目录，直到遇到公共父级目录或者到根目录进行，而后cd 进 to 目录。这是针对另一方为绝对路径，如果另一方为相对路径，则间接就是以后另一方门路。

resolve（将门路或门路片段的序列解析为绝对路径）

• path.resolve([...paths])

  • paths: 门路或门路片段的序列
  • 返回值：门路或门路片段序列解析为绝对路径。（将门路片段解析后生成的绝对路径）

• 留神：

  • 门路片段如果给出则必须是字符串类型，否则类型谬误
  • 给定的门路序列从右到左进行解决，每个后续的 path 前置，直到结构出一个绝对路径
  • 如果解决完所有给定的 path 片段之后还未生成绝对路径，则再加上当前工作目录
  • 生成的门路均已规范化，并且除非将门路解析为根目录，否则将删除尾部斜杠
  • 零长度的 path 片段会被疏忽
  • 若没有传入 path 片段，则 path.resolve() 将返回当前工作目录的绝对路径

const path = require("path");//当前工作目录为 \Stone\node\node\path_modulepath.resolve('/foo/bar', './baz'); // '/foo/bar/baz'path.resolve('/foo/bar','', '/tmp/file/'); //'/tmp/file'path.resolve('root', 'foo/baz/', '../fun/bar') // '\Stone\node\node\path_module\root\foo\fun\bar'path.resolve() // '\Stone\node\node\path_module'

path.resolve 办法解析门路片段的时候会从右往左的程序顺次解析，直到结构出一个绝对路径，否则会将当前工作目录加在门路结尾。所以，通过 resolve 解析生成的门路肯定是绝对路径。这个办法应用的十分多，应该特眼生，对，前端咱们配置 webpack 的时候会高频率用到，并且往往还会联合 __dirname 应用。

__dirname，__filename

• __dirname：能够看作是 nodejs 中的全局变量，它始终示意以后执行文件所在目录的残缺目录名（绝对路径）
• __filename：能够看作是 nodejs 中的全局变量，它始终示意以后执行文件的残缺文件名(残缺相对路)

咱们先在 path_module 目录下运行 node test.js 命令

<!--以后执行文件的残缺门路为\Stone\node\node\path_module\test.js-->const path = require("path");console.log(__dirname); // \Stone\node\node\path_moduleconsole.log(__filename); // \Stone\node\node\path_module\test.js

而后咱们在 \Stone\node\node 目录下运行 node path_module\test.js，会发现输入后果同上，
所以这就是说明 __dirname 和 __filename 始终跟以后执行文件无关，跟启动脚本所在目录无关。

./ ../

./ 和 ../ 咱们都晓得是相对路径的写法，然而应用的过程中配合 require() 应用与否的后果是不同的。

• fs_module 目录下 执行 node test.js

<!--以后启动脚本的执行命令所在目录 \Stone\node\node\fs_module\test.js-->const fs = require('fs')fs.readFileSync('./ext/test1.js',(err,data)=> {    console.log('ok')})

会失常打印出 ok

• \Stone\node\node 目录下 执行 node fs_module\test.js

<!--以后启动脚本的执行命令所在目录 \Stone\node\node-->const fs = require('fs')fs.readFile('./ext/test1.js',(err,data)=> {    console.log('ok')})

运行会报错 no such file or directory, open './ext/test1.js'

这到底是为啥嘞，起因就是 './' 和 '../' 的门路示意意义须要分状况，当联合 require() 应用的时候绝对于以后执行文件，如果不联合 require() 应用的状况下会绝对于以后启动脚本的目录，因而只有在 require() 时才应用相对路径(./, ../) 的写法，其余中央一律应用绝对路径，这点肯定要留神。

结语

对于nodejs path 模块，咱们明天就说到这里了，尽管 api 不是很多，然而 path 模块在前端的应用频率还是十分高的，所以感觉很值得学习理解一下的。因为认知无限，本文若有不精确之处还望路过的各位兄台及时斧正，吃瓜，吃瓜。