一款適合初學者的 Cookie 轉 JSON 轉換器,會讀取 HTTP Cookie 請求標頭的確切文字內容——例如 SID=abc; lang=en-US 這類以分號加一個空格分隔的配對——並將其轉成扁平化的 JSON 物件,讓你可以直接讀取、排序、記錄與編輯其中的鍵與字串值,而不必手動剖析。它也能反向運作,接收一個已審核、值皆為字串的 JSON 物件,並重新產生乾淨的 Cookie: 請求值,讓你能在扁平的標頭行與結構化對應表之間轉換,而不會遺失任何一個合法字元的資料。整個轉換過程完全在你的瀏覽器分頁中進行,不會上傳任何東西、不會儲存任何東西,工具也絕不會讀取 document.cookie。對於剛接觸 HTTP 標頭的開發者來說,這是以結構化形式檢視 Cookie 欄位內容、複製到設定檔、與先前擷取的版本進行差異比對,或在編輯後重建內容的最快方式。

當你開始查看 HTTP 流量時,Cookie 欄位看似簡單,實則不然。它雖然只是一行文字,但這一行所遵循的規則比大多數人預期的更嚴格。一個多餘的空格、漏掉的分隔符號,或是一個經百分號編碼的斜線,都可能讓原本可用的標頭變成剖析器拒絕處理的內容。遵循嚴格 RFC 6265 請求規範的轉換器能消除這種猜測:它要不是完全照你所輸入的內容接收,要不就是精確指出你違反了哪一條規則。

cookie converter for beginners
初學者適用的 Cookie 轉換器:將 Cookie 轉為 JSON

瀏覽器只要與先前曾設定過一或多個 Cookie 的伺服器通訊,就會送出 Cookie 欄位。其值是由 ; 串接而成的 name=value 配對清單——一個分號後面接著剛好一個 ASCII 空格。每個名稱都是一個 RFC token,也就是由字母、數字與一小組標點符號組成;名稱中不允許出現空格與逗號。每個值則是一段未加引號、由合法 cookie octet 組成的序列,或是以雙引號包起來的相同序列。等號周圍的空格並非格式的一部分。多餘的尾端分號、空配對,或是漏掉的分隔空格,都會使這一行無效。

請求欄位「不」攜帶的資訊同樣重要。Cookie 標頭並不會揭露 Cookie 的到期時間、設定它的主機、繫結的路徑、是否僅限 Secure,或是 JavaScript 是否能讀取它。這些屬性——Domain、Path、Expires、Max-Age、Secure、HttpOnly、SameSite、Partitioned、Priority,以及任何擴充前綴——都屬於 Set-Cookie 回應標頭,絕不會出現在 Cookie 請求標頭中。由於初學者經常不慎貼上 Set-Cookie 行的內容,嚴格的轉換器會以明確的錯誤訊息拒絕這類輸入,而不是悄悄產生誤導性的 JSON。

標頭欄位方向是否攜帶 Domain、Path、Expires、Secure、HttpOnly 等屬性?Cookie 轉 JSON 轉換器是否處理?
Cookie用戶端到伺服器(請求)否——僅有 name=value 配對是
Set-Cookie伺服器到用戶端(回應)是——屬性由伺服器設定否,會以明確錯誤拒絕

為什麼本地轉換器優於複製貼上偵錯

當你從瀏覽器的 DevTools 複製 Cookie 欄位時,通常會看到像 SID=abc123; lang=en-US; cart=eyJ= 這樣的內容——沒有明顯結構的一整行。兩個配對時用肉眼讀還行,但當配對數量變成十個或二十個時就會很痛苦,而且在重新輸入時也容易打錯字。結構化的 JSON 檢視讓你能依字母順序瀏覽整個欄位、與先前擷取的版本進行差異比對,或在不需要處理引號的情況下,把單一值交給同事。

使用本地轉換器的另一個原因在於隱私。Cookie 標頭經常含有憑證,將其送往第三方服務是真實存在的風險。Cookie 轉 JSON 轉換器會在目前的瀏覽器分頁中處理你貼上的文字,且不會向任何網路回傳任何資料。輸出會出現在一個唯讀區域,你必須手動複製;剪貼簿的動作是非同步且受到保護的,如此一來,即使在你編輯輸入或切換方向之後,過期的權限提示也不會悄悄恢復「已複製」徽章。

第一個方向 Cookie → JSON,是大多數初學者最需要的方向。請依照下列步驟,使用 Cookie 轉 JSON 轉換器操作。

  1. 開啟工具,選擇 Cookie 轉 JSON 模式,然後貼上像 SID=abc; lang=en-US 這樣的純值,或是同一行加上 Cookie: 前綴(冒號後接一個空格)。為了方便起見,貼上內容外圍的空白會被忽略,這符合 RFC 6265 的規範。
  2. 按下 Convert。工具會以不分大小寫的方式驗證欄位名稱前綴、在每對的第一個 = 處分割、將每個名稱作為 RFC token 進行檢查,並依據 cookie-octet 規範驗證每個值。百分號序列不會進行 URL 解碼——%2F 會保持為 percent、two、F 三個字元——而第一個等號之後多出的等號仍會保留為值的一部分,因此 Base64 填補字符、簽章 token 與 URL 風格的查詢字串都能完整保留。
  3. 在唯讀輸出區域中閱讀 JSON 對應表。先核對配對數量與配對計數行,然後使用 Copy 將完整字串放入剪貼簿。如果輸入有任何格式錯誤,先前的結果會被移除,並由一則錯誤訊息取代;修正輸入後再試一次。

反向方向 JSON → Cookie,適用於當你已編輯過擷取下來的 JSON 對應表,需要重建標頭行以便在 curl、Postman 或測試框架中重送時使用。

  1. 將工具切換到 JSON 轉 Cookie。貼上正好一個非空白的 JSON 物件,其中每個屬性的值都是字串。數字、布林值、null、陣列、巢狀物件、註解與結尾逗號都會被拒絕。
  2. 轉換器會在序列化前先進行具重複偵知的詞法掃描,因此兩個解碼後對應到同一鍵的不同寫法——例如 a 與 \u0061——即便一般的 JSON.parse 只會靜默地保留其中一個,也會被攔截並回報為重複。名為 __proto__、prototype 或 constructor 的鍵會被拒絕,作為縱深防禦的一道邊界。
  3. 按下 Convert,然後檢視產生的 Cookie: 值。各配對會以精確的 ; 分隔符號連接,解碼後的值會重新依 cookie-values 規則驗證,JSON 文字中原本的鍵順序也會被保留。複製這一行並貼到你選擇的用戶端工具中。

嚴格剖析器會攔截的常見初學者錯誤

有幾種在文字編輯器中看似無害的格式,會被嚴格剖析器明確拒絕。等號周圍的空格,例如 SID = 123,會失敗,因為它破壞了配對的邊界。SID=123;;lang=en 會失敗,因為第二個分隔符號後面沒有值,而空配對是不合法的。Cookie : SID=123 會失敗,因為冒號必須緊貼欄位名稱,中間不能有空格。兩個具相同解碼名稱的配對,例如 SID=1; SID=2,會失敗,因為 JSON 物件無法在保留兩個同鍵成員的情況下不悄悄選出一個贏家,而本工具拒絕這樣做。貼上 Set-Cookie: 行同樣會失敗,因為本工具只處理請求標頭——Set-Cookie 行上的屬性屬於伺服器回應,而不是瀏覽器送回的內容。

這種嚴格是特色,而不是阻力。如果轉換器悄悄修剪空格、解碼百分號序列,或將兩個 SID= 配對合併成一個,你就會得到一個看似成功、但實際上與瀏覽器真正送出的內容不符的轉換結果。改為拒絕輸入會迫使你修正來源,最終得到的 JSON 也能保證往返轉換後回到完全相同的 Cookie 標頭行。

限制、大小預算,以及何時該選用其他工具

本轉換器將輸入上限設定為剛好 100,000 個 UTF-16 code unit,完整輸出上限則為剛好 200,000 個 code unit,只要超出任一邊界,下一個 unit 就會被拒絕。它不會使用 maxLength 悄悄停止你的輸入,也絕不會切割、取樣或部分傳回輸入內容。任何編輯動作或方向切換都會清除先前的輸出、錯誤、配對計數與剪貼簿狀態,確保你看到的結果與產生該結果的輸入保持完全同步。

當你想偵錯 Cookie 請求欄位、將擷取下來的字串對應表轉為 JSON,或從已審核的 JSON 字串重建請求標頭行時,本工具是正確的選擇。當你的需求是檢查 document.cookie、產生 Set-Cookie 回應、解碼應用程式的 session 格式、判斷 Cookie 是否為 Secure,或是在分享前清理憑證時,它就不是合適的工具——Cookie 標頭經常含有使用中的 session 密鑰,任何曾經外洩的值都應該進行輪換。若需處理一般性的 JSON 工作,JSON Formatter、JSON Validator 與 JSON Minifier 涵蓋了 Cookie 規範以外的各種情境。針對不相關的標記語言清理,則應使用 HTML Cleaner。

如果你正在權衡各種選項,避免常見的 JSON 差異比對錯誤:實用指南對此有詳細說明。

如果你正在權衡各種選項,如何在 Sublime Text 中格式化 JSON:外掛與延伸應用對此有詳細說明。