url.parse(urlString[, parseQueryString[, slashesDenoteHost]])
¥Stability: 0 - Deprecated: Use the WHATWG URL API instead.
-
urlString
<string> 要解析的 URL 字符串。¥
urlString
<string> The URL string to parse. -
parseQueryString
<boolean> 如果为true
,则query
属性将始终设置为querystring
模块的parse()
方法返回的对象。如果为false
,则返回的网址对象上的query
属性将是未解析、未解码的字符串。默认值:false
。¥
parseQueryString
<boolean> Iftrue
, thequery
property will always be set to an object returned by thequerystring
module'sparse()
method. Iffalse
, thequery
property on the returned URL object will be an unparsed, undecoded string. Default:false
. -
slashesDenoteHost
<boolean> 如果为true
,则字面串//
之后和下一个/
之前的第一个令牌将被解释为host
。例如,给定//foo/bar
,结果将是{host: 'foo', pathname: '/bar'}
而不是{pathname: '//foo/bar'}
。默认值:false
。¥
slashesDenoteHost
<boolean> Iftrue
, the first token after the literal string//
and preceding the next/
will be interpreted as thehost
. For instance, given//foo/bar
, the result would be{host: 'foo', pathname: '/bar'}
rather than{pathname: '//foo/bar'}
. Default:false
.
url.parse()
方法接受网址字符串,解析并返回网址对象。
¥The url.parse()
method takes a URL string, parses it, and returns a URL
object.
如果 urlString
不是字符串,则抛出 TypeError
。
¥A TypeError
is thrown if urlString
is not a string.
如果 auth
属性存在但无法解码,则抛出 URIError
。
¥A URIError
is thrown if the auth
property is present but cannot be decoded.
url.parse()
使用一种宽松的、非标准的算法来解析 URL 字符串。它很容易出现安全问题,例如 主机名欺骗 和用户名和密码的不正确处理。不要使用不受信任的输入。不针对 url.parse()
漏洞发布 CVE。改用 WHATWG URL API。
¥url.parse()
uses a lenient, non-standard algorithm for parsing URL
strings. It is prone to security issues such as host name spoofing
and incorrect handling of usernames and passwords. Do not use with untrusted
input. CVEs are not issued for url.parse()
vulnerabilities. Use the
WHATWG URL API instead.