Node.js v4.2.4 手册 & 文档
目录
URL#
稳定度: 3 - 稳定
该模块包含用以 URL 解析的实用函数。
使用 require('url')
来调用该模块。
不同的 URL 字符串解析后返回的对象会有一些额外的字段信息,仅当该部分出现在 URL 中才会有。以下是一个 URL 例子:
'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'
href
: 所解析的完整原始 URL。协议名和主机名都已转为小写。
例如: `'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'`
protocol
: 请求协议,小写
例如: `'http:'`
host
: URL主机名已全部转换成小写, 包括端口信息
例如: `'host.com:8080'`
auth
:URL中身份验证信息部分
例如: `'user:pass'`
hostname
:主机的主机名部分, 已转换成小写
例如: `'host.com'`
port
: 主机的端口号部分
例如: `'8080'`
pathname
: URL的路径部分,位于主机名之后请求查询之前, including the initial slash if present.
例如: `'/p/a/t/h'`
search
: URL 的“查询字符串”部分,包括开头的问号。
例如: `'?query=string'`
path
:pathname
和search
连在一起。
例如: `'/p/a/t/h?query=string'`
query
: 查询字符串中的参数部分(问号后面部分字符串),或者使用querystring.parse()
解析后返回的对象。
例如: `'query=string'` or `{'query':'string'}`
hash
: URL 的 “#” 后面部分(包括 # 符号)
例如: `'#hash'`
以下是 URL 模块提供的方法:
url.parse(urlStr, [parseQueryString], [slashesDenoteHost])#
输入 URL 字符串,返回一个对象。
将第二个参数设置为 true
则使用 querystring
模块来解析 URL 中的查询字符串部分,默认为 false
。
将第三个参数设置为 true
来把诸如 //foo/bar
这样的URL解析为
{ host: 'foo', pathname: '/bar' }
而不是
{ pathname: '//foo/bar' }
。 默认为 false
。
url.format(urlObj)#
输入一个 URL 对象,返回格式化后的 URL 字符串。
href
属性会被忽略处理.protocol
无论是否有末尾的:
(冒号),会同样的处理- 这些协议包括
http
,https
,ftp
,gopher
,file
后缀是://
(冒号-斜杠-斜杠). - 所有其他的协议如
mailto
,xmpp
,aim
,sftp
,foo
, 等 会加上后缀:
(冒号)
- 这些协议包括
auth
如果有将会出现.hostname
如果host
属性没被定义,则会使用此属性.port
如果host
属性没被定义,则会使用此属性.host
优先使用,将会替代hostname
和port
pathname
将会同样处理无论结尾是否有/
(斜杠)search
将会替代query
属性query
(object类型; 详细请看querystring
) 如果没有search
,将会使用此属性.search
无论前面是否有?
(问号),都会同样的处理hash
无论前面是否有#
(井号, 锚点),都会同样处理
url.resolve(from, to)#
给定一个基础URL路径,和一个href URL路径,并且象浏览器那样处理他们可以带上锚点。 例子:
url.resolve('/one/two/three', 'four') // '/one/two/four'
url.resolve('http://example.com/', '/one') // 'http://example.com/one'
url.resolve('http://example.com/one', '/two') // 'http://example.com/two'