文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

Node.js中Process、Path和File System模块常用 API

2023-06-14 11:46

关注

这篇文章给大家分享的是有关Node.js中Process、Path和File System模块常用 API的内容。小编觉得挺实用的,因此分享给大家做个参考,一起跟随小编过来看看吧。

本篇文章给大家介绍一下Nodejs中Process、Path和File System模块常用 API。有一定的参考价值,有需要的朋友可以参考一下,希望对大家有所帮助。

Node.js中Process、Path和File System模块常用 API

相关推荐:《nodejs 教程》

在日常使用 Node 进行开发的时候,会使用到一些文件系统、路径操作等基础 API,这里整理一下,方便大家理解和直接使用。

这里只介绍最常用的那些,不是所有哈,想要看更全的,直接看官方文档就 OK。

尽量不废话,多上代码。

Process 模块


先介绍 process 模块,它提供了当前 Node 进程相关的全局环境信息。在后面的 API 中被用到。

// 内置模块,直接使用const process = require('process');

process.cwd()

这是一个函数,返回当前 Node 进程执行的目录,举例一个常见的场景:

一个 Node 模块 A 通过 NPM 发布,项目 B 中使用了模块 A。在 A 中需要操作 B 项目下的文件时,就可以用 process.cwd() 来获取 B 项目的路径。

const cwd = process.cwd(); // 输出:/Users/xiaolian/Code/node-api-test

process.argv

在终端通过 Node 执行命令的时候,通过 process.argv 可以获取传入的命令行参数,返回值是一个数组:

所以,我们只要从 process.argv[2] 开始获取就好了。一般都是这样用

const args = process.argv.slice(2);

直接获取我们想要的参数。

process.env

返回一个对象,存储当前环境相关的所有信息,一般很少直接用到。

一般我们会在 process.env 上挂载一些变量标识当前的环境。比如最常见的用 process.env.NODE_ENV 区分 developmentproduction。在 vue-cli 的源码中也经常会看到 process.env.VUE_CLI_DEBUG 标识当前是不是一 DEBUG 模式。

这里提一个 webpack 的插件 DefinePlugin,在日常的构建流程中,我们经常会通过这个插件来注入不同的全局变量,从而执行不同的构建流程,并且代码中的 process.env.xxx 会被替换成具体的值,在 Terser 压缩阶段会将 deadCode 移除,优化代码体积。

process.platform

这个用的不多,返回当前系统信息,枚举值如下:

console.log(process.platform);// 'aix'// 'darwin'  - macOS// 'freebsd'// 'linux' - linux// 'openbsd'// 'sunos'// 'win32' - windows

Path 模块


// 内置模块,直接使用const path = require('path');

Node 中几乎路径相关的操作都会使用这个模块。

这里就说 5 个最常用的:

path.join(...paths)

path.join 作用是将传入的多个路径拼成一个完整的路径。

const dPath = path.join('template', 'aaa', 'bbb', 'ccc', 'd.js');// 输出: template/aaa/bbb/ccc/d.js

来看一个非常常见的场景,我们需要获取当前项目的 package.json 文件,就可以这样获取它的路径:

const pkgPath = path.join(process.cwd(), './package.json');// 输出: /Users/xiaolian/Code/node-api-test/package.json

path.join 可以传入任意个路径,比如:

['package.json', 'README.md'].forEach(fileName => {  const templateFilePath = path.join(process.cwd(), 'template', fileName);  console.log(templateFilePath);});// 输出: /Users/xiaolian/Code/node-api-test/template/package.json// 输出: /Users/xiaolian/Code/node-api-test/template/README.md

path.resolve(...paths)

path.resovlepath.join 的区别在于它的作用是将传入的多个路径和当前执行路径拼接成一个完整的绝对路径。

假设我现在 index.jsscripts 目录下,然后我在根目录下执行 node scripts/index.js,它的代码如下:

const dPath = path.resolve('aaa', 'bbb', 'ccc', 'd.js');// 输出:  /Users/xiaolian/Code/node-api-test/aaa/bbb/ccc/d.js

一般情况下,当 path.resolve 的第一个参数为 ./ 时,可以直接理解和 path.join(processs.cwd(), '') 表现一致。

path.basename(path[, ext])

path.basename 返回指定 path 最后一个路径名,其中第二个参数 ext 可选,表示文件扩展名。比如:

console.log(path.basename('scripts/index.js'));  // index.jsconsole.log(path.basename('scripts/index.js', '.js'));  // 匹配到 .js,返回 indexconsole.log(path.basename('scripts/index.js', '.json'));  // 没匹配到,返回 index.js

path.dirname(path)

path.basename 对应,返回指定 path 最后一个路径名之前的路径。比如:

console.log(path.basename('scripts/index.js'));  // scriptsconsole.log(path.basename('scripts/hook/index.js'));  // scripts/hook

path.extname(path)

path.basename 对应,返回指定 path 最后一个路径名的文件扩展名(含小数点 .)。比如:

console.log(path.basename('scripts/index.js'));  // .jsconsole.log(path.basename('README.md'));  // .md

对比

最后再来对比一下各个路径相关的 API 的区别。

项目 A 的目录结构如下:

├── scripts│   └── index.js├── src│   └── index.js├── package.json├── README.md

scripts/index.js 的代码如下:

const path = require('path');console.log(path.join('package.json'));console.log(path.resolve('package.json'));console.log(path.join('src', 'index.js'));console.log(path.resolve('src', 'index.js'));console.log(path.join(process.cwd(), 'package.json'));console.log(path.resolve('./', 'package.json'));console.log(__filename);console.log(__dirname);

然后,我们在项目 A 的跟目录下执行 node scripts/index.js,结果如下:

-> node scripts/index.jspackage.json/Users/xiaolian/Code/A/package.jsonsrc/index.js/Users/xiaolian/Code/A/src/index.js/Users/xiaolian/Code/A/package.json/Users/xiaolian/Code/A/package.json/Users/xiaolian/Code/A/scripts/index.js/Users/xiaolian/Code/A/scripts

品,仔细品,它们有什么区别。

个人而言,一般还是习惯用 path.join(process.cwd(), 'xxx')

File System 模块


// 内置模块,直接使用const fs = require('fs');

文件系统相关操作的模块,除了 fs 之外,我们还经常用到 fs-extra,后面会介绍。

这个模块在平时的 Node 开发中会被大量使用,这里简单列几个,其它的还是看文档哈:nodejs.org/dist/latest…

fs 模块的 API 默认都是异步回调的形式,如果你想使用同步的方法,有两种解决方法:

  1. 使用 Node 提供的同步 API:xxxSync,也就是在 API 的后面加一个 Sync 后缀,它就是一个同步方法了(具体还是需要查文档哈,是否有提供同步 API)

  2. 包装成一个 Promise 使用

fs.stat(path[, options], callback)

fs.stat() 返回一个文件或者目录的信息。

const fs = require('fs');fs.stat('a.js', function(err, stats) {  console.log(stats);});

其中包含的参数有很多,介绍几个比较常用的:

export interface StatsBase<T> {  isFile(): boolean;                 // 判断是否是一个文件  isDirectory(): boolean;            // 判断是否一个目录  size: T;                           // 大小(字节数)  atime: Date;                       // 访问时间  mtime: Date;                       // 上次文件内容修改时间  ctime: Date;                       // 上次文件状态改变时间  birthtime: Date;                   // 创建时间}

一般我们会使用 fs.stat 来取文件的大小,做一些判断逻辑,比如发布的时候可以检测文件大小是否符合规范。在 CLI 中,经常需要获取一个路径下的所有文件,这时候也需要使用 fs.stat 来判断是目录还是文件,如果是目录则继续递归。当然,现在也有更方便的 API 可以完成这个工作。

同步方法
const fs = require('fs');try {  const stats = fs.statSync('a.js');} catch(e) {}

fs.readdir(path[, options], callback)

fs.readdir(path) 获取 path 目录下的文件和目录,返回值为一个包含 filedirectory 的数组。

假设当前目录为:

.├── a│   ├── a.js│   └── b│       └── b.js├── index.js└── package.json

执行以下代码:

const fs = require('fs');fs.readdir(process.cwd(), function (error, files) {  if (!error) {    console.log(files);  }});

返回值为:

[ 'a',  'index.js',  'package.json' ]

可以看到这里只返回了根目录下的文件和目录,并没有去深度遍历。所以如果需要获取所有文件名,就需要自己实现递归。

同步方法
const fs = require('fs');try {  const dirs = fs.readdirSync(process.cwd());} catch(e) {}

fs.readFile(path[, options], callback)

文件读取的 API,通过 fs.readFile 可以获取指定 path 的文件内容。

入参如下:

使用方法如下:

const fs = require('fs');const path = require('path');fs.readFile(path.join(process.cwd(), 'package.json'), 'utf-8', function (  error,  content) {  if (!error) {    console.log(content);  }});

如果没传 encoding,则其默认值为 null,此时返回的文件内容为 Buffer 格式。

同步方法
const fs = require('fs');try {  fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf-8');} catch(e) {}

fs.writeFile(file, data[, options], callback)

对应着读文件 readFilefs 也提供了写文件的 API writeFile,接收四个参数:

使用方法如下:

const fs = require('fs');const path = require('path');fs.writeFile(  path.join(process.cwd(), 'result.js'),  'console.log("Hello World")',  function (error, content) {    console.log(error);  });
同步方法
const fs = require('fs');const path = require('path');try {  fs.writeFileSync(    path.join(process.cwd(), 'result.js'),    'console.log("Hello World")',    'utf-8'  );} catch (e) {}

感谢各位的阅读!关于“Node.js中Process、Path和File System模块常用 API”这篇文章就分享到这里了,希望以上内容可以对大家有一定的帮助,让大家可以学到更多知识,如果觉得文章不错,可以把它分享出去让更多的人看到吧!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯