Node.js URL 处理:请求路径与查询参数

在 Node.js 中解析相对请求地址,并取得请求路径与查询参数。

🎯 引言

学完这篇文章,你能在 Node.js 中解析相对请求地址,取得路径与查询参数。


🧱 Node.js 中的区别:没有当前页面地址

Node.js 的 URL 和 URLSearchParams 与浏览器中的标准 API 用法相同。这里要解决的问题是:服务收到的请求地址可能只有 /users?page=2,而 Node.js 没有浏览器的当前页面地址供你补全。

解析这类请求地址时,要显式提供基础地址。

下面用一个请求地址字符串模拟输入,保存为 request-url.mjs,各段按顺序追加后运行 node request-url.mjs。


🛠 为相对请求地址提供基础地址

const requestUrl = '/users?page=2&tag=js&tag=node'
const url = new URL(requestUrl, 'http://localhost:3000')
console.log(url.pathname)

输出 /users。第一个参数是待解析内容,第二个参数补上协议和主机;构造 URL 对象只解析地址,不会向 localhost 发送网络请求。

如果只写 new URL(requestUrl),这个相对地址缺少基础地址,会抛出无效 URL 错误。处理服务请求时,应使用应用明确配置的基础地址;不要直接信任客户端提供的主机信息来生成对外链接。


🔍 读取用于处理请求的参数

取得页码:

console.log(url.searchParams.get('page'))

输出 2,返回值是字符串 '2';参数不存在时返回 null。进入后续查询前仍要转换并验证页码范围,解析成功不代表输入合法。

重复参数要按接口约定处理。这里允许多个标签,用 getAll 取得全部值:

console.log(url.searchParams.getAll('tag'))

输出 ['js', 'node'];使用 get('tag') 则只能取得第一个值 'js'。因此编写接口时要明确参数允许单个还是多个值,避免丢失筛选条件。

构造对外请求时,继续使用已熟悉的 URLSearchParams 设置参数即可,不需要为 Node.js 另外学习一套拼接方式,也不应手动拼接未经编码的用户输入。


❓ 知识问答

Q1:问号后的值会自动转换成数字吗?

不会,需要按业务含义自行转换并验证。

Q2:相对请求地址为什么不能直接传给 new URL?

它缺少协议和主机,Node.js 也没有当前页面地址作为默认起点,需要明确传入基础地址。

Q3:URL 解析成功代表地址可以安全请求吗?

不代表,是否允许访问仍需另外检查协议、主机等条件。


🧪 小练习

给模拟请求增加一个标签,并分别删除 page 参数、将 page 改为 abc;读取结果后,在注释中说明后端应接受还是拒绝这些输入。

// 请在这里编写代码

🎉 现在可以用自己的例子验证这些用法啦!