nodejs笔记
2026-7-17
原始笔记链接：https://cloud.seatable.cn/dtable/external-links/59b453a8639945478de2/
0025 浏览器和node中的事件循环
浏览器主要的同步和异步操作是 setTimeout 和 setInterval
主线程执行完后会执行任务队列当中的 setTimeout 和 setInterval
node 当中是 event loop 主要分为宏任务和微任务，执行完一个宏任务，就会执行相应的微任务
具体宏任务微任务的区别：https://juejin.cn/post/7281192416077021236
执行顺序： 同步任务 —> 微任务 —> 宏任务
0094 vue 事件代理和元素绑定事件
类似React的原生事件和合成事件
0192 Express 中 app.use 和 app.all 区别
https://expressjs.com/en/4x/api.html
app.use
app.use([path,] callback [, callback…])
Mounts the specified middleware function or functions at the specified path: the middleware function is executed when the base of the requested path matches path.
在指定路径上挂载指定的中间件函数或函数:当请求路径的基与path匹配时，执行中间件函数。
请求路径中的第一部分只要与 /register 相等即可，并不要求请求路径pathname完全匹配
app.all
app.all(path, callback [, callback …])
This method is like the standard app.METHOD() methods, except it matches all HTTP verbs.
这个方法类似于标准的app.METHOD()方法，除了它匹配所有HTTP动词。
就是 GET post delete put 都会走这个路由，请求路径pathname必须和 /xxx 完全匹配
0193 Express 中间件
中间件定义
中间件的本质就是一个函数，在收到请求和返回响应的过程中，做一些我们想做的事情。
中间件作用
执行任何代码。
修改请求和响应对象。
终结请求-响应循环。
调用堆栈中的下一个中间件。
中间件基本原理
实际上中间件就是一个堆栈，包括很多处理的中间件函数。
当请求发送到服务器 request，服务器取出中间件，并创建一个运行环境，使用中间件处理请求（例如验证 token）。
然后把这个请求返回 next() 执行堆栈中下一个中间件——逐步迭代过程。
伪代码如下
1
2
3
4
5
6
7
8
9
10
|
// 这个中间件带路径，表示满足 '*' 才能访问
app.use('*', (request, response, next) => {
if （request.token）{
let result = checkJWT(request.token);
if (result) {
return next();
}
}
return res.status(401).send('Token is invalid');
})
|
因此，中间件的执行顺序很重要。
https://juejin.cn/post/6844903573663416334
0195 Express 常用中间件
-
body-parser 解析post数据
-
cookie-parser 处理cookie
-
cookie-session 处理session
-
bcrypt 加密
-
passport 鉴权
-
passport-jwt jwt鉴权
-
ejs 模板引擎
0198 bodyParser 作用是什么
用于处理 POST 请求的格式，JSON格式，或者默认的 application/x-www-form-urlencoded 解析器，限制最大的数据量
1
2
3
4
5
|
// create application/json parser
app.use(bodyParser.json({ limit: '100mb' }));
// create application/x-www-form-urlencoded parser
app.use(bodyParser.urlencoded({ limit: '100mb', extended: false }));
|
0200 connect-multiparty 有什么作用
connect-multiparty 这个中间件用于上传文件
前端用multipart/form-data的形式上传数据，后端通过中间件 connect-multipary 接收。
注意，接收结果req.files是一个对象，包含POST上传的参数和一个临时文件，文件一般在/tmp目录下，可以将文件移动到指定位置。
参考
1
2
3
4
5
|
import multipart from 'connect-multiparty';
const multipartMiddleware = multipart();
router.post(`/doc_uuid/`, multipartMiddleware, callback);
|
https://blog.csdn.net/dreamer2020/article/details/52076391
0201 一个 express + web socket 项目架构
项目架构
这个 express cli 可以创建默认的项目架构，默认项目架构可以满足大部分需求
实际架构
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
|
./src
├── _bin
│ └── www 启动脚本（初始化 express 服务器，创建 web-socket 服务，文件自动保存服务，监听事件并写入日志）
├── api
│ └── sea-server-api 请求后端的API，获取 token，获取上传下载链接，上传下载文件
├── app 全局 express 实例入口文件，处理POST请求格式，跨域，登录验证，路由，错误返回
├── dao 数据库操作
│ └── operation-log 将操作日志写入数据库，获取当前 doc 悬挂的 operations
├── db-helper 数据库工具函数（数据库配置，创建连接池，执行查询，断开连接）
├── loggers
│ └── index 日志打印工具函数（设置日志路径，日志级别）
├── middleware 中间件
│ ├── auth 登录验证 jwtToken
│ ├── cors 跨域
├── config 配置文件（数据库配置，服务器地址，端口号等）
├── constants 常量：服务器的基本 API 配置，最大缓存的操作数量
├── utils
│ ├── index 工具函数（文件目录操作，时间转换，解析 URL）
│ └── slate-utils 批量执行操作并更新最后修改人
├── route 服务端路由组件（文件内容和协作人的路由）
用户管理
├── controllers ——不同路由执行的操作（具体操作在 managers 中实现）核心逻辑
│ └── user-controller 客户端请求用户，返回当前 doc 中的协作人
├── managers
│ └── users-manager 用户管理组件
文件管理（核心）
├── controllers ——不同路由执行的操作（具体操作在 managers 中实现）核心逻辑
│ ├── document-controller GET 和 POST 分别对应文档获取和保存
├── managers
│ ├── document-manager（文档对象管理器，全部文档的保存，更新，获取，新建）
├── models
│ └── document 一个文档对象（包括自身属性和基本操作）
操作管理（核心）
├── managers
│ ├── operations-manager 操作管理（操作管理器对象存储1000条近期记录，其他的操作写入数据库，然后支持获取服务器和客户端的差距的操作-丢失获取）
web-socket 服务（核心）
└── wss
├── auth ws-jwt 登录认证
├── index web-socket 服务器主程序（用户进入房间，用户离开房间，更新文档，同步文档，断开连接，服务器错误处理等）
└── io-helper ws-工具函数（离开进入房间，广播错误信息等）
|
0203 nodejs 子进程 child_process
需求：写一个nodejs 脚本，然后批量操作文件或者查询文件信息（使用bash命令）
使用内置的 child_process 可以执行 bash 命令
1
2
3
4
5
6
7
8
9
|
var process = require('child_process');
var command = "ls -al";
process.exec(command, function(err, stdout, stderr) {
console.log(err);
console.log(stdout);
console.log(stderr);
});
|
0384 express 如何实现跨域
设置跨域
1
2
3
4
5
6
7
8
9
10
11
|
const express = require('express');
const app = express();
// cross origin
app.all('*', (req, res, next) => {
res.header('Access-Control-Allow-Origin', '*');
res.header('Access-Control-Allow-Headers', 'Content-Type');
res.header('Access-Control-Allow-Methods', '*');
res.header('Content-Type', 'application/json;charset=utf-8');
next();
});
|
0343 nodejs 的异步 IO 是什么
类似 ajax 请求，IO 操作（读写文件）比较耗时。
所以类似 ajax 异步操作，IO 操作也可以异步实现，在回调函数中处理逻辑。服务器中，处理运算，处理读写文件可以异步执行，避免某个 IO 操作耗时过长，阻塞其他的任务执行。
同步写法
1
2
3
4
5
|
const fs = require('fs');
const data = fs.readFileSync('./file.js');
console.log(data);
|
1
2
3
4
5
6
7
8
9
|
const fs = require('fs')
fs.readFile('./file.js',(err,data)=>{
console.log(err, data);
// null
// <Buffer 63 6f 6e 73 6f 6c 65 2e 6c 6f 67 28 27 68 77 6f 72 6c 64 27 29>
})
console.log(111) // 111
|
参考：https://juejin.cn/post/7002106372200333319
相关知识还有：事件循环，线程池等
0486 nodejs 如何执行操作系统命令？
nodejs 子进程调用操作系统的命令
使用 spawn 函数
spawn 模块可以调用操作系统上的程序，例如 cmd python3
spawn(command, args, options)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
const spawn = require('child_process').spawn;
const ls = spawn('ls', ['-lh', './']);
ls.stdout.on('data', function(data){
console.log('stdout: ' + data);
});
ls.stderr.on('data', function(data){
console.log('stderr: ' + data);
});
ls.on('close', function(code){
console.log('child process exited with code ' + code);
});
|
使用 exec 函数
好处是直接传递回调函数，执行的代码比较少
1
2
3
4
5
6
7
8
9
10
11
12
|
const { exec } = require('child_process');
exec('echo "Hello, World!"', (error, stdout, stderr) => {
if (error) {
console.error(`执行的错误: ${error}`);
return;
}
console.log(`stdout: ${stdout}`);
if (stderr) {
console.error(`stderr: ${stderr}`);
}
});
|
0485 nodejs 如何调用 python 函数
nodejs 调用 python 函数，具体有三种方案实现：
1、使用子进程方式实现
这个适应于小型脚本，Python 不依赖其他的环境等
1
2
3
4
|
# script.py
def greet(name):
return "Hello, " + name + "!"
|
js
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
// node_script.js
const { spawn } = require('child_process');
function callPythonFunction(funcName, arg) {
const pythonProcess = spawn('python', ['script.py', funcName, arg]);
pythonProcess.stdout.on('data', (data) => {
console.log(`stdout: ${data}`);
});
pythonProcess.stderr.on('data', (data) => {
console.error(`stderr: ${data}`);
});
pythonProcess.on('close', (code) => {
console.log(`child process exited with code ${code}`);
});
}
callPythonFunction('greet', 'Node.js');
|
需要实际测试一下（现在父进程无法获取子进程的返回值，存在问题）
2、python 开启一个服务，nodejs 调用 python 的服务
这个适应于大型服务，python node 是单独维护的项目
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
from flask import Flask, request
app = Flask(__name__)
@app.route('/process_string', methods=['POST'])
def process_string():
data = request.get_json() # 获取POST请求的JSON数据
dynamic_string = data.get('string', '') # 从JSON数据中获取字符串
# 在这里处理你的动态字符串
processed_string = dynamic_string + ' 已经被处理过。'
return {'processed_string': processed_string} # 返回处理过的字符串
if __name__ == '__main__':
app.run(port=5000) # 在5000端口上启动服务
|
3、调用第三方库，执行 python 脚本（字符串 Pyodide）
这种适应于简单一句调试，不适合大量使用（不利于Python脚本调试和改动）
1
2
3
4
5
6
7
8
|
const pyodide = require('pyodide');
pyodide.runPythonAsync(`
def hello(name):
return f"Hello, {name}!"
`).then((result) => {
console.log(result.result); // 输出：Hello, world!
});
|
0538 node-debug
node 打印日志 周下载量2亿
A tiny JavaScript debugging utility modelled after Node.js core’s debugging technique. Works in Node.js and web browsers.
https://www.npmjs.com/package/debug
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
// app
let debug = require('debug')('http');
let http = require('http');
let name = 'My App';
debug('booting %o', name);
http.createServer(function(req, res){
debug(req.method + ' ' + req.url);
res.end('hello\n');
}).listen(3000, function(){
debug('listening');
});
require('./worker');
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
// worker.js
var a = require('debug')('worker:a');
var b = require('debug')('worker:b');
function work() {
a('doing lots of uninteresting work');
setTimeout(work, Math.random() * 1000);
}
work();
function workb() {
b('doing some work');
setTimeout(workb, Math.random() * 2000);
}
workb();
|
0638 node-log4js
log4js是Node.js的日志库，提供比console.log更丰富的功能，支持日志级别、多输出目标和自定义格式。
https://www.npmjs.com/package/log4js
周下载量 400万，常用，可以创建不同级别的日志
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
const log4js = require("log4js");
// 配置文件
log4js.configure({
appenders: { cheese: { type: "file", filename: "cheese.log" } },
categories: { default: { appenders: ["cheese"], level: "error" } },
});
const logger = log4js.getLogger("cheese");
logger.debug('调试信息');
logger.info('普通信息');
logger.warn('警告信息');
logger.error('错误信息');
logger.trace("Entering cheese testing");
logger.debug("Got cheese.");
logger.info("Cheese is Comté.");
logger.warn("Cheese is quite smelly.");
logger.error("Cheese is too ripe!");
logger.fatal("Cheese was breeding ground for listeria.");
|
文件输出设置
1
2
3
4
5
6
7
8
|
log4js.configure({
appenders: {
file: { type: 'file', filename: 'logs/app.log' }
},
categories: {
default: { appenders: ['file'], level: 'info' }
}
});
|
日期滚动文件配置
1
2
3
4
5
6
7
8
9
10
11
12
13
|
log4js.configure({
appenders: {
dateFile: {
type: 'dateFile',
filename: 'logs/app',
pattern: 'yyyy-MM-dd.log',
alwaysIncludePattern: true
}
},
categories: {
default: { appenders: ['dateFile'], level: 'info' }
}
});
|
0639 node-mysql
nodeJS 的 mysql API
https://www.npmjs.com/package/mysql
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
|
var mysql = require('mysql');
var connection = mysql.createConnection({
host : 'localhost',
user : 'me',
password : 'secret',
database : 'my_db'
});
connection.connect();
connection.query('SELECT 1 + 1 AS solution', function (error, results, fields) {
if (error) throw error;
console.log('The solution is: ', results[0].solution);
});
connection.end();
|
0640 node-redis
nodeJS 的 redis API
https://www.npmjs.com/package/redis
开启 redis 服务
1
|
docker run -p 6379:6379 -it redis/redis-stack-server:latest
|
nodejs 连接 redis
1
2
3
4
5
6
7
8
9
10
11
|
import { createClient } from 'redis';
const client = await createClient()
.on('error', err => console.log('Redis Client Error', err))
.connect();
await client.set('key', 'value');
const value = await client.get('key');
await client.disconnect();
|
0654 nodemon
官网链接：
https://nodemon.io/
https://www.npmjs.com/package/nodemon
Nodemon 会监测代码的变动并热启动服务器，适合于 node 开发环境，可以取代传统的 node。
Nodemon 是一个实用工具，它会监测源文件的任何更改并自动重启服务器。非常适合开发环境使用。可以通过 [npm](https://npmjs.org/package/nodemon) 进行安装。
只需使用 `nodemon` 代替 `node` 来运行您的代码，现在当您的代码发生更改时，进程将自动重启。请先获取 nodejs 然后在终端中运行：
1
2
3
|
npm install -g nodemon
nodemon ./server.js localhost 8080
|
功能特性