提供與 localStorage/sessionStorage 一致的鍵值存儲接口(getItem/setItem/removeItem/clear/key/length),底層基於 HTTP Cookie 實現,支援過期時間與路徑作用域配置。
function CookieStorage(maxage, path) {
// 1. 解析 document.cookie 為鍵值對象
var cookies = (function() {
var cookies = {};
var all = document.cookie;
if (all === '') return cookies;
var list = all.split('; ');
for (var i = 0; i < list.length; i++) {
var cookie = list[i];
var p = cookie.indexOf('=');
var name = cookie.substring(0, p);
var value = decodeURIComponent(cookie.substring(p + 1));
cookies[name] = value;
}
return cookies;
})();
// 2. 維護鍵名數組(保證順序與 length)
var keys = [];
for (var k in cookies) keys.push(k);
// 3. 公開 API
this.length = keys.length;
this.key = function(n) {
return (n < 0 || n >= keys.length) ? null : keys[n];
};
this.getItem = function(name) {
return cookies[name] || null;
};
this.setItem = function(key, value) {
if (!(key in cookies)) {
keys.push(key);
this.length++;
}
cookies[key] = value;
var cookie = key + '=' + encodeURIComponent(value);
if (maxage) cookie += '; max-age=' + maxage;
if (path) cookie += '; path=' + path;
document.cookie = cookie;
};
this.removeItem = function(key) {
if (!(key in cookies)) return;
delete cookies[key];
for (var i = 0; i < keys.length; i++) {
if (keys[i] === key) { keys.splice(i, 1); break; }
}
this.length--;
document.cookie = key + '=; max-age=0' + (path ? '; path=' + path : '');
};
this.clear = function() {
for (var i = 0; i < keys.length; i++) {
document.cookie = keys[i] + '=; max-age=0' + (path ? '; path=' + path : '');
}
cookies = {}; keys = []; this.length = 0;
};
}
// 實例化:30天過期,全站有效
var store = new CookieStorage(60*60*24*30, '/');
store.setItem('user', 'Alice');
console.log(store.getItem('user')); // "Alice"
console.log(store.length); // 1
console.log(store.key(0)); // "user"
store.removeItem('user');
console.log(store.getItem('user')); // null
store.setItem('a', 1); store.setItem('b', 2);
store.clear();
console.log(store.length); // 0
| 特性 | CookieStorage | localStorage |
|---|---|---|
| 容量 | ~4KB/域 | ~5MB/域 |
| 隨請求發送 | 是(每次 HTTP 攜帶) | 否 |
| 過期控制 | max-age/expires | 永久(手動清除) |
| 同源策略 | 域+路徑 | 域+協議+端口 |
| API 一致性 | 模擬兼容 | 原生標準 |
max-age 單位為秒;path 需與寫入時一致才能刪除;編碼用 encodeURIComponent 防特殊字符;同域下多子應用隔離可用 path 前綴區分。