url.build

url.build

url.build

功能

从对象配置构建 URL 字符串。

语法

参数

参数类型必填默认值说明
configObject构造 url 时传入的对象URL 配置对象。

config 对象字段

字段类型必填默认值说明
schemeStringhttpURL scheme,不需要写 ://
hostString空字符串主机名或 IP。没有 host 时仍会按当前实现生成 scheme:// 开头的 URL。
portInt/String端口号。字段值不是 emptynull 时会原样转字符串拼到 host 后。
pathString/URL 路径。不以 / 开头时会自动补 /
queryObject/String/Any查询字符串。Object 会按键值逐项 URL 编码;String 原样作为查询字符串;其它值先转字符串。空字符串不会写入 ?
fragmentStringURL fragment,不需要写 #;写入时会做百分号编码。
usernameString用户名。非空时会写入 username@,并做百分号编码。
passwordString密码。只有 username 非空时才会写入,并做百分号编码。

返回值

类型说明
String构建后的 URL。

代码示例

注意事项

  • query 为 Object 时,字段名和值都会按 URL 组件规则编码。
  • build() 只做轻量字符串构建,不校验 host 是否为空,也不检查 scheme 是否真实存在。