Cookie 幾乎是所有 Web 開發者都會碰到的技術,但真正把它用對、用安全的人並不多。本文從「Cookie 到底是什麼」講起,一路涵蓋基礎讀寫、有效期設定、路徑與網域隔離、安全性以及編碼細節,最後附上可直接複用的完整程式碼。
用最直白的話說:Cookie 是一段存放在使用者本機的小文字資料。當瀏覽器向同一個網站發出請求時,會自動把符合條件的 Cookie 一起送出去,伺服器就能藉此辨認「你是誰」。
在 JavaScript 的世界裡,Cookie 就是字串。你透過 document.cookie 這一個屬性來讀取與寫入它。值得一提的是,Cookie 並不是前端獨有的東西,PHP、Java、Node.js 等後端語言同樣能讀寫,本質上它就是 HTTP 標頭裡的一段資料。
單一 Cookie 的內容建議不超過 4KB。若字串過長,瀏覽器可能直接丟棄,讀取時就會拿到空字串。
Cookie 最終以檔案形式落地在本機,使用者打開開發者工具就能查看甚至竄改。這正是「不要把敏感資料、權限判斷放進 Cookie」的根本原因。
每一筆 Cookie 都是 名稱=值 的形式,名稱與值都必須是合法字元,多筆之間以分號與空格分隔。
不指定有效期的 Cookie 屬於「工作階段 Cookie」,瀏覽器一關就消失。若想讓它在關閉瀏覽器後仍然存在,必須明確設定過期時間。
這點很多人第一次都會誤會。alert(typeof document.cookie) 的結果是 string,所有「取值」都得靠字串處理技巧自己完成。
基於安全模型,不同網域之間預設無法互相讀取對方的 Cookie;同一網域下,Cookie 也只在建立它的目錄及其子目錄中可見。這兩個概念後面會展開說明。
兩種來源:一是目前網站本身設定的第一方 Cookie;二是網頁中嵌入的廣告、圖片來自其他網域所帶入的第三方 Cookie,後者常被用於跨站追蹤使用者行為。
兩種狀態:一種是臨時性的工作階段 Cookie,關閉瀏覽器即清除;另一種是設定了失效時間的持久 Cookie,例如「記住我的登入狀態」,可以在本機保留數天、數月甚至更久。
兩種清除方式:透過瀏覽器設定或外掛工具直接刪除,或由程式把過期時間設為一個已過去的那一刻,讓它自然失效。要注意的是,貿然刪除 Cookie 有可能讓某些依賴它的頁面行為異常。
此外,瀏覽器允許使用者自行封鎖 Cookie。基於效能與流量考量,實務上應該控制 Cookie 的數量與大小,能不用就不用。
還有一個容易踩到的環境問題:直接以 file:// 開啟本機頁面時,部分瀏覽器(例如 Chrome)的控制台無法正常用 JavaScript 讀寫 Cookie,改用本機伺服器或換個瀏覽器測試即可。
寫 Cookie 只需要對 document.cookie 賦值。名稱不存在就是新增,存在就是覆蓋:
document.cookie = 'username=Darren';
讀取沒有語法糖,本質上是字串切片。判斷存在、找起點、找終點、取出來:
function getCookie(c_name) {
if (document.cookie.length > 0) {
var c_start = document.cookie.indexOf(c_name + "=");
if (c_start != -1) {
c_start = c_start + c_name.length + 1; // 跳過名稱與 = 號
var c_end = document.cookie.indexOf(";", c_start);
if (c_end == -1) c_end = document.cookie.length; // 處理最後一筆
return unescape(document.cookie.substring(c_start, c_end));
}
}
return "";
}
除了這種字串寫法,也可以用陣列 split 或正則表達式來取值,邏輯一致,只是風格不同。
document.cookie = "name=value;expires=" + date;
其中 date 必須是 GMT 格式的字串,常見的「保留 30 天」寫法:
var _date = new Date(); _date.setDate(_date.getDate() + 30); _date.toGMTString();
封裝成函式會更實用:
function setCookie(c_name, value, expiredays) {
var exdate = new Date();
exdate.setDate(exdate.getDate() + expiredays);
document.cookie = c_name + "=" + escape(value) +
((expiredays == null) ? "" : ";expires=" + exdate.toGMTString());
}
// 用法:setCookie('username', 'Darren', 30)
若想以「小時」為單位,把時間運算換掉即可:
exdate.setHours(exdate.getHours() + expiredays);
反過來說,要讓 Cookie 立刻失效,只要把過期時間設為已經過去的一刻——這正是清除 Cookie 的程式化做法。
預設情況下,只有與建立 Cookie 的頁面位於同一目錄或其子目錄的頁面才讀得到它。例如在 /Darren_code/ 下建立的 Cookie,/Darren_code/archive/ 裡的頁面可以讀取,但根目錄或 /xxxx/ 下的頁面不行。
想放寬範圍,就明確指定路徑。最常見的做法是設為根目錄,讓全站都能共用:
document.cookie = "name=value;path=path"; document.cookie = "name=value;expires=date;path=path"; document.cookie = "name=Darren;path=/";
路徑解決同網域內的問題,domain 則處理跨子網域共用。例如 www.qq.com 與 sports.qq.com 同屬 qq.com,若希望前者讀到後者寫入的 Cookie:
document.cookie = "username=Darren;path=/;domain=qq.com";
關鍵限制:只能往「父網域」方向放寬,不能把 domain 設成毫不相干的網域。
Cookie 一般透過 HTTP 明文傳輸,路徑上很容易被側錄。加上 secure 標記後,它只會在 HTTPS 或其他安全協議下傳送:
document.cookie = "username=Darren;secure"
但務必理解它的邊界:secure 只保護「傳輸過程」,本機存檔的 Cookie 檔案並未加密。也就是說,真正重要的資料,從一開始就不該放進 Cookie。
Cookie 值不能包含空白、分號、逗號等特殊字元,而實務上又經常需要存這類內容。解法就是寫入前編碼、讀出後解碼:
document.cookie = name + "=" + escape(value); // 讀取時 return unescape(document.cookie.substring(c_start, c_end));
少了這一步,值裡只要出現分號就會直接破壞整筆 Cookie 的結構,這是初學者最常遇到的「詭異 bug」。
/* 設定 Cookie */
function setCookie(c_name, value, expiredays, path, domain, secure) {
var exdate = new Date();
exdate.setDate(exdate.getDate() + expiredays);
document.cookie = c_name + "=" + escape(value) +
((expiredays == null) ? "" : ";expires=" + exdate.toGMTString()) +
((path == null) ? '/' : ';path=' + path) +
((domain == null) ? '' : ';domain=' + domain) +
((secure == null) ? '' : ';secure=' + secure);
}
setCookie('test', 'name=sheng;sex=men;lancer=dullbear', 30);
/* 取得 Cookie,index 用於在多值中挑選第幾組 */
function getCookie(c_name, index) {
var cookies = document.cookie;
var cookieLen = cookies.length;
if (cookieLen > 0) {
var c_start = cookies.indexOf(c_name + '=');
if (c_start > -1) {
c_start += c_name.length + 1;
var c_end = cookies.indexOf(';', c_start);
if (c_end == -1) c_end = cookieLen;
var cookieStr = unescape(cookies.substring(c_start, c_end));
var cookieObj = cookieStr.split(';');
index = (index == null) ? 0 : index;
var goalStr = cookieObj[index].split('=');
return goalStr[1];
}
} else {
console.log('頁面沒有 cookie');
}
}
alert(getCookie('test', 0));
Cookie 的 API 面很小,難的是把細節想清楚:容量、生命週期、路徑、網域、編碼、安全性,每一項都會在真實專案裡回來找你。把這些觀念建立好,再搭配 localStorage、sessionStorage 做取捨,前端狀態管理就不再是黑盒子。