DIV CSS 佈局教程網

詳談 JavaScript 中的 Cookie:機制、操作與應用
編輯:關於JavaScript     

先前我們曾用一個不變的框架來存放購物車資料,藉此模擬全域變數。但商品頁不斷變化,這種做法並不嚴謹——例如在導覽框架頁面上按右鍵選「重新整理」,所有 JavaScript 變數就全丟了。真正跨頁面的全域變數,需要另一種機制:Cookie。

Cookie 是什麼

Cookie 並非 JavaScript 本身的性質,而是瀏覽器提供的一種機制:瀏覽器把 document 物件的 cookie 屬性開放給 JavaScript 控制。

實際上 Cookie 是存於使用者硬碟的小檔案,通常對應一個網域;當瀏覽器再次造訪該網域時,這個 Cookie 便會被帶上。因此 Cookie 可以跨越同一網域下的多個網頁,但無法跨網域使用。不同瀏覽器的實作細節有差,性質則一致——例如在 Windows XP 中,Cookie 存放於 Documents and Settings\userName\Cookies\ 資料夾,命名格式通常為 userName@domain.txt。

典型應用

  1. 保存登入狀態:把使用者 id 存進 Cookie,下次造訪就不必重新登入。搭配過期時間,還能提供「保持登入一個月/三個月/一年」的選項。
  2. 追蹤使用者行為:例如天氣網站記住你上次選的地區,下次打開直接顯示當地天氣,感覺就像為你客製一樣。
  3. 客製化頁面:換膚、版面配置、背景色、解析度等偏好都能記住。
  4. 實作購物車:把看過或加入的商品記下來,結帳時統一送出。

四大限制

  1. 可能被停用:重視隱私的使用者往往會關閉瀏覽器 Cookie。
  2. 與瀏覽器綁定:同一頁面在不同瀏覽器之間無法共用 Cookie。
  3. 可能被刪除:它就是硬碟上的檔案,使用者可隨意清除。
  4. 安全性不足:內容以純文字儲存,若要放帳號密碼等敏感資訊,務必先加密。

設定 Cookie

每個 Cookie 都是一個名/值對,直接賦值給 document.cookie 即可:

document.cookie = "userId=828";

要一次存多組,用分號加空格隔開:

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

名稱與值中不可使用分號(;)、逗號(,)、等號(=)與空格。名稱通常可控,但值往往無法預期,因此建議用 escape() 編碼——它會把特殊符號轉為十六進位(例如空格變成 %20),同時也能避免中文亂碼:

document.cookie = "str=" + escape("I love ajax");
// 等效於 document.cookie = "str=I%20love%20ajax";

取出時則要用 unescape() 解碼還原。

document.cookie 其實比較像方法

它看起來像一般屬性,但連續賦值並不會互相覆蓋:

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

執行後瀏覽器會同時保留兩個 Cookie。與其說是賦值,不如想像成在呼叫:

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

若要修改既有 Cookie,重新賦同名值即可:

document.cookie = "userId=929";

讀取 Cookie

var strCookie = document.cookie;

這會得到以分號分隔的所有名/值對字串。麻煩的是只能一次取得全部,無法按名稱取值,必須自己解析:

<script type="text/javascript">
document.cookie = "userId=828";
document.cookie = "userName=hulk";

var strCookie = document.cookie;
var arrCookie = strCookie.split("; ");   // 切成多個名/值對
var userId;

for (var i = 0; i < arrCookie.length; i++) {
    var arr = arrCookie[i].split("=");
    if ("userId" == arr[0]) {
        userId = arr[1];
        break;
    }
}
alert(userId);
</script>

核心技巧仍是字串與陣列操作。實務上建議把這段邏輯包成 getCookie(name) 函式重用。

設定過期時間

截至目前為止的 Cookie 都是工作階段 Cookie:只存在記憶體中,瀏覽器關閉就消失。若要長期保存,加上 expires:

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

其中 GMT_String 是以 GMT 格式表示的時間字串。例如設定 10 天後過期:

<script type="text/javascript">
var date = new Date();
var expiresDays = 10;
date.setTime(date.getTime() + expiresDays * 24 * 3600 * 1000);
document.cookie = "userId=828; userName=hulk; expires=" + date.toGMTString();
</script>

刪除 Cookie

把過期時間設為過去即可:

<script type="text/javascript">
var date = new Date();
date.setTime(date.getTime() - 10000);
document.cookie = "userId=828; expires=" + date.toGMTString();
</script>

指定可存取的路徑

預設情況下,某頁面建立的 Cookie,同目錄的其他頁面與其子目錄都能存取。例如在 www.example.com/html/a.html 建立的 Cookie,可被 html/b.html 或 html/some/c.html 讀取,但 www.example.com/d.html 讀不到。

要明確控制範圍,使用 path 參數:

document.cookie = "name=value; path=cookieDir";

例如:

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

指定可存取的主機名

與路徑類似,主機名指的是同一網域下的不同子站台,例如 www.example.com 與 mail.example.com。預設情況下彼此無法互讀,但可以透過 domain 參數放寬:

document.cookie = "name=value; domain=.example.com";

這樣所有 example.com 下的主機都能存取該 Cookie。

封裝成通用函式

Cookie 的處理流程固定且繁瑣,適合抽成函式重用。

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

<script type="text/javascript">
function addCookie(name, value, expiresHours) {
    var cookieString = name + "=" + escape(value);
    // expiresHours 為 0 時不設過期時間,關閉瀏覽器即失效
    if (expiresHours > 0) {
        var date = new Date();
        date.setTime(date.getTime() + expiresHours * 3600 * 1000);
        cookieString = cookieString + "; expires=" + date.toGMTString();
    }
    document.cookie = cookieString;
}
</script>

2. 讀取:getCookie(name)

<script type="text/javascript">
function getCookie(name) {
    var strCookie = document.cookie;
    var arrCookie = strCookie.split("; ");
    for (var i = 0; i < arrCookie.length; i++) {
        var arr = arrCookie[i].split("=");
        if (arr[0] == name) return unescape(arr[1]);
    }
    return "";
}
</script>

3. 刪除:deleteCookie(name)

<script type="text/javascript">
function deleteCookie(name) {
    var date = new Date();
    date.setTime(date.getTime() - 10000);
    document.cookie = name + "=v; expires=" + date.toGMTString();
}
</script>

今天的替代方案

Cookie 仍是 HTTP 協定的一部分,登入工作階段(Session ID)依然靠它傳遞。但若要存放較大量的前端資料,localStorage 與 sessionStorage 更方便:容量約 5MB、API 是同步且直覺的鍵值操作、不會自動隨每次請求送出。若資料涉及敏感資訊,無論用哪一種,都應先加密並加上 HttpOnly、Secure、SameSite 等旗標保護。

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