要把一個網址當成另一個網址的查詢參數,必須先編碼,否則其中的 ?、&、= 會被解析成外層網址自己的語法,導致參數被切錯。
var myUrl = 'https://www.baidu.com'; var myOtherUrl = "https://www.example.com/index.html?url=" + encodeURIComponent(myUrl);
兩者差別在於「保留哪些字元不編碼」。encodeURI 假定你編碼的是一整個完整的 URL,因此會保留 ; , / ? : @ & = + $ # 這些在 URL 結構中有意義的字元。
encodeURIComponent 則假定你編碼的是「URL 的某個零件」,除了字母、數字和 - _ . ! ~ * ' ( ) 之外全部編碼。
結論很清楚:要編碼整個 URL 用 encodeURI;要把字串放進某個參數值裡用 encodeURIComponent。上例屬於後者,所以必須用 encodeURIComponent。若誤用 encodeURI,參數中的 & 不會被編碼,伺服器會把它當成外層的分隔符號,參數就斷成兩截了。
var params = new URLSearchParams(window.location.search);
var target = params.get('url'); // URLSearchParams 會自動解碼
若手動解析,記得對取出的值呼叫 decodeURIComponent。
最後提醒兩點:ES2015 之後新增的 encodeURI 系列不會編碼 '、(、)、!、*、~,若你的參數要放進 HTML 屬性裡,仍須留意引號轉義的問題;另外,中文或 emoji 在編碼後字串會變長(UTF-8 下每字 3~4 位),若 URL 可能很長,改用 POST body 傳遞會更合適。