DIV CSS 佈局教程網

JavaScript 解析網址:自製 parseUrl 函數一次取出主機、路徑與查詢參數
編輯:關於JavaScript     

做前端或 Node 服務時,經常會拿到一整串網址,卻只想知道其中的某一部分:主機名稱是什麼?帶了哪些查詢參數?錨點指向哪裡?雖然今日的瀏覽器已經提供 URL 與 URLSearchParams 這類標準 API,但在不支援它們的環境,或只是想在既有專案裡快速拆一份網址,還有一個流傳已久的巧妙做法:建立一個 <a> 元素,把網址塞進它的 href,再讀取這個元素上的各項屬性。

原理很單純。瀏覽器在解析 href 時,用的是與解析 location 完全相同的規則,因此協定、主機、連接埠、路徑、查詢字串、片段識別碼都會被自動拆好放進對應屬性;我們要做的只是把它們重新組裝成一個方便取用的物件。

函數實作

function parseURL(url) {
  var a = document.createElement('a');
  a.href = url;
  return {
    source: url,
    protocol: a.protocol.replace(':', ''),
    host: a.hostname,
    port: a.port,
    query: a.search,
    params: (function () {
      var ret = {},
        seg = a.search.replace(/^\?/, '').split('&'),
        len = seg.length,
        i = 0,
        s;
      for (; i < len; i++) {
        if (!seg[i]) { continue; }
        s = seg[i].split('=');
        ret[s[0]] = s[1];
      }
      return ret;
    })(),
    file: (a.pathname.match(/\/([^\/?#]+)$/i) || [, ''])[1],
    hash: a.hash.replace('#', ''),
    path: a.pathname.replace(/^([^\/])/, '/$1'),
    relative: (a.href.match(/tps?:\/\/[^\/]+(.+)/) || [, ''])[1],
    segments: a.pathname.replace(/^\//, '').split('/')
  };
}

使用方式與回傳結果

var myURL = parseURL('https://abc.com:8080/dir/index.html?id=255&m=hello#top');

myURL.file;      // 'index.html'
myURL.hash;      // 'top'
myURL.host;      // 'abc.com'
myURL.port;      // '8080'
myURL.protocol;  // 'http'
myURL.query;     // '?id=255&m=hello'
myURL.params;    // { id: '255', m: 'hello' }
myURL.path;      // '/dir/index.html'
myURL.relative;  // '/dir/index.html?id=255&m=hello#top'
myURL.segments;  // ['dir', 'index.html']
myURL.source;    // 傳入的原始網址

各欄位的意義

source 是最初傳進來的字串,方便你在需要時回頭比對;protocol 已去掉尾端的冒號;host 只取主機名稱,不含連接埠;query 保留完整的查詢字串(含問號);params 則是把查詢字串拆成鍵值對的物件;file 是路徑中最後一段檔名;segments 把路徑按斜線切成陣列,很適合拿來做麵包屑或路由比對;relative 則是去掉「協定+主機」之後剩下的相對部分。

幾個必須留意的細節

第一,params 內的值並沒有經過 decodeURIComponent,若參數值可能包含中文或特殊字元,記得自行解碼。第二,當同一個鍵出現多次(例如 ?id=1&id=2),後者會直接覆蓋前者,不會形成陣列。第三,以問號或 & 開頭的空片段已被 if (!seg[i]) continue; 過濾掉,這一步在實務上很重要,否則會多出一個空字串鍵。第四,若網址本身缺少協定(例如只寫 abc.com/x.html),部分屬性會與預期不同,必要時先補上 https:// 再解析。

最後要提醒的是,這段程式屬於「在没有標準 API 可用時」的替代方案。若執行環境支援 URL,直接寫 new URL(url) 再取 .hostname、.searchParams.get('id') 會更短、更安全,也自動處理好解碼與重複參數的問題。理解 <a> 這個技巧的價值,在於明白瀏覽器解析網址的行為,而不是把它當成現代專案的正式解法。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved