DIV CSS 佈局教程網

網址參數編碼:escape 為什麼不該再用,encodeURIComponent 才是正解
編輯:關於JavaScript     

把字串放進網址前必須先編碼,否則 &、=、+ 這些字元會被當成參數分隔符而讓資料錯位。這份老程式碼示範了如何用 escape() 加上一連串 replace 補洞:

原始寫法

function URLencode(sStr) {
    return escape(sStr)
        .replace(/\+/g, '%2B')
        .replace(/\"/g,  '%22')
        .replace(/\'/g,  '%27')
        .replace(/\//g,  '%2F');
}

為什麼要補這些洞

escape() 是 1996 年的產物,早已被標準揚棄。它的問題是不會編碼 +、/、@ 等對網址有語意的字元,而且不支援非 ASCII 字元(中文會被編成 %uXXXX 這種非標準格式,伺服器無法解碼)。原範例的三個 replace 正是在手動補這些漏洞——但顯然補不完。

正確做法

// 編碼單一參數值
var v = encodeURIComponent("a&b=c 中文");
// "a%26b%3Dc%20%E4%B8%AD%E6%96%87"

encodeURIComponent 會把 & = ? / : # + 等全部轉成百分號編碼,並以 UTF-8 處理中文,這正是參數值需要的行为。

組裝查詢字串

var params = new URLSearchParams();
params.append('keyword', '中文 測試');
params.append('page', '2');
params.append('tag', 'a&b');

var url = '/search?' + params.toString();
// /search?keyword=%E4%B8%AD%E6%96%87+%E6%B8%AC%E8%A9%A6&page=2&tag=a%26b

更簡潔的寫法:

var url = new URL('/search', location.origin);
url.searchParams.set('keyword', '中文 測試');
url.searchParams.set('page', 2);
location.href = url.href;

用 URLSearchParams 的好處是:編碼、以 & 串接、處理重複鍵、解碼回讀全都自動完成,不必自己拼字串。

encodeURI 與 encodeURIComponent 該用哪個

  • encodeURIComponent:編碼單一參數值。& = / ? 都會被編碼。
  • encodeURI:編碼一整個 URL。它會保留 / ? & = # 等結構字元,只用來處理中文與空白,例如 encodeURI('/a b/中') → /a%20b/%E4%B8%AD。

把整段 URL 丟給 encodeURIComponent 會把結構字元也編掉,導致連結失效——這是最常見的誤用。

解碼端

decodeURIComponent("a%26b");       // "a&b"
// 讀取目前網址的參數
new URLSearchParams(location.search).get('keyword');

請勿使用 unescape(),它與 escape() 是一組的,同樣已不合標準。

一個實務提醒

若參數值可能含 +,要留意伺服器端的解讀規則:查詢字串裡的 + 傳統上代表空白,而 URLSearchParams.toString() 會把空白編碼成 +。若後端把 + 當字面字元處理,就會出現「空白變加號」的經典 bug。此時改用 encodeURIComponent(它會編成 %20)反而更安全。

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