Node.js URL 模块概述

稳定性: 3 - 稳定

Node.js的URL模块提供了用于分析和解析URL的实用程序。可以调用require('url')来访问它：

const url = require('url');

解析URL对象有以下内容，依赖于他们是否在URL字符串里存在。任何不在URL字符串里的部分，都不会出现在解析对象里。例子如下：

'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'

1. href：准备解析的完整的URL，包含协议和主机（小写）。

   例子：'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'

2. protocol: 请求协议，小写。

   例子：'http:'

3. slashes: 协议要求的斜杠（冒号后）

   例子：true或false

4. host: 完整的URL小写主机部分，包含端口信息。

   例子：'host.com:8080'

5. auth: url中的验证信息。

   例子：'user:pass'

6. hostname: 域名中的小写主机名

   例子：'host.com'

7. port: 主机的端口号

   例子：'8080'

8. pathname: URL中的路径部分，在主机名后，查询字符前，包含第一个斜杠。

   例子：'/p/a/t/h'

9. search: URL中得查询字符串，包含开头的问号

   例子：'?query=string'

10. path: pathname和search连在一起

    例子：'/p/a/t/h?query=string'

11. query: 查询字符串中得参数部分，或者使用querystring.parse()解析后返回的对象。

    例子：'query=string'或者{'query':'string'}

12. hash: URL的“#”后面部分（包括 # 符号）

    例子：'#hash'

URL模块提供了以下方法：

url.parse(urlStr[, parseQueryString][, slashesDenoteHost])

输入URL字符串，返回一个对象。

第二个参数为true时，使用querystring来解析查询字符串。如果为true，query属性将会一直赋值为对象，并且search属性将会一直是字符串(可能为空)。默认为false。

第三个参数为true，把//foo/bar当做{ host: 'foo', pathname: '/bar' } ，而不是{ pathname: '//foo/bar' }。默认为false。

url.format(urlObj)

输入一个解析过的URL对象，返回格式化过的字符串。

格式化的工作流程：

1. href会被忽略
2. protocol无论是否有末尾的 : (冒号)，会同样的处理
   1. http，https，ftp，gopher，file协议会被添加后缀://
   2. mailto，xmpp，aim，sftp，foo等协议添加后缀:
3. slashes如果协议需要://，设置为true。
   1. 仅需对之前列出的没有斜杠的协议，比如议mongodb://localhost:8000/
4. auth如果出现将会使用.
5. hostname仅在缺少host时使用
6. port仅在缺少host时使用
7. host用来替换hostname和port
8. pathname无论结尾是否有“/”将会同样处理
9. search将会替 query属性
   1. 无论前面是否有“/”将会同样处理
10. query (对象；参见querystring) 如果没有search，将会使用
11. 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'