用 form 表單送出資料時,空格會自動被編碼成加號;但若我們用 JavaScript 自己組字串,就必須手動處理這個轉換,否則後端收到的內容會與原意不符。
jQuery 的 serialize 模組中定義了一個 r20 正則:
var r20 = /%20/g,
而 jQuery.param 方法會把所有的 "%20" 轉成 "+"。也就是說,在送出資料之前,內容中若含有空格,經過 encodeURIComponent 之後會先變成 %20:
encodeURIComponent(' ') === '%20'; // true
接著還必須把 %20 再轉換成 + 然後 POST 送出,後端程式接收到的才是真正的空格。
根據 MDN 的說明:
encodeURIComponent escapes all characters except the following: alphabetic, decimal digits, - _ . ! ~ * ' ( )
也就是說,除了英文字母、數字與 - _ . ! ~ * ' ( ) 這幾個字元之外,其餘一律會被轉成百分號編碼。
MDN 特別提醒,凡是使用者輸入、且會作為 URI 一部分傳送的參數,都應該先經過 encodeURIComponent 處理。舉例來說,使用者若在 comment 欄位輸入 Thyme &time=again,若不編碼,結果會變成 comment=Thyme%20&time=again。由於 & 與 = 是分隔鍵值對的符號,後端最後會解讀出兩個參數——一個是 comment="Thyme ",另一個是 time="again",完全不是原本的意圖。
而針對 application/x-www-form-urlencoded(也就是 POST)這種內容類型,W3C 的規範要求空格必須被替換成 +。因此實務上的做法是:在 encodeURIComponent 之後,再追加一次把 %20 換成 + 的替換。
這件事本質上是兩套規則的疊加:encodeURIComponent 依循的是通用 URI 的百分號編碼,而表單提交依循的是 x-www-form-urlencoded 的規則,兩者對空格的表示方式不同。理解這個差異後,就知道為什麼自己手寫 query string 時特別容易出問題——少了那道轉換,後端收到的就是字面意義上的 %20 而非空格。
當然,最保險的做法還是用 URLSearchParams 或 jQuery 的 $.param() 來組字串,讓標準函式庫替你處理這些細節。
https://developer.mozilla.org/en-US/docs/JavaScript/Reference/Global_Objects/encodeURIComponent
https://www.w3.org/TR/html401/interact/forms.html#form-content-type