url.parse

url.parse

url.parse

功能

解析当前 URL 为对象。

语法

参数

无。

返回值

类型说明
Object返回 URL 解析对象。字段见下方“返回对象字段”。

返回对象字段

字段类型必定存在说明
schemeString是URL scheme,不含 :,例如 http、https。
usernameString是URL 用户名。没有用户名时为空字符串。
passwordString/Empty是URL 密码。没有密码时为 empty。
hostString/Empty是主机名或 IP 字符串。URL 没有 host 时为 empty。
portInt/Empty是显式端口号。URL 未显式提供端口时为 empty,不会返回 scheme 的默认端口。
pathString是URL 路径,通常以 / 开头。
queryString/Empty是原始查询字符串,不含 ?。没有查询字符串时为 empty。
fragmentString/Empty是URL fragment,不含 #。没有 fragment 时为 empty。
originString是URL origin 的 ASCII 序列化结果,例如 https://btlang.org。
urlString是标准化后的完整 URL 字符串。

代码示例

注意事项

  • URL 无法解析时会抛出运行时错误。
  • password、host、port、query、fragment 这些可选 URL 组件缺失时返回 empty。