### 稳定度: 2 - 稳定 这个模块提供了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:'` - slashes: 协议要求冒号后有斜杠。 例子： `true` 或 `false` - host: URL的所有主机部分，包括端口，小写。 例子： `'host.com:8080'` - auth: URL的认证信息部分。 例子： `'user:pass'` - hostname: 小写的主机名部分。 例子： `'host.com'` - port: 主机部分的端口号。 例子： `'8080'` - pathname: URL的路径部分，在主机之后，在查询之前，包括最前面的斜杠，如果存在的话。不提供解码。 例子： `'/p/a/t/h'` - search: URL的“查询字符串”部分，包括前导的问号标志。 例子： `'?query=string'` - path: 路径和查询的连接体。不提供解码。 例子： `'/p/a/t/h?query=string'` - query: 查询字符串的“参数”部分，或查询字符串被解释后的对象。 例子： `'query=string'` 或 `{'query':'string'}` - hash: URL的“碎片”部分，包括英镑符号。 例子： `'#hash'` 以下是URL模块提供的方法： #### url.parse(urlStr[, parseQueryString][, slashesDenoteHost]) 接收一个URL字符串，然后返回一个对象。 对第二个参数传递`true`，将使用`querystring`模块来解释查询字符串。如果为`true`，那么最后的对象中一定存在`query`属性，并且`search`属性将总是一个字符串（可能为空）。如果为`false`，那么`query`属性将不会被解释或解码。默认为`false`。 对第三个参数传递`true`，将会把`//foo/bar`解释为`{ host: 'foo', pathname: '/bar' }`，而不是`{ pathname: '//foo/bar' }`。默认为`false`。 #### url.format(urlObj) 接受一个解释完毕的URL对象，返回格式化URL字符串。 以下是格式化过程： - `href`将会被忽略。 - `path`将会被忽略。 - **协议无论是否有末尾的冒号，都会被同样处理。** - http，https，ftp，gopher，file协议的后缀是`://`。 - 所有其他如mailto，xmpp，aim，sftp，foo等协议的后缀是`:`。 - **如果协议要求有 `://` ，`slashes`会被设置为`true`** - 只有之前没有列出的要求有斜线的协议才需要被设置。如`mongodb://localhost:8000/`。 - `auth`会被使用，如果存在的话。 - 只有当缺少`host`时，才会使用`hostname`。 - 只有当缺少`host`时，才会使用`port`。 - `host`将会替代`hostname`和`port`。 - 无论有没有前导 / （斜线），`pathname`都会被相同对待。 - 只有在缺少`search`时，才会使用`query`（对象；参阅`querystring`）。 - **`search`将会替代`query`** - 无论有没有前导 ?（问号），它都会被相同对待。 - 无论有没有前导 #（英镑符号），`hash`都会被相同对待。 #### url.resolve(from, to) 接受一个基础URL，和一个路径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' ~~~