绑定到 express.Router() 实例上的中间件,叫做路由级别的中间件。它的用法和应用级别中间件没有任何区别。
只不 过,应用级别中间件是绑定到 app 实例上,路由级别中间件绑定到 router 实例上,代码示例如下:
const app = express() const router = express.Router() // 路由级别的中间件 router.use(function (req, res, next) { console.log('Time', Date.now()) next() }) // 注册路由 app.use('/', router)
错误级别的中间件
错误级别中间件的作用:专门用来捕获整个项目中发生的异常错误,从而防止项目异常崩溃的问题。
格式:错误级别中间件的 function 处理函数中,必须有 4 个形参,形参顺序从前到后,分别是 (err, req, res, next)。
app.get('/', function (req, res) { throw new Error('服务器内部发生了错误!') // 抛出一个自定义的错误 res.send('Home Page.') }) app.use(function (err, req, res, next) { // 错误级别的中间件 console.log('发生了错误' + err.message) // 在服务器打印错误消息 res.send('Error' + err.message) // 向客户端响应错误相关的内容 })
注意:错误级别的中间件, 必须注册在所有路由之后!
Express内置的中间件
自 Express 4.16.0 版本开始,Express 内置了 3 个常用的中间件,极大的提高了 Express 项目的开发效率和体验:
① express.static 快速托管静态资源的内置中间件,例如: HTML 文件、图片、CSS 样式等(无兼容性)
② express.json 解析 JSON 格式的请求体数据(有兼容性,仅在 4.16.0+ 版本中可用)
③ express.urlencoded 解析 URL-encoded 格式的请求体数据(有兼容性,仅在 4.16.0+ 版本中可用)
// 配置解析 application/json 格式数据的内置中间件 app.use(express.json()) // 配置解析 application/x-www-form-urlencoded 格式数据的内置中间件 app.use(express.urlencoded({ extended: false}))
完整实例代码:
const express = require('express') const app = express() // 配置json格式中间件 app.use(express.json()) // 配置 x-www-form-urlencoded 格式的内置中间件 app.use(express.urlencoded({ extended: false })) // 挂在路由 app.get('/list', function (req, res) { // res.send(req.query) res.send(req.body) }) app.post('/add', function (req, res) { // res.send('got a post request') res.send(req.body) }) // 启动web服务器 app.listen(8080, () => { console.log('server is running'); })
第三方的中间件
非 Express 官方内置的,而是由第三方开发出来的中间件,叫做第三方中间件。在项目中,大家可以按需下载并配置 第三方中间件,从而提高项目的开发效率。
例如:在 express@4.16.0 之前的版本中,经常使用 body-parser 这个第三方中间件,来解析请求体数据。使用步 骤如下:
① 运行 npm install body-parser 安装中间件
② 使用 require 导入中间件
③ 调用 app.use() 注册并使用中间件
注意:Express 内置的 express.urlencoded 中间件,就是基于 body-parser 这个第三方中间件进一步封装出来的。