DIV CSS 佈局教程網

encodeURI 與 encodeURIComponent 的差別與使用時機
編輯:關於JavaScript     

為什麼需要 URI 編碼

在 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 用法

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 用法

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,以避免參數結構被破壞。

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