詳解nodeJS中的URL

前面的話

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

 

URL物件

　　解析 URL 物件有以下內容，依賴他們是否在 URL 字串裡存在。任何不在URL 字串裡的部分，都不會出現在解析物件裡

'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，包含協議和主機（小寫）

'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】: 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);//nullconsole.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#hashconsole.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'

 

以上是詳解nodeJS中的URL的詳細內容。更多資訊請關注PHP中文網其他相關文章！