穩(wěn)定度: 2 - 穩(wěn)定

這個(gè)模塊提供了 URL 解析和解釋的工具。通過(guò)require('url')使用它。

解釋 URL 為一個(gè)含有以下部分或全部屬性的對(duì)象，依賴(lài)于它們是否在 URL 字符串中存在。任何不存在的部分都不會(huì)出現(xiàn)在解釋后的對(duì)象中。一個(gè)下面 URL 的例子：

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

• href: 最初傳遞的全部 URL。協(xié)議和主機(jī)都是小寫(xiě)的。

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

• protocol: 請(qǐng)求的協(xié)議，小寫(xiě)。

例子： 'http:'

• slashes: 協(xié)議要求冒號(hào)后有斜杠。

例子： true 或 false

• host: URL 的所有主機(jī)部分，包括端口，小寫(xiě)。

例子： 'host.com:8080'

• auth: URL 的認(rèn)證信息部分。

例子： 'user:pass'

• hostname: 小寫(xiě)的主機(jī)名部分。

例子： 'host.com'

• port: 主機(jī)部分的端口號(hào)。

例子： '8080'

• pathname: URL 的路徑部分，在主機(jī)之后，在查詢(xún)之前，包括最前面的斜杠，如果存在的話(huà)。不提供解碼。

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

• search: URL 的“查詢(xún)字符串”部分，包括前導(dǎo)的問(wèn)號(hào)標(biāo)志。

例子： '?query=string'

• path: 路徑和查詢(xún)的連接體。不提供解碼。

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

• query: 查詢(xún)字符串的“參數(shù)”部分，或查詢(xún)字符串被解釋后的對(duì)象。

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

• hash: URL 的“碎片”部分，包括英鎊符號(hào)。

例子： '#hash'

以下是 URL 模塊提供的方法：

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

接收一個(gè) URL 字符串，然后返回一個(gè)對(duì)象。

對(duì)第二個(gè)參數(shù)傳遞true，將使用querystring模塊來(lái)解釋查詢(xún)字符串。如果為true，那么最后的對(duì)象中一定存在query屬性，并且search屬性將總是一個(gè)字符串（可能為空）。如果為false，那么query屬性將不會(huì)被解釋或解碼。默認(rèn)為false。

對(duì)第三個(gè)參數(shù)傳遞true，將會(huì)把//foo/bar解釋為{ host: 'foo', pathname: '/bar' }，而不是{ pathname: '//foo/bar' }。默認(rèn)為false。

url.format(urlObj)

接受一個(gè)解釋完畢的 URL 對(duì)象，返回格式化 URL 字符串。

以下是格式化過(guò)程：

• href將會(huì)被忽略。
• path將會(huì)被忽略。
• 協(xié)議無(wú)論是否有末尾的冒號(hào)，都會(huì)被同樣處理。
  • http，https，ftp，gopher，file 協(xié)議的后綴是://。
  • 所有其他如 mailto，xmpp，aim，sftp，foo 等協(xié)議的后綴是:。
• 如果協(xié)議要求有 :// ，slashes會(huì)被設(shè)置為true
  • 只有之前沒(méi)有列出的要求有斜線(xiàn)的協(xié)議才需要被設(shè)置。如mongodb://localhost:8000/。
• auth會(huì)被使用，如果存在的話(huà)。
• 只有當(dāng)缺少host時(shí)，才會(huì)使用hostname。
• 只有當(dāng)缺少host時(shí)，才會(huì)使用port。
• host將會(huì)替代hostname和port。
• 無(wú)論有沒(méi)有前導(dǎo) / （斜線(xiàn)），pathname都會(huì)被相同對(duì)待。
• 只有在缺少search時(shí)，才會(huì)使用query（對(duì)象；參閱querystring）。
• search將會(huì)替代query
  • 無(wú)論有沒(méi)有前導(dǎo) ?（問(wèn)號(hào)），它都會(huì)被相同對(duì)待。
• 無(wú)論有沒(méi)有前導(dǎo) #（英鎊符號(hào)），hash都會(huì)被相同對(duì)待。

url.resolve(from, to)

接受一個(gè)基礎(chǔ) URL，和一個(gè)路徑 URL，并且?guī)襄^點(diǎn)像瀏覽器一樣解析他們。例子：

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'