Node.js 常用的内置模块
一. 内置模块path
1.1. 认识path模块
path模块用于对路径和文件进行处理，提供了很多好用的方法。
并且我们知道在Mac OS、Linux和window上的路径是不一样的
-
window上会使用
\或者\\来作为文件路径的分隔符，当然目前也支持/； -
在Mac OS、Linux的Unix操作系统上使用
/来作为文件路径的分隔符；
那么如果我们在window上使用 \ 来作为分隔符开发了一个应用程序，要部署到Linux上面应该怎么办呢？
-
显示路径会出现一些问题；
-
所以为了屏蔽他们之间的差异，在开发中对于路径的操作我们可以使用
path模块；
1.2. path常见的API
从路径中获取信息
-
dirname：获取文件的父文件夹；
-
basename：获取文件名；
-
extname：获取文件扩展名；
const path = require("path");
const myPath = '/Users/coderwhy/Desktop/Node/课堂/PPT/01_邂逅Node.pdf';
const dirname = path.dirname(myPath);
const basename = path.basename(myPath);
const extname = path.extname(myPath);
console.log(dirname); // /Users/coderwhy/Desktop/Node/课堂/PPT
console.log(basename); // 01_邂逅Node.pdf
console.log(extname); // .pdf
路径的拼接
-
如果我们希望将多个路径进行拼接，但是不同的操作系统可能使用的是不同的分隔符；
-
这个时候我们可以使用
path.join函数；
console.log(path.join('/user', 'why', 'abc.txt'));
将文件和某个文件夹拼接
-
如果我们希望将某个文件和文件夹拼接，可以使用
path.resolve;-
resolve函数会判断我们拼接的路径前面是否有/或../或./； -
如果有表示是一个绝对路径，会返回对应的拼接路径；
-
如果没有，那么会和当前执行文件所在的文件夹进行路径的拼接
-
path.resolve('abc.txt'); // /Users/coderwhy/Desktop/Node/TestCode/04_learn_node/06_常见的内置模块/02_文件路径/abc.txt
path.resolve('/abc.txt'); // /abc.txt
path.resolve('/User/why', 'abc.txt'); // /User/why/abc.txt
path.resolve('User/why', 'abc.txt'); // /Users/coderwhy/Desktop/Node/TestCode/04_learn_node/06_常见的内置模块/02_文件路径/User/why/abc.txt
resolve其实我们在webpack中也会使用：
const CracoLessPlugin = require('craco-less');
const path = require("path");
const resolve = dir => path.resolve(__dirname, dir);
module.exports = {
plugins: [
{
plugin: CracoLessPlugin,
options: {
lessLoaderOptions: {
lessOptions: {
modifyVars: { '@primary-color': '#1DA57A' },
javascriptEnabled: true,
},
},
},
}
],
webpack: {
alias: {
"@": resolve("src"),
"components": resolve("src/components")
}
}
}
二. 内置模块fs
1.1. 认识fs模块
fs是File System的缩写，表示文件系统。
对于任何一个为服务器端服务的语言或者框架通常都会有自己的文件系统：
-
因为服务器需要将各种数据、文件等放置到不同的地方；
-
比如用户数据可能大多数是放到数据库中的（后面我们也会学习）；
-
比如某些配置文件或者用户资源（图片、音视频）都是以文件的形式存在于操作系统上的；
Node也有自己的文件系统操作模块，就是fs：
-
借助于Node帮我们封装的文件系统，我们可以在任何的操作系统（window、Mac OS、Linux）上面直接去操作文件；
-
这也是Node可以开发服务器的一大原因，也是它可以成为前端自动化脚本等热门工具的原因；
Node文件系统的API非常的多：https://nodejs.org/dist/latest-v14.x/docs/api/fs.html
-
我们不可能，也没必要一个个去学习；
-
这个更多的应该是作为一个API查询的手册，等用到的时候查询即可；
-
学习阶段我们只需要学习最常用的即可；
但是这些API大多数都提供三种操作方式：
-
方式一：同步操作文件：代码会被阻塞，不会继续执行；
-
方式二：异步回调函数操作文件：代码不会被阻塞，需要传入回调函数，当获取到结果时，回调函数被执行；
-
方式三：异步Promise操作文件：代码不会被阻塞，通过
fs.promises调用方法操作，会返回一个Promise，可以通过then、catch进行处理；
我们这里以获取一个文件的状态为例：
-
注意：都需要引入
fs模块；
方式一：同步操作文件
// 1.方式一: 同步读取文件
const state = fs.readFileSync('../aaa.txt');
console.log(state);
console.log('后续代码执行');
//Hello World!
//后续代码执行方式二：异步回调函数操作文件
fs.readFile(
'./aaa.txt',
{
encoding: 'utf8',
},
(err, state) => {
if (err) {
console.log(err);
return;
}
console.log(state);
}
);
console.log('后续代码执行');
//后续代码执行
//Hello World!方式三：异步Promise操作文件
fs.promises
.readFile('./aaa.txt', {
encoding: 'utf-8',
})
.then((res) => {
console.log('获取到结果:', res);
})
.catch((err) => {
console.log('发生了错误:', err);
});
1.2. 文件描述符
文件描述符（File descriptors）是什么呢？
在常见的操作系统上，对于每个进程，内核都维护着一张当前打开着的文件和资源的表格。
-
每个打开的文件都分配了一个称为文件描述符的简单的数字标识符。
-
在系统层，所有文件系统操作都使用这些文件描述符来标识和跟踪每个特定的文件。
-
Windows 系统使用了一个虽然不同但概念上类似的机制来跟踪资源。
-
为了简化用户的工作，Node.js 抽象出操作系统之间的特定差异，并为所有打开的文件分配一个数字型的文件描述符。
fs.open() 方法用于分配新的文件描述符。一旦被分配，则文件描述符可用于从文件读取数据、向文件写入数据、或请求关于文件的信息。
const fs = require('fs');
// 打开一个文件
fs.open('./bbb.txt', (err, fd) => {
if (err) {
console.log('打开文件错误:', err);
return;
}
// 1.获取文件描述符
console.log(fd);
// 2.读取到文件的信息
fs.fstat(fd, (err, stats) => {
if (err) return;
console.log(stats);
});
// 3.手动关闭文件
fs.close(fd, (err) => {
if (err) {
console.log(err);
}
});
});
1.3. 文件的读写
如果我们希望对文件的内容进行操作，这个时候可以使用文件的读写：
-
fs.readFile(path, [options], callback)：读取文件的内容； -
fs.writeFile(file, data,[options], callback)：在文件中写入内容；
文件写入：
fs.writeFile('../foo.txt', content, {}, err => {
console.log(err);
})
在上面的代码中，你会发现有一个大括号没有填写任何的内容，这个是写入时填写的option参数：
-
flag：写入的方式。
-
encoding：字符的编码；
我们先来看flag：
-
flag的值有很多：https://nodejs.org/dist/latest-v14.x/docs/api/fs.html#fs_file_system_flags
-
w打开文件写入，默认值； -
w+打开文件进行读写，如果不存在则创建文件； -
r+打开文件进行读写，如果不存在那么抛出异常； -
r打开文件读取，读取时的默认值； -
a打开要写入的文件，将流放在文件末尾。如果不存在则创建文件； -
a+打开文件以进行读写，将流放在文件末尾。如果不存在则创建文件
-
我们再来看看编码：
-
我之前在简书上写过一篇关于字符编码的文章：https://www.jianshu.com/p/899e749be47c
-
目前基本用的都是UTF-8编码；
文件读取：
-
如果不填写encoding，返回的结果是Buffer；
fs.readFile('./foo.txt', {encoding: 'utf-8'}, (err, data) => {
console.log(data);
})
1.4. 文件夹操作
1.4.1 新建一个文件夹
使用fs.mkdir()或fs.mkdirSync()创建一个新文件夹：
const fs = require('fs');
const dirname = '../why';
if (!fs.existsSync(dirname)) {
fs.mkdir(dirname, (err) => {
console.log(err);
})
}
1.4.1 读取一个文件夹
文件夹的结构如果所示
1.读取文件夹的内容,获取到文件夹中文件的字符串 结果： [ 'aaa', 'bbb', 'nba.txt' ]
fs.readdir('./why', (err, files) => {
console.log(files)
})
2.读取文件夹, 获取到文件夹中文件的信息
// 2.读取文件夹, 获取到文件夹中文件的信息
fs.readdir('./why', { withFileTypes: true }, (err, files) => {
console.log(files);
})结果：2-文件夹 1-文件
[
Dirent { name: 'aaa', [Symbol(type)]: 2 },
Dirent { name: 'bbb', [Symbol(type)]: 2 },
Dirent { name: 'nba.txt', [Symbol(type)]: 1 }
]
3.递归获取文件夹的内容
// 读取文件夹
function readFolders(folder) {
fs.readdir(folder, {withFileTypes: true} ,(err, files) => {
files.forEach(file => {
if (file.isDirectory()) {
const newFolder = path.resolve(dirname, file.name);
readFolders(newFolder);
} else {
console.log(file.name);
}
})
})
}
readFolders(dirname);
1.4.3 文件/文件夹 重命名
const fs = require('fs');
// 1.对文件夹进行重命名
fs.rename('./why', './kobe', (err) => {
console.log('重命名结果:', err);
});
// 2.对文件重命名
fs.rename('./ccc.txt', './ddd.txt', (err) => {
console.log('重命名结果:', err);
});
三. 内置模块events
3.1. 基本使用
Node中的核心API都是基于异步事件驱动的：
-
在这个体系中，某些对象（发射器（Emitters））发出某一个事件；
-
我们可以监听这个事件（监听器 Listeners），并且传入的回调函数，这个回调函数会在监听到事件时调用；
发出事件和监听事件都是通过EventEmitter类来完成的，它们都属于events对象。
-
emitter.on(eventName, listener)：监听事件，也可以使用addListener； -
emitter.off(eventName, listener)：移除事件监听，也可以使用removeListener； -
emitter.emit(eventName[, ...args])：发出事件，可以携带一些参数；
// events模块中的事件总线
const EventEmitter = require('events')
// 创建EventEmitter的实例
const emitter = new EventEmitter()
// 监听事件
//接收参数
function handleWhyFn(name, age, height) {
console.log('监听why的事件', name, age, height);
}
emitter.on('why', handleWhyFn)
// 发射事件
setTimeout(() => {
// 传递参数
emitter.emit('why', "coderwhy", 18, 1.88)
// 取消事件监听
emitter.off('why', handleWhyFn)
setTimeout(() => {
emitter.emit('why')
}, 1000)
}, 2000);
3.2. 常见的方法
EventEmitter的实例有一些属性，可以记录一些信息：
-
emitter.eventNames()：返回当前EventEmitter对象注册的事件字符串数组； -
emitter.getMaxListeners()：返回当前EventEmitter对象的最大监听器数量，可以通过setMaxListeners()来修改，默认是10； -
emitter.listenerCount(事件名称)：返回当前EventEmitter对象某一个事件名称，监听器的个数； -
emitter.listeners(事件名称)：返回当前EventEmitter对象某个事件监听器上所有的监听器数组；
const EventEmitter = require('events');
const bus = new EventEmitter();
bus.on('click', () => {});
bus.on('click', () => {});
bus.on('click', () => {});
bus.on('input', () => {});
// 1.获取所有监听事件的名称 [ 'click', 'input' ]
console.log(bus.eventNames());
// 2.获取监听最大的监听个数 10
console.log(bus.getMaxListeners());
// 3.获取某一个事件名称对应的监听器个数 3
console.log(bus.listenerCount('click'));
// 4.获取某一个事件名称对应的监听器函数(数组)
// [ [Function], [Function], [Function] ]
console.log(bus.listeners('click'));
3.3. 方法的补充
emitter.once(eventName, listener)：事件监听一次
const EventEmitter = require('events');
const emitter = new EventEmitter();
emitter.once('click', (args) => {
console.log("监听到事件", args);
})
setTimeout(() => {
emitter.emit('click', 'coder');
emitter.emit('click', 'coder');
}, 2000);
emitter.prependListener()：将监听事件添加到最前面 b-a
emitter.on('click', (args) => {
console.log("a监听到事件", args);
})
// b监听事件会被放到前面
emitter.prependListener("click", (args) => {
console.log("b监听到事件", args);
})
emitter.prependOnceListener()：将监听事件添加到最前面，但是只监听一次
emitter.prependOnceListener("click", (args) => {
console.log("c监听到事件", args);
})
emitter.removeAllListeners([eventName])：移除所有的监听器
// 移除emitter上的所有事件监听
emitter.removeAllListeners();
// 移除emitter上的click事件监听
emitter.removeAllListeners("click");