nodeJS之URL

前面的話

  在HTTP部分,詳細介紹了URL的相關知識。而nodejs中的url模塊提供了一些實用函數,用於URL處理與解析。本文將詳細介紹nodeJS中的URLhtml

 

URL對象

  解析 URL 對象有如下內容,依賴於他們是否在 URL 字符串裏存在。任何不在 URL 字符串裏的部分,都不會出如今解析對象裏node

'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'
┌─────────────────────────────────────────────────────────────────────────────┐
│                                    href                                     │
├──────────┬┬───────────┬─────────────────┬───────────────────────────┬───────┤
│ protocol ││   auth    │      host       │           path            │ hash  │
│          ││           ├──────────┬──────┼──────────┬────────────────┤       │
│          ││           │ hostname │ port │ pathname │     search     │       │
│          ││           │          │      │          ├─┬──────────────┤       │
│          ││           │          │      │          │ │    query     │       │
"  http:   // user:pass @ host.com : 8080   /p/a/t/h  ?  query=string   #hash "
│          ││           │          │      │          │ │              │       │
└──────────┴┴───────────┴──────────┴──────┴──────────┴─┴──────────────┴───────┘

  【href】: 準備解析的完整的 URL,包含協議和主機(小寫)mongodb

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

  【protocol】: 請求協議, 小寫瀏覽器

'http:'

  【slashes】: 協議要求的斜槓(冒號後)函數

truefalse

  【host】: 完整的 URL 小寫 主機部分,包含端口信息工具

'host.com:8080'

  【auth】: url 中的驗證信息ui

'user:pass'

  【hostname】: 域名中的小寫主機名url

'host.com'

  【port】: 主機的端口號spa

'8080'

  【pathname】: URL 中的路徑部分,在主機名後,查詢字符前,包含第一個斜槓code

'/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模塊包含分析和解析 URL 的工具。調用 require('url') 來訪問模塊

var url = require('url');
/*
{ parse: [Function: urlParse],
  resolve: [Function: urlResolve],
  resolveObject: [Function: urlResolveObject],
  format: [Function: urlFormat],
  Url: [Function: Url] }
 */
console.log(url);

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

  輸入 URL 字符串,返回一個對象

  第二個參數parseQueryString(默認爲false),如爲false,則urlObject.query爲未解析的字符串,好比author=%E5%B0%8F%E7%81%AB%E6%9F%B4,且對應的值不會decode;若是parseQueryString爲true,則urlObject.query爲object,好比{ author: '小火柴' },且值會被decode

  第三個參數slashesDenoteHos(默認爲false),若是爲true,能夠正確解析不帶協議頭的URL,相似//foo/bar裏的foo就會被認爲是hostname;若是爲false,則foo被認爲是pathname的一部分

var url = require('url');
var str = 'http://user:pass@host.com:8080/p/a/t/h?author=%E5%B0%8F%E7%81%AB%E6%9F%B4#hash';
/*
Url {
  protocol: 'http:',
  slashes: true,
  auth: 'user:pass',
  host: 'host.com:8080',
  port: '8080',
  hostname: 'host.com',
  hash: '#hash',
  search: '?author=%E5%B0%8F%E7%81%AB%E6%9F%B4',
  query: 'author=%E5%B0%8F%E7%81%AB%E6%9F%B4',
  pathname: '/p/a/t/h',
  path: '/p/a/t/h?author=%E5%B0%8F%E7%81%AB%E6%9F%B4',
  href: 'http://user:pass@host.com:8080/p/a/t/h?author=%E5%B0%8F%E7%81%AB%E6%9F%B4#hash' }
 */
console.log(url.parse(str));
var url = require('url');
var str = 'http://user:pass@host.com:8080/p/a/t/h?author=%E5%B0%8F%E7%81%AB%E6%9F%B4#hash';
/*
Url {
  protocol: 'http:',
  slashes: true,
  auth: 'user:pass',
  host: 'host.com:8080',
  port: '8080',
  hostname: 'host.com',
  hash: '#hash',
  search: '?author=%E5%B0%8F%E7%81%AB%E6%9F%B4',
  query: { author: '小火柴' },
  pathname: '/p/a/t/h',
  path: '/p/a/t/h?author=%E5%B0%8F%E7%81%AB%E6%9F%B4',
  href: 'http://user:pass@host.com:8080/p/a/t/h?author=%E5%B0%8F%E7%81%AB%E6%9F%B4#hash' }
  */
console.log(url.parse(str,true));
var url = require('url');
var str = '//foo/bar';
var result1 = url.parse(str,true);
var result2 = url.parse(str,true,true);
console.log(result1.path);//'//foo/bar'
console.log(result1.pathname);//'//foo/bar'
console.log(result1.hostname);//null
console.log(result2.path);//'/bar'
console.log(result2.pathname);//'/bar'
console.log(result2.hostname);//'foo'

【url.format(urlObject)】

  url.parse(str)的反向操做,輸入一個解析過的 URL 對象,返回格式化過的字符串

  urlObject包含了不少字段,好比protocol、slashes、protocol等,且不必定須要所有傳,因此有一套解析邏輯

  格式化的工做流程以下

href 會被忽略
protocol 不管是否有末尾的 : (冒號),會一樣的處理
http, https, ftp, gopher, file 協議會被添加後綴://
mailto, xmpp, aim, sftp, foo, 等協議添加後綴:
slashes 若是協議須要 ://,設置爲 true
僅需對以前列出的沒有斜槓的協議,好比議 mongodb://localhost:8000/
auth 若是出現將會使用.
hostname 僅在缺乏 host 時使用
port 僅在缺乏 host 時使用
host 用來替換 hostname 和 port
pathname 不管結尾是否有 / 將會一樣處理
search 將會替代 query屬性
不管前面是否有 / 將會一樣處理
query (對象; 參見 querystring) 若是沒有 search,將會使用
hash 不管前面是否有#,都會一樣處理
var url = require('url');
var obj = {
  protocol: 'http:',
  auth: 'user:pass',
  host: 'host.com:8080',
  hash: '#hash',
  query: { author: '小火柴' }
}
//http://user:pass@host.com:8080?author=%E5%B0%8F%E7%81%AB%E6%9F%B4#hash
console.log(url.format(obj));

【url.resolve(from, to)】

  url.resolve()方法以一種瀏覽器解析超連接的方式把一個目標URL解析成相對於一個基礎URL,參數以下

from <String> 解析時相對的基本 URL。
to <String> 要解析的超連接 URL。
var url = require('url');
console.log(url.resolve('/one/two/three', 'four'));         // '/one/two/four'
console.log(url.resolve('http://example.com/', '/one'));    // 'http://example.com/one'
console.log(url.resolve('http://example.com/one', '/two')); // 'http://example.com/two'
相關文章
相關標籤/搜索