一、Cookie 是什麼
Cookie 是儲存在客戶端的小型資料,主要用於在瀏覽器與伺服器之間傳遞會話資訊。
名稱:唯一標識一個 Cookie,建議區分大小寫,且必須經過 URL 編碼。
值:儲存在 Cookie 中的字串,同樣必須 URL 編碼。
域(domain):決定這個 Cookie 對哪個網域有效,凡是向該域發送的請求都會自動帶上。可以指定子域(如 www.example.com),也可以寫成 .example.com 讓所有子域共用;不指定時預設為設定它的那個域。
路徑(path):指定該域下哪些路徑可以存取這個 Cookie。例如設為 /books/,則 / 下的頁面不會帶上它。
失效時間(expires):GMT 格式的時間戳,格式為 Wdy, DD-Mon-YYYY HH:MM:SS GMT。不設定的話就是「工作階段 Cookie」,瀏覽器關閉即消失;若設定的時間已過去,Cookie 會立即被刪除。
安全標誌(secure):加上後,Cookie 只會在 SSL(https)連線時送出。
Set-Cookie: name=value; expires=Mon, 22-Jan-2024 07:10:24 GMT; domain=.example.com; path=/; secure
對應關係:名稱 name、值 value、過期時間 expires、域名 .example.com、路徑 /、安全標誌 secure。
var CookieUtil = {
// 設置
set: function (name, value, expires, domain, path, secure) {
var cookieText = encodeURIComponent(name) + "=" + encodeURIComponent(value);
if (expires instanceof Date) cookieText += "; expires=" + expires.toUTCString();
if (path) cookieText += "; path=" + path;
if (domain) cookieText += "; domain=" + domain;
if (secure) cookieText += "; secure";
document.cookie = cookieText;
},
// 讀取
get: function (name) {
var cookieName = encodeURIComponent(name) + "=";
var cookieStart = document.cookie.indexOf(cookieName);
var cookieValue = "";
if (cookieStart > -1) {
var cookieEnd = document.cookie.indexOf(";", cookieStart);
if (cookieEnd == -1) cookieEnd = document.cookie.length;
cookieValue = decodeURIComponent(
document.cookie.substring(cookieStart + cookieName.length, cookieEnd));
}
return cookieValue;
},
// 刪除:把過期時間設為過去即可
unset: function (name, domain, path, secure) {
this.set(name, "", new Date(0), domain, path, secure);
}
};
CookieUtil.set("name", "zhang");
alert(CookieUtil.get("name")); // zhang
CookieUtil.unset("name");
alert(CookieUtil.get("name")); // 空字串
· 單個 Cookie 大小有限(各家瀏覽器約 4KB 上下),且同一域名的 Cookie 總數也有上限;
· 值僅能讓所屬域的接收者讀取,無法被其他域存取;
· 安全性有限,內容以純文字傳輸,不該存放密碼、權杖等敏感資料。
為了解決數量限制,可以把多筆資料塞進同一條 Cookie,用 & 分隔,形成類似 info=name=zhang&age=23 的結構。
var SubCookieUtil = {
// 寫入一整組
setAll: function (name, subCookies, expires, domain, path, secure) {
var cookieText = encodeURIComponent(name) + "=", parts = [], subName;
for (subName in subCookies) {
parts.push(encodeURIComponent(subName) + "=" + encodeURIComponent(subCookies[subName]));
}
if (parts.length > 0) {
cookieText += parts.join("&");
if (expires instanceof Date) cookieText += "; expires=" + expires.toUTCString();
if (path) cookieText += "; path=" + path;
if (domain) cookieText += "; domain=" + domain;
if (secure) cookieText += "; secure";
} else {
cookieText += "; expires=" + new Date(0).toUTCString(); // 空資料即刪除
}
document.cookie = cookieText;
},
// 寫入單一子項
set: function (name, subName, value, expires, domain, path, secure) {
var cookies = this.getAll(name) || {};
cookies[subName] = value;
this.setAll(name, cookies, expires, domain, path, secure);
},
// 讀取整組
getAll: function (name) {
var cookieName = encodeURIComponent(name) + "=";
var cookieStart = document.cookie.indexOf(cookieName);
if (cookieStart > -1) {
var cookieEnd = document.cookie.indexOf(";", cookieStart);
if (cookieEnd == -1) cookieEnd = document.cookie.length;
var cookieValue = decodeURIComponent(
document.cookie.substring(cookieStart + cookieName.length, cookieEnd));
if (cookieValue.length > 0) {
var result = {}, parts = cookieValue.split("&");
for (var i = 0, len = parts.length; i < len; i++) {
var pair = parts[i].split("=");
result[decodeURIComponent(pair[0])] = decodeURIComponent(pair[1]);
}
return result;
}
}
return null;
},
// 讀取單一子項
get: function (name, subName) {
var cookies = this.getAll(name);
return cookies ? cookies[subName] : null;
},
// 刪除整組
unsetAll: function (name, domain, path, secure) {
this.setAll(name, null, new Date(0), domain, path, secure);
},
// 刪除單一子項
unset: function (name, subName, domain, path, secure) {
var cookies = this.getAll(name);
if (cookies) {
delete cookies[subName];
this.setAll(name, cookies, null, domain, path, secure);
}
}
};
var zhang = { name: "zhang", age: 23, height: "178cm", weight: "66kg" };
SubCookieUtil.setAll("zhang", zhang);
alert(SubCookieUtil.getAll("zhang").weight); // 66kg
SubCookieUtil.set("zhang", "sport", "basketball");
alert(SubCookieUtil.get("zhang", "sport")); // basketball
SubCookieUtil.unset("zhang", "age");
alert(SubCookieUtil.get("zhang", "age")); // undefined
SubCookieUtil.unsetAll("zhang");
alert(SubCookieUtil.getAll("zhang")); // null
最後提醒:Cookie 每次請求都會隨標頭送出,會增加頻寬負擔。若資料只是前端暫存、不需要送到後端,改用 localStorage 或 sessionStorage 會更合適;前者長期保存、後者隨分頁關閉消失,且都不會自動隨請求傳輸。Cookie 真正不可替代的價值在於「伺服器需要讀到它」的場景,例如身份識別。