The URL string to parse.
The url.parse()
method takes a URL string, parses it, and returns a URL
object.
A TypeError
is thrown if urlString
is not a string.
A URIError
is thrown if the auth
property is present but cannot be decoded.
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.
The URL string to parse.
If true
, the query
property will always be set to an object returned by the querystring module's parse()
method. If false
, the query
property
on the returned URL object will be an unparsed, undecoded string.
Optional
slashesDenoteHost: booleanIf true
, the first token after the literal string //
and preceding the next /
will be interpreted as the host
. For instance, given //foo/bar
, the
result would be {host: 'foo', pathname: '/bar'}
rather than {pathname: '//foo/bar'}
.
The url.parse()
method takes a URL string, parses it, and returns a URL
object.
A TypeError
is thrown if urlString
is not a string.
A URIError
is thrown if the auth
property is present but cannot be decoded.
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.
The URL string to parse.
If true
, the query
property will always be set to an object returned by the querystring module's parse()
method. If false
, the query
property
on the returned URL object will be an unparsed, undecoded string.
Optional
slashesDenoteHost: booleanIf true
, the first token after the literal string //
and preceding the next /
will be interpreted as the host
. For instance, given //foo/bar
, the
result would be {host: 'foo', pathname: '/bar'}
rather than {pathname: '//foo/bar'}
.
The url.parse()
method takes a URL string, parses it, and returns a URL
object.
A TypeError
is thrown if urlString
is not a string.
A URIError
is thrown if the auth
property is present but cannot be decoded.
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.
The URL string to parse.
If true
, the query
property will always be set to an object returned by the querystring module's parse()
method. If false
, the query
property
on the returned URL object will be an unparsed, undecoded string.
Optional
slashesDenoteHost: booleanIf true
, the first token after the literal string //
and preceding the next /
will be interpreted as the host
. For instance, given //foo/bar
, the
result would be {host: 'foo', pathname: '/bar'}
rather than {pathname: '//foo/bar'}
.
The
url.parse()
method takes a URL string, parses it, and returns a URL object.A
TypeError
is thrown ifurlString
is not a string.A
URIError
is thrown if theauth
property is present but cannot be decoded.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 forurl.parse()
vulnerabilities. Use theWHATWG URL
API instead.