// 設置 Cookie (帶 path=/)
document.cookie = 'sdmenu_state=open; expires=Fri, 31 Dec 2099 23:59:59 GMT; path=/';
// 嘗試刪除
document.cookie = 'sdmenu_state=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/';
// 刷新頁面,Cookie 依然存在!
瀏覽器判斷兩個 Cookie 是否為「同一個」時,**同時比較 name、domain、path 三個屬性**。只有三者完全一致,後設置的才會覆蓋前者。
path=/、domain=.example.com (或默認當前域)// 服務端設置 (PHP/Java)
setcookie('token', 'abc', 0, '/', 'example.com');
// 瀏覽器實際存儲 domain = '.example.com' (自動加前導點)
// 前端刪除
document.cookie = 'token=; expires=...; path=/; domain=example.com';
// 瀏覽器存儲 domain = 'example.com' (無點號) → 與原 '.example.com' 不匹配 → 刪除失效!
// 獲取當前 Cookie 完整屬性 (需解析 document.cookie 字符串)
function getCookieOptions(name) {
var cookies = document.cookie.split('; ');
for (var i = 0; i < cookies.length; i++) {
var parts = cookies[i].split('=');
if (parts[0] === name) {
// 只能獲取 name/value,無法獲取 domain/path/expires/HttpOnly/Secure
// 瀏覽器安全策略:document.cookie 不暴露屬性元數據
return null;
}
}
return null;
}
// 因此:前端刪除時,必須「知道」設置時的 domain/path
// 最佳實踐:前後端約定固定的 cookie 配置常量
var COOKIE_CONFIG = {
path: '/',
domain: location.hostname === 'localhost' ? '' : '.' + location.hostname.replace(/^[^.]+\./, ''), // 主域
secure: location.protocol === 'https:',
sameSite: 'Lax'
};
function setCookie(name, value, maxAgeSeconds) {
var opts = [];
opts.push(name + '=' + encodeURIComponent(value));
if (maxAgeSeconds) opts.push('max-age=' + maxAgeSeconds);
if (COOKIE_CONFIG.path) opts.push('path=' + COOKIE_CONFIG.path);
if (COOKIE_CONFIG.domain) opts.push('domain=' + COOKIE_CONFIG.domain);
if (COOKIE_CONFIG.secure) opts.push('secure');
if (COOKIE_CONFIG.sameSite) opts.push('samesite=' + COOKIE_CONFIG.sameSite);
document.cookie = opts.join('; ');
}
function removeCookie(name) {
// 關鍵:完全復用設置時的 path/domain/secure/samesite
var opts = [];
opts.push(name + '=');
opts.push('max-age=0'); // 比 expires 更簡單標準
if (COOKIE_CONFIG.path) opts.push('path=' + COOKIE_CONFIG.path);
if (COOKIE_CONFIG.domain) opts.push('domain=' + COOKIE_CONFIG.domain);
if (COOKIE_CONFIG.secure) opts.push('secure');
if (COOKIE_CONFIG.sameSite) opts.push('samesite=' + COOKIE_CONFIG.sameSite);
document.cookie = opts.join('; ');
}
// 使用
setCookie('token', 'abc123', 3600);
removeCookie('token'); // 保證匹配
注意:前端無法讀取現有 Cookie 的 domain/path/HttpOnly,只能「猜」。以下為常見啟發式方案:
function removeCookieHeuristic(name) {
var hostname = location.hostname;
var paths = ['/', '/app', '/admin', '/api']; // 常見 path 列表
var domains = ['', '.' + hostname]; // 無 domain (當前主機) 和 主域
// 如果是子域名,嘗試上一級域
var parts = hostname.split('.');
if (parts.length > 2) {
domains.push('.' + parts.slice(1).join('.')); // .example.com
}
// 窮舉組合嘗試刪除
domains.forEach(function (domain) {
paths.forEach(function (path) {
var cookieStr = name + '=; max-age=0; path=' + path;
if (domain) cookieStr += '; domain=' + domain;
if (location.protocol === 'https:') cookieStr += '; secure';
cookieStr += '; samesite=Lax';
document.cookie = cookieStr;
});
});
}
class CookieStore {
constructor(defaultOptions = {}) {
this.defaults = {
path: '/',
domain: '',
secure: location.protocol === 'https:',
sameSite: 'Lax',
...defaultOptions
};
}
_buildString(name, value, options) {
var opts = { ...this.defaults, ...options };
var parts = [name + '=' + encodeURIComponent(value)];
if (opts.maxAge != null) parts.push('max-age=' + opts.maxAge);
if (opts.expires) parts.push('expires=' + opts.expires.toUTCString());
if (opts.path) parts.push('path=' + opts.path);
if (opts.domain) parts.push('domain=' + opts.domain);
if (opts.secure) parts.push('secure');
if (opts.sameSite) parts.push('samesite=' + opts.sameSite);
return parts.join('; ');
}
set(name, value, options) {
document.cookie = this._buildString(name, value, options);
}
get(name) {
var cookies = document.cookie.split('; ');
for (var i = 0; i < cookies.length; i++) {
var [k, v] = cookies[i].split('=');
if (k === name) return decodeURIComponent(v);
}
return null;
}
remove(name, options) {
// 必須傳入與設置時相同的 path/domain
document.cookie = this._buildString(name, '', {
maxAge: 0,
...options,
...this.defaults
});
}
has(name) {
return this.get(name) !== null;
}
}
// 單例
var cookies = new CookieStore({ path: '/', domain: '.example.com' });
cookies.set('token', 'abc');
cookies.remove('token'); // 完美匹配
| 場景 | 處理 |
|---|---|
| HttpOnly Cookie | 前端無法讀寫/刪除,需後端接口配合刪除 |
| Secure Cookie (HTTPS only) | 刪除時必須帶 secure,且頁面必須是 HTTPS |
| SameSite=Strict | 刪除時必須帶 samesite=Strict |
| 跨域 iframe 設置的 Cookie | 受第三方 Cookie 政策限制,現代瀏覽器默認阻塞,需后端配合 Partitioned (CHIPS) |
| 子域共享 Cookie | 設置 domain=.example.com,刪除時同樣指定 |
document.cookie 查看可見字符串Set-Cookie 響應頭與 Cookie 請求頭document.cookie = 'test=1; path=/; domain=.'+location.hostname 測試域匹配Cookie 刪除失效 99% 是 **path/domain 不匹配**。核心原則:**設置時什麼屬性,刪除時原樣保留,只改 value=空、max-age=0**。工程化做法是封裝 CookieStore 統一管理配置,前後端約定 domain/path 規範,杜絕手動拼接字符串導致的不一致。