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