URL 模块

URL 模块为 XScript 提供 URL 解析、格式化和操作功能。

功能特性

URL 解析 - 解析 URL 各个组成部分

URL 构建 - 从对象构建 URL 字符串

查询字符串 - 解析和序列化查询参数

URL 编码 - 编码和解码 URL 组件

相对路径 - 解析相对 URL

域名处理 - 提取和验证域名

基本使用

引入模块

解析 URL

格式化 URL

解析查询字符串

URL 编码/解码

解析相对 URL

API 参考

`url.parse(urlString, parseQuery)`

解析 URL 字符串。

参数:

urlString (string) - URL 字符串

parseQuery (boolean) - 是否解析查询字符串为对象

返回: (object) URL 对象

`url.format(urlObject)`

格式化 URL 对象为字符串。

参数:

urlObject (object) - URL 对象

返回: (string) URL 字符串

`url.resolve(from, to)`

解析相对 URL。

参数:

from (string) - 基础 URL

to (string) - 相对 URL

返回: (string) 绝对 URL

`url.encodeComponent(str)`

编码 URL 组件。

`url.decodeComponent(str)`

解码 URL 组件。

URL 对象结构

实际应用场景

API 请求构建

路由解析

域名提取

URL 验证

安全 URL 构建

分页 URL 生成

最佳实践

始终验证 - 解析前验证 URL 格式

编码处理 - 正确编码特殊字符

协议检查 - 验证协议是否允许

相对路径 - 使用 resolve 处理相对路径

查询参数 - 使用 parseQuery 自动解析

安全性 - 防止 URL 注入攻击

注意事项

协议 - 包含冒号(如 'https:')

端口 - 默认端口可省略

路径 - 以斜杠开头

编码 - 特殊字符需要编码

查询字符串 - 以问号开头

url

URL 模块#

功能特性#

基本使用#

引入模块#

解析 URL#

格式化 URL#

解析查询字符串#

URL 编码/解码#

解析相对 URL#

API 参考#

url.parse(urlString, parseQuery)#

url.format(urlObject)#

url.resolve(from, to)#

url.encodeComponent(str)#

url.decodeComponent(str)#

URL 对象结构#

实际应用场景#

API 请求构建#

路由解析#

域名提取#

URL 验证#

安全 URL 构建#

分页 URL 生成#

最佳实践#

注意事项#

相关模块#

URL 模块

功能特性

基本使用

引入模块

解析 URL

格式化 URL

解析查询字符串

URL 编码/解码

解析相对 URL

API 参考

`url.parse(urlString, parseQuery)`

`url.format(urlObject)`

`url.resolve(from, to)`

`url.encodeComponent(str)`

`url.decodeComponent(str)`

URL 对象结构

实际应用场景

API 请求构建

路由解析

域名提取

URL 验证

安全 URL 构建

分页 URL 生成

最佳实践

注意事项

相关模块