express-query-boolean 是一个 Node.js 的中间件，它可以将 URL 查询参数中的字符串转换为布尔值，并将其添加到 req.query 对象中。在构建 RESTful API 时，我们需要经常使用 URL 查询参数来控制 API 的行为，例如分页、过滤和排序等。而且，有时我们需要使用布尔值作为查询参数，例如开关和标记等。但是，由于 HTTP 协议只支持字符串作为查询参数的值，因此我们需要在服务器端将字符串转换为布尔值，这个过程比较烦琐，而 express-query-boolean 正是用于解决这个问题的。
安装和基本使用
首先确保你已经安装了 Node.js 和 Express.js，然后在你的项目目录中运行以下命令安装 express-query-boolean：
npm install express-query-boolean
安装完成后，在你的 Express.js 应用中添加以下代码即可：
-- -------------------- ---- ------- ----- ------- - ------------------ ----- ------------ - -------------------------------- ----- --- - --------- ----------------------- ------------ ----- ---- -- - ------------------- -- ---------------- -- -- - ------------------- -- --------- -- ---- ------ --
这段代码创建了一个 Express.js 应用，并使用 queryBoolean 中间件将查询参数转换为布尔值。当访问根路径时，这个应用将返回一个 JSON 对象，其中包含了查询参数 ?foo=true&bar=false。
API
queryBoolean([options])
创建一个 Express.js 中间件，用于将查询参数转换为布尔值。
options
query要转换的查询参数的名称，默认为q。trueValues代表布尔值为true的所有值的数组，默认为['true', '1']。falseValues代表布尔值为false的所有值的数组，默认为['false', '0']。
示例代码
以下是一个使用示例，该示例展示了 queryBoolean 中间件的各种用法：
-- -------------------- ---- -------
----- ------- - ------------------
----- ------------ - --------------------------------
----- --- - ---------
-----------------------
---------------------- ------ --------- ----------- -------- ------------ ------ ---
---------------------- ------ ------- ----------- -------- ------------ -------- ---
------------ ----- ---- -- -
----- - ----- - - ---
----------
---- ----------
---- ----------
------- -------------
----- -----------
--
--
---------------- -- -- -
------------------- -- --------- -- ---- ------
--在上面的示例代码中，我们展示了如何使用 queryBoolean 中间件处理三个不同的查询参数，并使用不同的 trueValues 和 falseValues 参数来处理不同的值。当访问根路径时，这个应用将返回一个 JSON 对象，其中包含了查询参数 ?foo=true&bar=false&filter=yes&sort=asc。
指导意义
- 当你需要使用布尔值作为查询参数时，你可以使用 express-query-boolean 中间件，它会自动将字符串转换为布尔值。
- express-query-boolean 可以根据特定的查询参数和值进行配置，以满足不同的业务需求。
- express-query-boolean 可以简化编码工作，并提高代码的可读性和可维护性。
学习
你可以在以下链接中详细了解 express-query-boolean 中间件的实现原理和应用场景：
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/express-query-boolean