處理 URL 參數、中文文件名稱或特殊字元時,編碼函式的選擇直接決定請求會不會出錯。以下把四組 encode/decode 函式的行為與界線說清楚。
語法:encodeURIComponent(encodedURIString)
把字串編碼為 URI 的「單一元件」。編碼結果交給 decodeURIComponent 即可還原。關鍵特性是它會編碼所有字元,包括斜線:若傳入 /folder1/folder2/default.html,斜線會被編碼,結果直接丟給伺服器就是無效路徑。因此字串含多個路徑層級時,請改用 encodeURI。
語法:encodeURI(URIString)(IE 5.5 起支援)
回傳編碼後的完整 URI,但不編碼 :、/、;、? 這四個字元——它們正是 URI 的結構性分隔符號。需要編碼這些字元時,請用 encodeURIComponent。decodeURI 是其反操作,用來取代已過時的 unescape;若傳入的 URIString 不合法,會丟出 URIError。
語法:escape(charString)
回傳可在各種電腦上讀取的編碼字串:所有空格、標點、重音符號與非 ASCII 字元會被 %xx 取代(xx 為該字元的十六進位碼),例如空格編碼後是 %20;碼位大於 255 的字元則以 %uxxxx 形式儲存。
注意:escape 不能用來編碼 URI,該工作請交給 encodeURI 與 encodeURIComponent。unescape 則是把 %xx 或 %uxxxx 還原成原字元,同樣不應用於解碼 URI。
&、=、中文)→ encodeURIComponentencodeURIescape / unescape → 僅在維護舊程式時遇到,新碼請勿使用更完整的清單可對照 JavaScript 全域物件參考手冊。