Cookie 是瀏覽器提供的一種機制,透過 document 物件的 cookie 屬性開放給 JavaScript 控制——也就是說,它並非 JavaScript 語言本身的特性。
Cookie 以檔案形式存於使用者本機,通常對應一個網域。當瀏覽器再次造訪該網域時,這個 cookie 便可用。因此 cookie 能跨越同一網域下的多個頁面,但無法跨網域使用。
把使用者識別碼寫入 cookie,下次造訪時就不必重新登入,許多論壇與社群網站都提供這項功能。Cookie 可以設定過期時間,超過期限後自動消失,因此系統能提示「保持登入狀態」的時長選項,例如一個月、三個月、一年等。
例如一個天氣預報網站,能依使用者選擇的地區顯示當地天氣。若每次都要重新選擇實在麻煩,有了 cookie 之後,系統就能記住上次的地區,下次開啟時自動顯示當地天氣。由於一切在後台完成,頁面看起來就像為該使用者量身定制。
若網站提供換膚或版面調整功能,可用 cookie 記錄使用者偏好,例如背景色、解析度等,讓下次造訪時仍維持上次的介面風格。
function setCookie(sName, sValue, oExpires, sPath, sDomain, bSecure) {
var sCookie = sName + '=' + encodeURIComponent(sValue);
if (oExpires) {
var date = new Date();
date.setTime(date.getTime() + oExpires * 60 * 60 * 1000);
sCookie += '; expires=' + date.toUTCString();
}
if (sPath) {
sCookie += '; path=' + sPath;
if (sDomain) {
sCookie += '; domain=' + sDomain;
}
if (bSecure) {
sCookie += '; secure';
}
}
document.cookie = sCookie;
}
這裡的 oExpires 以「小時」為單位換算成毫秒,再轉為 UTC 字串;secure 標記可限定 cookie 僅在 HTTPS 連線下傳送。
function getCookie(name) {
var strCookie = document.cookie;
var arrCookie = strCookie.split("; ");
for (var i = 0; i < arrCookie.length; i++) {
var arr = arrCookie[i].split("=");
if (arr[0] == name) {
return decodeURIComponent(arr[1]);
}
}
return "";
}
document.cookie 回傳的是「名稱=值」以分號串接的單一字串,因此需要自行切分查找。若值中可能含有 =,建議只以第一個等號切分,避免把值截斷。
function delCookie(name) {
// 把過期時間設為過去,交由瀏覽器在適當時候清理
if (getCookie(name)) {
document.cookie = name + "=" + "; expires=Thu, 01-Jan-70 00:00:01 GMT";
}
}
瀏覽器沒有提供刪除 cookie 的專用 API,慣例是把它設為已過期。要注意刪除時的 path 與 domain 必須與設定時一致,否則刪不掉。
在 jQuery 外掛官方目錄搜尋 cookie 外掛即可找到輕量的實作,體積僅幾 KB,使用相當方便:
<script type="text/javascript" src="js/jquery.js"></script> <script type="text/javascript" src="js/jquery.cookie.js"></script>
引入後的用法:
<script>
$.cookie('the_cookie'); // 讀取
$.cookie('the_cookie', 'the_value'); // 設定
// 建立時指定有效期、路徑、網域與安全標記
$.cookie('the_cookie', 'the_value', {
expires: 7, path: '/', domain: 'jquery.com', secure: true
});
$.cookie('the_cookie', null); // 刪除
</script>
localStorage/sessionStorage 更合適。