在编写 Node.js 后端代码时，常常需要解析 HTTP 请求中的查询参数。而 HapiJS 框架中提供了非常方便的查询参数解析工具，使得我们能够更加高效地处理 HTTP 请求。在本文中，我们将深入探讨 HapiJS 查询参数解析的使用方式及其实现原理，让读者能够深入理解并掌握这一重要技术。
什么是查询参数？
在 HTTP 请求中，查询参数是指 URL 中的 "?" 后面的一段字符串，例如：
https://example.com/search?q=hello&limit=10&page=1
其中，查询参数为 q=hello&limit=10&page=1，表示查询关键词为 "hello"，每页返回 10 条数据，当前为第 1 页。
HapiJS 查询参数解析
HapiJS 提供了 hapi/joi 模块，并使用其 object 函数进行查询参数解析。下面是一个简单的查询参数解析例子：
-- -------------------- ---- -------
----- ---- - ----------------------
----- --- - ---------------------
----- ------ - -------------
----- -----
----- -----------
---
----- ----------- - ------------
-- ------------------------
------ ------------------------
----- -----------------------
------------ ------------- ---- ---
--------------
------- ------
----- ----------
-------- --------- -- -- -
----- ----- - ------------------------------------
------ ------
-
---
------ -- -- -
----- ---------------
------------------- ------- -- ---------------------
-----在这个例子中，我们定义了一个 querySchema，用于定义查询参数的校验规则。其中，我们使用了 Joi.string() 定义了 q 参数为字符串类型，使用了 Joi.number() 定义了 limit 和 page 参数为数值类型。Joi.optional() 则表示这些参数是可选的。最后，我们使用 options({ stripUnknown: true }) 选项来在解析时删除未定义的查询参数。
在路由的处理函数中，我们使用 querySchema.validate(request.query)，来通过定义的 querySchema 对查询参数进行解析和校验。当查询参数不符合定义的规则时，validate 方法会抛出错误。否则，返回解析后的查询参数对象。
示例代码
上面的例子非常简单，我们来看一个稍微复杂一些的查询参数解析例子：
-- -------------------- ---- -------
----- ---- - ----------------------
----- --- - ---------------------
----- ------ - -------------
----- -----
----- -----------
---
----- ------ - ------------
-- ---------------------------------------
------ ---------------------------------------------------
------- -----------------------------------------
----- ------------------------------------------------------------
------- -----------------------------------------------
------- ------------------------------------------------------
------------
------------- ------
------------- ----
---
--------------
------- ------
----- ----------
-------- ----- --------- -- -- -
----- - -- ------ ------- ----- ------- ------ - - ----- ------------------------------------
------ -
--
------
-------
-----
------- ------ - ----------------- - ---
------- ------ - --------------------------------------------- -- ----------------- - --
--
-
---
------ -- -- -
----- ---------------
------------------- ------- -- ---------------------
-----在这个例子中，我们定义了一个更加完整的查询参数规则，并且对其中的默认值、正则表达式、Object 转换等多种操作进行了演示。同时，由于本例中未定义的查询参数将被视为非法，我们采用了 allowUnknown: false，将未知参数视为错误拒绝请求。
总结
通过本文的学习，我们了解了查询参数的基本概念，并学习了使用 HapiJS 的查询参数解析工具 Joi.object 来解析和校验 HTTP 请求中的查询参数。本文也提供了多个完整的示例代码，方便读者理解和应用。掌握查询参数解析的技术，能够在 Node.js 后端开发中大大提高效率和代码质量，是每位前端工程师必须掌握的技术之一。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/6488484d48841e98946cc4de