把中文或特殊符號放進網址時,常會看到一堆 %XX 形式的編碼。這不是錯誤,而是 URL 必須以 ASCII 傳輸的結果。JavaScript 提供了 encodeURI() 與 decodeURI() 來做這層轉換,這篇用一個小範例把兩者跑起來。

<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>使用系統函式</title>
<script language="JavaScript">
function showMsg() {
var strURL = url.value;
var encodeStr = encodeURI(strURL);
var temp = encodeStr + "\n";
temp += decodeURI(encodeStr);
alert(temp);
}
</script>
</head>
<body>
<div>
請輸入一個 URL:
<input name="url" type="text" id="url"
value="/search.php?keyword=關鍵字" size="60" />
<input type="submit" name="button" id="button" value="我要提交" onclick="showMsg();" />
</div>
<h2>使用 encodeURI() 與 decodeURI() 函式:</h2>
</body>
</html>
這是最容易搞混的一點。encodeURI() designed 用來編碼「整個 URL」,它會保留 URL 中具有結構意義的字元,例如 ?、&、=、/、:,因此適合處理完整網址。而 encodeURIComponent() 會把這些一併編碼,適合處理「要放進參數位置的單一值」。
encodeURI("https://a.com/s?q=中文");
// https://a.com/s?q=%E4%B8%AD%E6%96%87
encodeURIComponent("a=b&c");
// a%3Db%26c
所以組 query string 時,正確寫法是:
var params = new URLSearchParams();
params.append('keyword', '中文 字');
var url = '/search.php?' + params.toString();
更現代的選擇是直接用 URL 與 URLSearchParams,它們會自動處理編碼,不必自己記得呼叫哪個函式。
escape() / unescape() 是歷史遺物,对非 ASCII 字元採用的是非標準的 %uXXXX 格式,請一律不要用。encodeURI 系列才是標準。另外要注意,decodeURI() 遇到格式錯誤的輸入會丟出 URIError,處理外部傳入的不確定資料時記得包上 try/catch。