在前端的开发过程中，我们经常会遇到需要构建 RESTful API 的场景。而构建 API 的过程中，则需要考虑返回值的格式和内容。如果对此一无所知，那么 express-api-responder 就是你的救星。
什么是 express-api-responder？
express-api-responder 是一款专门用于构建 RESTful API 返回值的 Node.js 框架。它使用了标准的 HTTP 状态码和 JSON 结构体来构建返回值。
与普通的 JSON 结构体不同，express-api-responder 在 JSON 结构体中增加了一些常用的属性，例如 success 和 message 等，使其更加易于理解。
安装 express-api-responder
使用 npm 安装 express-api-responder 非常简单，只需要在终端输入以下命令即可：
npm install --save express-api-responder
使用 express-api-responder
下面我们就来一步步地学习如何使用 express-api-responder 构建 RESTful API。
初始化
首先我们需要在项目中引入 express-api-responder，并初始化它：
const express = require('express');
const app = express();
const responder = require('express-api-responder');
app.use(responder());构建成功返回值
为了构建成功的返回值，我们需要使用 res.apiSuccess 方法。下面是一个示例代码：
app.get('/user/:id', (req, res) => {
const user = getUserById(req.params.id);
res.apiSuccess(user);
});这里我们使用 res.apiSuccess 方法构建了返回值，并将查询到的用户信息作为参数传入。
构建错误返回值
当出现错误时，我们需要使用 res.apiError 方法构建错误的返回值。下面是一个示例代码：
-- -------------------- ---- -------
----------------- ----- ---- -- -
----- ---- - ---------------------
-- ------- -
------ ----------------- -------- ---- --------------
-
---------------------
---这里我们在创建用户时，先判断用户信息是否正确。如果用户信息不正确，则返回一个状态码为 400，并携带错误信息的错误返回值。
定制返回值格式
我们可以通过传入配置对象，来定制返回值的格式和内容。下面是一个示例代码：
-- -------------------- ---- -------
----- --------------- - -
------ ----- ---- ---- ----- -- -
----------------- -------------
--
-------- ----- ---- ----- -- -
----------------- -------- -----------
-
--
------------------------------------这里我们在配置对象中，定义了 error 和 noRoute 方法。当出现错误时，会调用 error 方法；当访问无效的路由时，会调用 noRoute 方法。
总结
本文介绍了 express-api-responder 的使用方法。通过学习本文内容，你可以了解如何使用 express-api-responder 构建 RESTful API 返回值，并定制返回值的格式和内容。
接下来，你可以使用 express-api-responder 帮助你快速构建 RESTful API。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/60056f7081e8991b448e7a21