url.parse

url.parse

url.parse

功能

解析当前 URL 为对象。

语法

参数

无。

返回值

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

返回对象字段

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

代码示例

注意事项

  • URL 无法解析时会抛出运行时错误。
  • passwordhostportqueryfragment 这些可选 URL 组件缺失时返回 empty