在 JavaScript 中,encodeURI 與 encodeURIComponent 都可用來對 URI 進行編碼,將參數中的中文、日文、空白等非 ASCII 字元轉換成可安全傳輸的 UTF-8 編碼格式。當我們進行頁面跳轉、AJAX 請求或 URL 參數傳遞時,這些函式經常被使用。
encodeURI 適合對完整的 URI 進行編碼,它不會編碼 URL 中具有結構意義的字元,例如:
! # $ & ' ( ) * + , - . / : ; = ? @ _ ~ 0-9 a-z A-Z
而 encodeURIComponent 更適合用來編碼 URI 的某個元件,例如查詢字串中的單一參數值。它會編碼更多字元,只保留較少的標點符號:
! ' ( ) * - . _ ~ 0-9 a-z A-Z
如果 URL 只使用 encodeURI 編碼,當參數值包含特殊字元時,可能會出現非預期的結果。例如想傳遞的搜尋關鍵字是:
searchWord = a+b
但在某些情況下,加號可能被解讀為空白,導致最後變成:
a b
解決方式之一是改用 POST 提交,並將參數以物件形式傳入;或者對每個參數值使用 encodeURIComponent 進行編碼。
encodeURI 不會對 ASCII 字母、數字以及部分標點符號進行編碼,例如:
- _ . ! ~ * ' ( )
它的目的在於保留完整 URI 的結構,因此以下具有特殊意義的字元通常不會被轉義:
; / ? : @ & = + $ , #
範例:
document.write(encodeURI("https://www.w3school.com.cn") + "<br />");
document.write(encodeURI("https://www.w3school.com.cn/My first/") + "<br />");
document.write(encodeURI(",/? :@&=+$#"));
輸出結果會類似:
https://www.w3school.com.cn https://www.w3school.com.cn/My%20first/ ,/? :@&=+$#
若要解碼 encodeURI 編碼過的 URI,可使用 decodeURI()。
encodeURIComponent 假設參數是 URI 的一部分,例如協議、主機名稱、路徑或查詢字串中的單一值。因此它會將分隔 URI 元件的標點符號也一併編碼。
範例:
document.write(encodeURIComponent("https://www.w3school.com.cn") + "<br />");
document.write(encodeURIComponent("https://www.w3school.com.cn/p 1/") + "<br />");
document.write(encodeURIComponent(",/? :@&=+$#"));
輸出結果會類似:
http%3A%2F%2Fwww.w3school.com.cn http%3A%2F%2Fwww.w3school.com.cn%2Fp%201%2F %2C%2F%3F%3A%40%26%3D%2B%24%23
若要解碼 encodeURIComponent 編碼過的內容,可使用 decodeURIComponent()。
如果是在處理完整網址,通常使用 encodeURI;如果是在處理查詢字串中的單一參數值,尤其是包含 &、=、?、# 等特殊字元的內容,建議使用 encodeURIComponent,以避免參數結構被破壞。