在 Web 应用中，文件上传是一项基本操作。Express.js 是一款流行的 Node.js Web 框架，提供了丰富的功能和插件支持。它也可以很容易地实现文件上传的功能。本文将介绍如何在 Express.js 中处理文件上传的功能。
简要介绍 Multer
在 Express.js 中，要处理文件上传的功能，需要用到 Multer 插件。Multer 是一个中间件，可用于处理多部分表单数据，主要是用于上传文件。它基于 busboy 的封装，支持对文件大小、数量、类型等进行限制，并提供了大量的选项和事件钩子等。
安装和配置 Multer
要使用 Multer，需要先在项目中安装该插件，可以使用 npm 命令进行安装，具体命令如下所示：
npm install --save multer
安装完成后，引入 Multer，配置上传的目录等参数，如下所示：
-- -------------------- ---- -------
----- ------- - -------------------
----- ------ - ------------------
----- --- - ----------
-- -------------
----- ------- - --------------------
------------ -------- ----- ----- --- -
-------- ------------
--
--------- -------- ----- ----- --- -
-------- -------------- - --- - -----------
-
---
-- -- ------ ----------
----- ------ - --------
-------- --------
------- - --------- ---- - ---- --
----------- -------- ----- ----- --- -
-- ----------------------
-- --------------------------------------------------- -
------ ------ ----------- ----- ----- --- ----------- -------
-
-------- ------
-
---在上面的代码中，首先创建了一个存储实例 storage，指定了上传的目录并设置了上传的文件名。然后创建了 Multer 的实例，通过 upload 对象可以使用 Multer 的各种功能。其中，limits 属性用于配置上传文件的大小限制，fileFilter 方法可用于自定义文件类型的限制，如上代码可只上传图片类型的文件。
处理文件上传
完成了 Multer 的配置之后，可以使用这个插件来处理上传部分数据的请求。在使用时，需要创建一个路由，用 POST 方法传递请求，示例代码如下所示：
app.post('/upload', upload.single('avatar'), function (req, res, next) {
// req.file 是 `avatar` 图片的信息
// req.body 将具有文本域数据，如果存在的话
res.send('Upload success!');
});在上面的代码中，使用了 upload.single() 方法，并传递了表单中上传文件的字段名，这个例子中指的是 avatar。Multer 会对表单数据进行处理，并将上传的文件存储在指定的目录下。在路由回调函数中，可以使用 req.file 对象访问上传文件的信息，req.body 可以访问文本域数据。例如可以用 req.file.fieldname 来访问上传文件的字段名，req.file.originalname 访问上传的文件名。
如果要处理多个文件上传，可以使用 upload.array() 方法，传递一个字段名和最大文件数量限制，如下所示：
app.post('/upload', upload.array('photos', 5), function (req, res, next) {
// 处理上传的多个图片
});如果要处理上传的多部分数据，可以使用 upload.fields() 方法，传递一个数组，每个元素代表一个上传字段，如下所示：
app.post('/upload', upload.fields([{ name: 'image1', maxCount: 1 }, { name: 'image2', maxCount: 1 }]), function (req, res, next) {
// 处理上传的多部分数据
});错误处理
在向客户端返回响应时，需要对出错情况进行处理，因为 Multer 在上传失败的情况下会抛出一个错误，在错误中包含了文件大小、类型等不符合要求的相关信息。因此，在上传过程中，应该及时处理 Multer 抛出的错误信息，并将错误信息返回给客户端。
要实现错误处理，可以将 upload.single() 方法和路由回调函数封装在一个自定义的中间件函数中，如下所示：
-- -------------------- ---- -------
-------- ----------------- ---- ---- ----- -
-- ----- -
---------------------- ------ ------- --------- -------- ----------- ---
-
-
------------------- ------------------------ -------- ----- ---- ----- -
-- ---------
-- --------------在上面的代码中，创建了一个自定义的 errorHandler 中间件函数，在上传失败时会返回一个包含错误信息的 JSON 响应。如果路由回调函数中出现错误，会跳过 errorHandler，继续向下执行。
总结
本文介绍了在 Express.js 中处理文件上传的方式，需要用到 Multer 插件。在使用 Multer 时，需要创建存储实例并配置参数来实现自己的需求。当出现错误时，应该使用中间件 errorHandler 处理并向客户端返回错误信息。在实际项目中，需要根据业务需求和实际情况调整配置和参数以实现最佳性能和用户体验。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64a550cb48841e98941d9ba8