DIV CSS 佈局教程網

document.cookie 完整指南:寫入、讀取、過期與路徑控制一次搞懂
編輯:關於JavaScript     

在早期的前端開發裡,document.cookie 幾乎是保存用戶狀態的唯一手段。它看起來像一個普通屬性,實際行為卻和一般屬性差很多,也正因如此成為許多人踩坑的起點。本文把它的核心用法完整梳理一遍。

一、最基本的寫入方式

設定 cookie 只需要對 document.cookie 賦值:

document.cookie = "userId=828";

若要一次寫入多組名/值對,用「分號 + 空格」隔開即可:

document.cookie = "userId=828; userName=hulk";

需要注意的是,cookie 的名稱與值中不能直接出現分號(;)、逗號(,)、等號(=)與空格這類保留字元。名稱部分通常是我們自己定義的,容易避開;但值往往來自用戶輸入或動態資料,無法事先保證「乾淨」。

二、用 escape() 編碼解決特殊字元

面對不可控的值,標準做法是先用 escape() 編碼,它會把特殊符號轉成十六進位表示,例如空格會變成 %20,這樣就能安全地放進 cookie 值裡,同時也能避免中文亂碼:

document.cookie = "str=" + escape("I love ajax");
// 實際寫入的內容相當於
document.cookie = "str=I%20love%20ajax";

取值時,再用 unescape() 還原成原本的字串即可。

三、賦值不是覆蓋,而是「新增」

直覺上我們會以為第二次賦值會蓋掉第一次,實際不然:

document.cookie = "userId=828";
document.cookie = "userName=hulk";

執行完這兩行,瀏覽器會同時保留 userId 與 userName 兩個 cookie。也就是說,對 document.cookie 賦值比較接近這樣的語意:

document.addCookie("userId=828");
document.addCookie("userName=hulk");

瀏覽器內部正是以這種「逐筆設定」的方式處理。因此,想修改某個既有 cookie,只要用相同名稱重新賦值即可:

document.cookie = "userId=929";  // userId 被更新為 929

四、讀取 cookie 的值

讀取同樣透過 document.cookie:

var strCookie = document.cookie;

得到的是一個以分號分隔的字串,包含該域名下所有 cookie。這裡有個關鍵限制:無法指定名稱只取單一值,一次就會把全部 cookie 吐回來,必須自己解析字串。例如取出 userId:

function getCookie(name) {
    var pairs = document.cookie.split("; ");
    for (var i = 0; i < pairs.length; i++) {
        var arr = pairs[i].split("=");
        if (arr[0] == name) return unescape(arr[1]);
    }
    return "";
}

核心技巧仍是字串與陣列操作:先 split 成陣列,再逐一比對名稱。

五、設定過期時間

到目前为止的 cookie 都是「單一工作階段(session)cookie」——它們只存在記憶體中,不會落地成檔案,瀏覽器一關就消失。若要長期保存(例如記住登入狀態),加上 expires:

document.cookie = "userId=828; expires=GMT_String";

其中 GMT_String 是 GMT 格式的時間字串。想讓 cookie 在 10 天後失效:

var date = new Date();
date.setTime(date.getTime() + 10 * 24 * 60 * 60 * 1000);
document.cookie = "userId=828; expires=" + date.toGMTString();

六、刪除 cookie

沒有專用的 delete 方法,把過期時間設成一個已經過去的那一刻即可:

var date = new Date();
date.setTime(date.getTime() - 1000);
document.cookie = "userId=828; expires=" + date.toGMTString();

七、用 path 控制可存取的目錄

預設情況下,某頁面建立的 cookie,同目錄的其他頁面都能讀取,子目錄也包含在內。例如在 www.xxxx.com/html/a.html 建立的 cookie,/html/b.html 與 /html/some/c.html 都可以存取,但 www.xxxx.com/d.html 不行。

要自訂範圍,加上 path 參數:

document.cookie = "name=value; path=cookieDir";
document.cookie = "userId=320; path=/shop";  // 僅 shop 目錄可用
document.cookie = "userId=320; path=/";       // 全站可用

八、用 domain 控制可存取的主機

主機(host)指的是同一個網域下的不同伺服器,例如 www.google.com 與 gmail.google.com。預設情況下,一個主機設定的 cookie 無法被另一個主機讀取,但可以透過 domain 放寬:

document.cookie = "name=value; domain=cookieDomain";
document.cookie = "name=value; domain=.google.com";  // google.com 下所有主機共用

九、封裝成通用函式

cookie 的處理流程固定又繁瑣,實務上一定會抽成函式重用。常見的三個操作如下。

1. 新增:addCookie(name, value, expiresHours)

接收名稱、值與「幾小時後過期」。約定 expiresHours 為 0 時不設定過期時間,也就是關閉瀏覽器即失效。

2. 讀取:getCookie(name)

回傳指定名稱的值,不存在則回傳空字串(實作如第四節所示)。

3. 刪除:deleteCookie(name)

把該名稱的過期時間設為過去,等於刪除。

把這三者包成一個 CookieClass 或工具物件,後續所有頁面都能直接取用,不必每次重寫解析邏輯。

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