URL 即統一資源定位符,是 URI 的一種。由於有效的 URI 不能包含某些字元(例如空格),若不經過編碼,瀏覽器就無法正確存取資源。
JavaScript 的 Global 物件提供了 encodeURI / decodeURI 與 encodeURIComponent / decodeURIComponent,而 BOM 另外提供了 escape / unescape。
實務上優先選用 URI 系列,因為它會對所有 Unicode 符號編碼;escape 與 unescape 只處理 ASCII 符號,如今已被視為不建議使用(不過它確實常被拿來做簡單的資料加密/解密)。每組內的兩個函式互为反操作。
encodeURI 處理完整的 URI,除了 ! # ¥ & ' ( ) × + , - . / : ; = ? @ _ ~ 與 0-9、a-z、A-Z(共 82 個字元)以外都會編碼。encodeURIComponent 處理 URI 片段,只保留 ! ' ( ) * - . _ ~ 與英數(共 71 個字元)。escape 只保留 * + - . / @ _ 與英數(共 61 個字元)。差別最明顯的是 encodeURI 保留 /、?、#、& 這些結構性字元,而 encodeURIComponent 會把它們編碼掉。因此拼接查詢參數時該用後者,編碼整條網址時才用前者。
請求伺服器(64 位元作業系統)上一個檔名含 + 的檔案時,不論用 encodeURI、decodeURIComponent 還是 escape,都會提示資源不存在:
url = "https://192.168.6.135/nas135/MyDocument/1+2.txt"; window.open(EncodeURI(url), "", "", "");
中斷觀察可以看到 EncodeURI(url) 的結果是 https://192.168.6.135/nas135/MyDocument/1%2b2.txt,但伺服器端就是打不開。
這裡有個關鍵細節值得注意:在 URL 的查詢字串(query string)中,+ 被約定俗成地代表空格,這也是 application/x-www-form-urlencoded 的規則。雖然路徑部分(path)理論上不該有這個問題,但部分伺服器與中介軟體會一律解讀 +,導致 1+2.txt 被還原成 1 2.txt 而找不到檔案。編碼後的 %2B 是否又被某層元件二次解碼,也值得從伺服器日誌與實際請求標頭去確認,而不僅僅歸因於 64 位元環境。