問題:希望使用者在訪問頁面時能沿用上次的設定,或在不同頁面之間共享資料。例如使用者調整了頁面字體大小,會希望下次進來時仍維持同樣的設定,而不必重複調整。
解法:在使用者瀏覽並設定時,把這些設定寫進 cookie;下次訪問時再讀出來套用。
// 產生格式正確的到期日期
function getExpDate(days, hours, minutes)
{
var expDate = new Date();
if (typeof(days) == "number" && typeof(hours) == "number"
&& typeof(minutes) == "number")
{
expDate.setDate(expDate.getDate() + parseInt(days));
expDate.setHours(expDate.getHours() + parseInt(hours));
expDate.setMinutes(expDate.getMinutes() + parseInt(minutes));
return expDate.toGMTString();
}
}
注意條件判斷的地方:原式中第二個判斷重複檢查了 hours,導致 minutes 從未被驗證。這類「複製貼上後忘記改」的錯誤在型別檢查中特別容易漏掉,因為它不會報錯,只會安靜地讓某個參數不受檢查。
// 由 getCookie() 呼叫,取出 offset 之後到下一個分號之間的內容
function getCookieVal(offset)
{
var endstr = document.cookie.indexOf(";", offset);
if (endstr == -1)
{
endstr = document.cookie.length;
}
return unescape(document.cookie.substring(offset, endstr));
}
// 依名稱取得 cookie 的主要函式
function getCookie(name)
{
var arg = name + "=";
var alen = arg.length;
var clen = document.cookie.length;
var i = 0;
while (i < clen)
{
var j = i + alen;
if (document.cookie.substring(i, j) == arg)
{
return getCookieVal(j);
}
i = document.cookie.indexOf(" ", i) + 1;
}
return null;
}
function setCookie(name, value, expires, path, domain, secure)
{
var argv = setCookie.arguments;
var argc = setCookie.arguments.length;
var expires = (argc > 2) ? argv[2] : null;
var path = (argc > 3) ? argv[3] : null;
var domain = (argc > 4) ? argv[4] : null;
var secure = (argc > 5) ? argv[5] : false;
document.cookie = name + "=" + escape(value) +
((expires == null) ? "" : ("; expires=" + expires)) +
((path == null) ? "" : ("; path=" + path)) +
((domain == null) ? "" : ("; domain=" + domain)) +
((secure == true) ? "; secure" : "");
}
// 刪除:把到期時間設為過去
function deleteCookie(name, path)
{
document.cookie = name + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT" +
((path == null) ? "" : "; path=" + path);
}
path 一定要設。不設 path 的話,cookie 的預設範圍是當前路徑,從其他頁面會讀不到。這是最常見的「明明寫了卻讀不到」的原因。實務上通常設為 "/"。
不要用 escape/unescape。這兩個函式已被棄用,且對 UTF-8 的處理不正確(中文會被編碼成 %uXXXX 這種非標準格式)。請改用 encodeURIComponent 與 decodeURIComponent。
別把敏感資料放進 cookie。它會隨每次請求送到伺服器,使用者也能直接檢視與竄改。身分權杖請加上 Secure 與 HttpOnly(後者需由伺服器設定,JavaScript 無法設),並設定合理的 SameSite。
容量與數量都有限制。一般來說單一 cookie 約 4KB,同一網域總數也有上限。要存較大的資料,請用 localStorage(約 5~10MB,且不會隨請求送出)。
最後, cookie 有可能被使用者停用。任何依賴 cookie 的功能都應該有降級方案,例如把設定存進 URL 參數或讓使用者手動選擇,而不是讓頁面在讀不到 cookie 時直接出錯。