Cookie 看起來簡單,細節卻不少:讀取要自己解析字串、寫入靠賦值、還有路徑、網域、過期、加密與隱私等一連串屬性。這篇把常用操作與容易踩到的地方一次講清楚。
alert(document.cookie);
一個網站的 cookie 字串包含該網域下所有 JavaScript 可讀的 cookie(不含 HttpOnly 的),多筆之間以「分號加一個空格」分隔,例如:
document.cookie = "key1=value1; key2=value2"
單一 cookie 最長約 4KB,數量上限依瀏覽器而異(常見為 20 或 50 筆)。超出限制時會回傳空值,且舊有的 cookie 可能被淘汰——規範上該淘汰「最近最少使用」的,但瀏覽器的實作並不完全遵循。
document.cookie = "key=value;expires=date;path=/;domain=xxx.com;secure";
要寫多筆,重複賦值即可,瀏覽器會自動把它併進同一個 cookie 字串。反過來說,讀取某個特定 cookie 時沒有 API 可用,只能自己解析字串,用 split('; ') 再切開等號是最常見的做法。
1. 名稱與值。key 是 cookie 名,value 是內容。
2. 過期時間 expires。需為 GMT 字串格式:
expires = new Date('2011-12-30').toUTCString();
// "Fri, 30 Dec 2011 00:00:00 GMT"
若不設定過期時間,就是所謂的 session cookie,瀏覽器關閉即失效。現代寫法建議用 max-age(秒數),比絕對時間直覺。
3. 所屬路徑 path。預設情況下,某頁設定的 cookie 只能被同資料夾及其子資料夾的頁面讀取——例如 https://www.jb51.net/aa/1.html 設的 cookie,https://www.jb51.net/bb/2.html 讀不到。設 path=/ 代表屬於網站根目錄,全站皆可存取。
4. 所屬網域 domain。cookie 無法跨網域讀取。若要在多個子站間共享,這些站必須屬於同一主網域,例如讓 www.jb51.net 與 bbs.jb51.net 共享時,設 domain=jb51.net。
5. 加密傳輸 secure。帶此屬性的 cookie 只會透過 HTTPS 傳送。
cookie 值不能含有空白、分號、逗號等字元,若可能出現,寫入前用 encodeURIComponent() 編碼,讀取時再用 decodeURIComponent() 還原:
document.cookie = "key=" + encodeURIComponent(value);
基於安全,有些 cookie 不希望被前端腳本碰到,這時有兩個屬性:
以 PHP 的內建 setcookie() 為例:
setcookie("UserIDCookie", "123456", time() + 60 * 30, '/', 'mytest.com', false, true);
第六個參數表示是否僅供 HTTPS 使用,第七個參數 true 表示設為 HttpOnly。
在瀏覽器的隱私設定(Chrome 位於「進階設定 → 內容設定」)中禁用第三方 cookie 時,跨域請求(包含 iframe、img、外部 script 等)不會帶上屬於該域的 cookie。
舉例來說,用 iframe 嵌入一個跨域頁面 https://www.jb51.net/index.html,即使瀏覽器裡存有名為 otherLoginFrag 的 cookie 屬於 other.com,iframe 發請求時它不會被送到 www.other.com 的伺服器。
各家瀏覽器對第三方 cookie 的判定略有差異。例如 Safari 在禁用第三方 cookie 時,from 表單也只有 POST 才會送出 cookie。
若希望在禁用第三方 cookie 的情況下仍能跨域攜帶 cookie,傳統做法是在跨域伺服器回應一個 P3P 標頭,預先聲明允許:
// php
header('P3P: CP="CURa ADMa DEVa PSAo PSDo OUR BUS UNI PUR INT DEM STA PRE COM NAV OTC NOI DSP COR"');
setcookie("UserIDCookie", "123456");
最後補一個觀念上的區分:Secure 管的是「傳輸管道是否加密」,HttpOnly 管的是「前端腳本能不能讀」,兩者互不替代,敏感憑證應該同時開啟。而 P3P 早已被主流瀏覽器揚棄,今天若遇到第三方 cookie 被阻擋,正解是改用 SameSite=None; Secure 搭配 HTTPS,或乾脆把資料往第一方情境擺。