原生 API 封裝
// 讀取 Cookie
function getCookie(name) {
var arr = document.cookie.match(new RegExp("(^| )" + name + "=([^;]*)(;|$)"));
return arr ? decodeURIComponent(arr[2]) : "";
}
// 寫入 Cookie
function setCookie(name, value, days, path, domain) {
var expires = "";
if (days) {
var d = new Date();
d.setTime(d.getTime() + days * 86400000);
expires = "; expires=" + d.toGMTString();
}
path = path ? "; path=" + path : "; path=/";
domain = domain ? "; domain=" + domain : "";
document.cookie = name + "=" + encodeURIComponent(value) + expires + path + domain;
}
// 刪除 Cookie
function delCookie(name, path, domain) {
setCookie(name, "", -1, path, domain);
}
關鍵屬性說明
| 屬性 | 作用 | 建議值 |
| path | Cookie 生效路徑 | / (全站) |
| domain | 生效域名 | .example.com(含子域) |
| expires/max-age | 過期時間 | GMT 字串或秒數 |
| secure | 僅 HTTPS 傳送 | true(生產環境) |
| HttpOnly | 禁止 JS 讀取(防 XSS) | 由伺服器端 Set-Cookie 設定 |
| SameSite | 跨站請求攜帶策略 | Lax / Strict / None |
實戰範例
// 設定:全站、30 天、HTTPS、SameSite=Lax
setCookie("token", "abc123", 30, "/", ".example.com");
// 讀取
var token = getCookie("token");
// 刪除
delCookie("token", "/", ".example.com");
jQuery Cookie 插件對應
$.cookie("name", "value", { expires: 7, path: "/", domain: ".example.com", secure: true });
$.cookie("name"); // 讀取
$.cookie("name", "", { expires: -1, path: "/", domain: ".example.com" }); // 刪除
注意事項
- Cookie 大小限制約 4KB,不可存放大量資料。
- 同域下同名 Cookie 以 path 最長者優先;刪除時需指定相同 path/domain。
- 現代應用建議改用
localStorage/sessionStorage(5MB+、不隨請求發送)或 IndexedDB。