定義:escape() 會對字串進行編碼,使其能在所有電腦上正確讀取。參數 string 為必要,代表要被轉義的字串;回傳值是已編碼的字串副本,其中部分字元被替換成十六進位轉義序列。
說明:它不會編碼 ASCII 字母與數字,也不會編碼 * @ - _ + . / 這些標點;其餘字元都會被轉義序列取代。若要解碼,可使用 unescape()。
注意:ECMAScript v3 已不建議使用 escape,應改用 encodeURI 與 encodeURIComponent。
定義:encodeURI() 會把字串當成完整的 URI 來編碼。
encodeURI(URIstring)
參數 URIstring 為必要,是一個含有 URI 或需編碼文字的字串;回傳值是其中的部分字元被十六進位轉義序列替換後的副本。
說明:它不編碼 ASCII 字母與數字,也不編碼 - _ . ! ~ * ' ( ) 這些標點。由於它的目的是編碼「完整的 URI」,因此對 ; / ? : @ & = + $ , # 這類在 URI 中具有特殊意義的字元也一律保留不轉義。
提示:可用 decodeURI() 解碼。若 URI 元件中含有 ? 或 # 這類分隔符,應改用 encodeURIComponent() 分別編碼各元件。
定義:encodeURIComponent() 會把字串當成 URI 的「一個元件」來編碼。
encodeURIComponent(URIstring)
參數同樣是 URIstring,回傳值也是部分字元被轉義後的副本。
說明:它不編碼 ASCII 字母、數字與 - _ . ! ~ * ' ( );而其他字元——包含用於分隔 URI 各元件的 ; / ? : @ & = + $ , # ——都會被一個或多個十六進位轉義序列取代。
關鍵差異:encodeURIComponent() 假定參數只是 URI 的一部分(例如協議、主機名稱、路徑或查詢字串),因此它會連分隔符一起轉義;encodeURI() 則假定參數是完整 URI,會保留分隔符。選擇哪一個,取決於你編碼的是「整個網址」還是「網址中的某一小塊」。
舉例來說,組裝查詢字串時必須用 encodeURIComponent,否則值裡的 & 與 = 會破壞參數結構:
var url = "https://example.com/search?q=" +
encodeURIComponent("javascript 教學 & 範例");
反過來,若要處理一個已經完整的外部連結、又不希望它的參數被破壞,就該用 encodeURI。