JavaScript 提供了三個編碼 URL 的函式,看似相似,實際行為差異不小,用錯會直接導致參數解析失敗。
以 ISO Latin 字元集進行編碼。所有空白、標點、特殊符號與非 ASCII 字元都會轉為 %xx 形式,xx 是該字元在編碼表中的十六進位序號,例如空格對應 %20。
不會被編碼的字元:@ * / +
這個函式並未針對 URI 結構設計,且無法正確處理非 Latin 字元集,官方早已標記為 deprecated,不建議在新專案中使用。
把 URI 字串以 UTF-8 編碼為 escape 風格的表示法。它假定傳入的是一整個完整的 URI,因此會保留 URI 的結構性字元。
不會被編碼的字元:! @ # $ & * ( ) = : / ; ? + '
同樣以 UTF-8 編碼,但編碼範圍更嚴格,連 / 都會被編碼。
不會被編碼的字元:! * ( ) '
正因為 / 會被處理掉,如果字串本身包含 URI 的各段結構,就不能用這個函式編碼,否則 URL 會失效。
encodeURI()。encodeURIComponent(),這是最常見的場合。escape();但頁面為 GB2312 而接收端為 UTF-8 時,就必須用 encodeURI 或 encodeURIComponent。版本方面,escape() 自 JavaScript 1.0 即存在,而 encodeURI 與 encodeURIComponent 是 1.5 之後才引入的。今天的作法是統一使用 encodeURIComponent(),並在伺服器端以 UTF-8 處理,避開 legacy 編碼帶來的跨頁編碼不一致問題。
對應的解碼函式分別是 unescape()、decodeURI() 與 decodeURIComponent(),其中 decodeURIComponent() 遇到格式錯誤的編碼字串時會拋出 URIError,呼叫時建議包在 try-catch 中。