以下逐一說明 escape、encodeURI、encodeURIComponent、unescape、decodeURI、decodeURIComponent 這組編碼與解碼方法的用途與行為,方便對照選用。
回傳一個可在所有電腦上讀取的編一字串物件。
function escape(charString : String) : String
參數:charString(必選),要編碼的任何 String 物件或文字。
說明:escape 回傳一個包含 charstring 內容的字串值(Unicode 格式)。所有空格、標點、重音符號以及其他非 ASCII 字符,都以 %xx 編碼替換,其中 xx 是該字符的 16 進位數,例如空格回傳 "%20"。字符值大於 255 的字符則以 %uxxxx 格式儲存。
注意:escape 不能用來對 URI 編碼,對 URI 編碼應改用 encodeURI 與 encodeURIComponent。(版本 1)
回傳編碼為有效 URI 的字串。
function encodeURI(URIString : String) : String
參數:URIString(必選),表示要編碼的 URI 字串。
說明:回傳一個已編碼的 URI;若把結果交給 decodeURI,會還原成初始字串。encodeURI 不編碼「:」「/」「;」「?」,若要編碼這些字符請用 encodeURIComponent。(版本 5.5)
回傳編碼為有效 URI 元件的字串。
function encodeURIComponent(encodedURIString : String) : String
參數:encodedURIString(必選),表示要編碼的 URI 元件字串。
說明:回傳一個已編碼的 URI;交給 decodeURIComponent 可還原。由於它會編碼所有字符,若字串代表一個路徑(如 /folder1/folder2/default.html),其中的斜槓也會被編碼,導致作為請求送到 Web 伺服器時失效。若字串含多個 URI 元件,請改用 encodeURI。(版本 5.5)
從 escape 編碼過的字串中還原字串。
function unescape(charString : String) : String
說明:回傳一個字串值,所有以 %xx 十六進位編碼的字符,都以 ASCII 字符集中等效的字符取代;以 %uxxxx 格式編碼的字符,則以對應的 Unicode 字符取代。注意 unescape 不應用於解碼 URI,請改用 decodeURI 與 decodeURIComponent。(版本 1)
回傳一個已編碼 URI 的非編碼形式。
function decodeURI(URIstring : String) : String
說明:建議用 decodeURI 取代已過時的 unescape。若 URIString 無效,將發生 URIError。(版本 5.5)
回傳一個已編碼 URI 元件的非編碼形式。
function decodeURIComponent(encodedURIString : String) : String
說明:encodedURIString 是表示已編碼 URI 元件的值。若該值無效,將產生 URIError。(版本 5.5)
整體來說,編碼用 encode 系列、解碼用 decode 系列,而 escape/unescape 則是較早期的、不建議用於 URI 的 pair。選對方法,才能確保資料的正確傳遞與還原。