document.cookie 會以「key=value; key2=value2」的形式,列出目前頁面路徑下所有非 HttpOnly 的 cookie。
<!DOCTYPE html> <html> <body> 與此文件相關的 Cookies: <script> document.write(document.cookie); </script> </body> </html>
輸出會是一長串分號分隔的鍵值對,例如(以下已用佔位符取代實際值):
__gads=ID=<...>; theme=dark; lang=zh-TW; ASPSESSIONID<...>=<...>; __utma=<...>; __utmz=<...>
它只是一個字串,不是物件。要取值必須自己切分:
function getCookie(name) {
var pairs = document.cookie ? document.cookie.split('; ') : [];
for (var i = 0; i < pairs.length; i++) {
var idx = pairs[i].indexOf('=');
var key = idx > -1 ? pairs[i].substring(0, idx) : pairs[i];
if (key === name) {
return decodeURIComponent(pairs[i].substring(idx + 1));
}
}
return null;
}
逐筆比對完整鍵名,比用 indexOf(name + "=") 安全——後者會把 "lang" 誤配到 "userlang" 上。
HttpOnly 的 cookie 讀不到。由伺服器設定 HttpOnly 的 cookie(例如 session token)不會出現在這裡,這是刻意的安全設計,防止 XSS 腳本偷走工作階段。因此不要期望用 document.cookie 讀到登入狀態相關的憑證。
寫入時要記得編碼與設定 path。
document.cookie = "name=" + encodeURIComponent("中文值")
+ "; path=/" + "; max-age=3600" + "; SameSite=Lax";
若不正確編碼,值中含有分號或空白時會直接破壞 cookie 格式;不指定 path 時,cookie 的預設路徑是當前頁面的目錄,換頁就可能讀不到。
純前端的偏好設定,優先考慮 sessionStorage 與 localStorage——它們是真正的 key-value API,容量更大(數 MB),也不會在每次請求時被送到伺服器:
localStorage.setItem('theme', 'dark');
localStorage.getItem('theme');
需要「伺服器也要讀到」或「需要設定到期時間與跨子網域」時才用 cookie。另外別忘了 cookie 的內容由使用者完全掌控,任何權限判斷都必須在伺服器端重新驗證。