DIV CSS 佈局教程網

網址參數值含 & 就被截斷?encodeURIComponent 才是正解
編輯:關於JavaScript     

做公告瀏覽功能時遇到一個惱人的現象:只要用 URL 傳的參數值裡含有 & 或空白,該變數的值就永遠顯示不出來。

問題成因

URL 的 query string 以 & 作為參數分隔符號。當你寫出 page.jsp?para1=a&b,伺服器解析時會把它當成兩個參數:para1 = a,以及 b(沒有值)。para1 拿到的自然是 "a",後半段直接丟失——這不是 bug,而是 URL 規格的正常行為。

曾經流傳的解法:手動替換

Java 端可以先編碼看看 & 會變成什麼:

String charEncode = java.net.URLEncoder.encode("&");
System.out.println("字符& 轉譯後的值為:" + charEncode);   // 輸出:%26

於是有人得到結論:傳送前把 & 全部換成 %26。

var url = "page.jsp?para1=a&b";     // 錯誤
var url = "page.jsp?para1=a%26b";    // 勉強可用

這在只有 & 需要處理時確實有效,但遇到 =、?、#、空白、中文、+ 時又會出問題,等於要自己維護一張對照表。

正解:用 encodeURIComponen

encodeURIComponent() 會把 &、=、?、#、+、空白等所有會干擾解析的字元一併編碼,這才是 URL 參數該做的事:

var params = {
  para1: 'a&b',
  title: '公告 內容 & 說明',
  q: '100=200'
};

var query = Object.keys(params)
  .map(function (k) {
    return encodeURIComponent(k) + '=' + encodeURIComponent(params[k]);
  })
  .join('&');

var url = 'page.jsp?' + query;
// page.jsp?para1=a%26b&title=...%26...&q=100%3D200

後端(Java 的 request.getParameter)會自動解回原值,不必做任何處理。

前端解析 URL 參數

反向操作也不用手寫:

var search = new URLSearchParams(location.search);
console.log(search.get('para1'));      // 自動解碼後的值

// 相容舊瀏覽器的手寫版
function getParam(name) {
  var m = new RegExp('[?&]' + name + '=([^&]*)').exec(location.search);
  return m ? decodeURIComponent(m[1].replace(/\+/g, ' ')) : '';
}

三個容易忽略的細節

1. encodeURI 與 encodeURIComponent 不要混用。encodeURI 會保留 ;,/?:@&=+$# 這些字元不動,因此不能用來編碼參數值。參數值一律用 encodeURIComponent。

2. 空格的兩種編碼。表單傳統上用 + 代表空格(application/x-www-form-urlencoded),而 encodeURIComponent 會編成 %20。兩者在 query string 中大多相容,但解析時最好把 + 還原成空白,如上例所示。

3. 中文與特殊字元務必編碼。不編碼的中文在不同伺服器與代理的處理下可能變成亂碼,這是「本機測試正常、上線就出錯」的常見原因之一。

最後補一句:參數值若含敏感資訊,即使編碼過也仍會出現在伺服器 log、瀏覽器歷史與 Referer 標頭中,這類資料請改用 POST body 傳送。

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