DIV CSS 佈局教程網

JavaScript 中 cookie 物件的屬性、讀寫與刪除完整指南
編輯:關於JavaScript     

Cookie 是瀏覽器端最古老也最基礎的資料儲存機制。JavaScript 只能透過 document.cookie 這一個字串屬性來操作它,這也是許多人覺得 cookie 難用的原因——所有設定、讀取、刪除都得靠字串組裝與解析。

一、屬性說明

name:唯一必填的屬性,即 cookie 的名稱。

expires:指定存活期限。若不設定,cookie 只存在於記憶體中,瀏覽器關閉後自動失效(即工作階段 cookie)。

path:決定 cookie 的可用範圍。預設情況下,cookie 對同一目錄下的所有頁面有效;設定 path 之後,cookie 只對該路徑及其子路徑下的頁面生效。

domain:用於讓同一主網域下的多台子伺服器共享 cookie。若 a.example.com 需要與 b.example.com 共用資料,就把 domain 設為 .example.com,這樣兩者都能讀到。

secure:設為 true 後,cookie 只能透過 HTTPS 等安全協定傳輸,避免在中途被竊聽。

二、cookie 本質上就是字串

一般來說 cookie 的值不宜包含分號、逗號、空白等特殊字元,因為分號是屬性之間的分隔符。若內容確實含有這些字元,需先做編碼:把專用字元轉成對應的十六進位 ASCII 值。JavaScript 提供 encodeURIComponent() 編碼、decodeURIComponent() 解碼(原範例使用的 encodeURI 不會編碼 &、= 等字元,處理 cookie 值時應改用 Component 版本)。

三、寫入 cookie

// 最簡單的寫法
var cookieTest = "name=userName";
document.cookie = cookieTest;

// 加上存活時間:用分號分隔不同屬性
var date = new Date();
date.setDate(date.getDate() + 7);        // 7 天後過期
document.cookie = encodeURIComponent("name=user") +
                  ";expires=" + date.toUTCString();

關鍵觀念:document.cookie 是一個累加式的 setter。每次賦值不會覆蓋整個 cookie 集合,而是新增或更新「那一個」name。因此設定多個 cookie 要呼叫多次。

四、讀取 cookie

var cookieString = decodeURIComponent(document.cookie);
var cookieArray  = cookieString.split(";");

for (var i = 0; i < cookieArray.length; i++) {
  var cookieNum  = cookieArray[i].split("=");
  var cookieName = cookieNum[0];
  var cookieValue = cookieNum[1];
}

document.cookie 回傳的是一個包含所有非 HttpOnly cookie 的分號分隔字串,因此必須自己 split 後逐項比對 name。實務上通常會封裝成 getCookie(name) / setCookie(name, value, days) 兩個函式,避免到處重複這段解析邏輯。另外要注意:解碼後的 name 可能帶有前導空白,比對前最好先 trim()。

五、刪除 cookie

沒有專用的刪除 API,做法是把過期時間設為過去:

var date = new Date();
date.setTime(date.getTime() - 10000);      // 設為 10 秒前
document.cookie = "name=User;expires=" + date.toUTCString();

一個常見的坑是:刪除時的 name、path、domain 必須與設定時完全一致,否則瀏覽器會認為這是一個不同的 cookie,於是變成新增而非刪除,舊資料仍留著。

六、什麼時候不該用 cookie

Cookie 有兩個先天限制:容量小(單域名稱通常上限 4KB 左右)、且每次請求都會自動附帶到標頭,因此不適合存放大量資料。若只是前端暫存狀態,localStorage 與 sessionStorage 是更好的選擇——容量大得多,也不會增加網路負擔。

此外,cookie 不應存放敏感資訊如密碼或完整的身分權杖。若確實需要,務必加上 Secure 與 HttpOnly 旗標,並搭配 SameSite 屬性降低跨站請求偽造(CSRF)的風險。這些旗標無法從 JavaScript 端設定,需由伺服器在 Set-Cookie 標頭中下達。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved