DIV CSS 佈局教程網

JavaScript Cookie 操作完全指南:從基礎設定到進階應用
編輯:JavaScript綜合知識     

Cookie 幾乎是所有 Web 開發者都會碰到的技術,但真正把它用對、用安全的人並不多。本文從「Cookie 到底是什麼」講起,一路涵蓋基礎讀寫、有效期設定、路徑與網域隔離、安全性以及編碼細節,最後附上可直接複用的完整程式碼。

一、Cookie 究竟是什麼

用最直白的話說:Cookie 是一段存放在使用者本機的小文字資料。當瀏覽器向同一個網站發出請求時,會自動把符合條件的 Cookie 一起送出去,伺服器就能藉此辨認「你是誰」。

在 JavaScript 的世界裡,Cookie 就是字串。你透過 document.cookie 這一個屬性來讀取與寫入它。值得一提的是,Cookie 並不是前端獨有的東西,PHP、Java、Node.js 等後端語言同樣能讀寫,本質上它就是 HTTP 標頭裡的一段資料。

二、必須先搞懂的基礎觀念

1. 容量有上限

單一 Cookie 的內容建議不超過 4KB。若字串過長,瀏覽器可能直接丟棄,讀取時就會拿到空字串。

2. 它存在使用者電腦裡

Cookie 最終以檔案形式落地在本機,使用者打開開發者工具就能查看甚至竄改。這正是「不要把敏感資料、權限判斷放進 Cookie」的根本原因。

3. 格式固定

每一筆 Cookie 都是 名稱=值 的形式,名稱與值都必須是合法字元,多筆之間以分號與空格分隔。

4. 有預設生命週期

不指定有效期的 Cookie 屬於「工作階段 Cookie」,瀏覽器一關就消失。若想讓它在關閉瀏覽器後仍然存在,必須明確設定過期時間。

5. document.cookie 是字串,不是陣列

這點很多人第一次都會誤會。alert(typeof document.cookie) 的結果是 string,所有「取值」都得靠字串處理技巧自己完成。

6. 網域與路徑決定可見範圍

基於安全模型,不同網域之間預設無法互相讀取對方的 Cookie;同一網域下,Cookie 也只在建立它的目錄及其子目錄中可見。這兩個概念後面會展開說明。

三、Cookie 的常見問題

兩種來源:一是目前網站本身設定的第一方 Cookie;二是網頁中嵌入的廣告、圖片來自其他網域所帶入的第三方 Cookie,後者常被用於跨站追蹤使用者行為。

兩種狀態:一種是臨時性的工作階段 Cookie,關閉瀏覽器即清除;另一種是設定了失效時間的持久 Cookie,例如「記住我的登入狀態」,可以在本機保留數天、數月甚至更久。

兩種清除方式:透過瀏覽器設定或外掛工具直接刪除,或由程式把過期時間設為一個已過去的那一刻,讓它自然失效。要注意的是,貿然刪除 Cookie 有可能讓某些依賴它的頁面行為異常。

此外,瀏覽器允許使用者自行封鎖 Cookie。基於效能與流量考量,實務上應該控制 Cookie 的數量與大小,能不用就不用。

還有一個容易踩到的環境問題:直接以 file:// 開啟本機頁面時,部分瀏覽器(例如 Chrome)的控制台無法正常用 JavaScript 讀寫 Cookie,改用本機伺服器或換個瀏覽器測試即可。

四、基礎用法

寫入與修改

寫 Cookie 只需要對 document.cookie 賦值。名稱不存在就是新增,存在就是覆蓋:

document.cookie = 'username=Darren';

讀取

讀取沒有語法糖,本質上是字串切片。判斷存在、找起點、找終點、取出來:

function getCookie(c_name) {
  if (document.cookie.length > 0) {
    var c_start = document.cookie.indexOf(c_name + "=");
    if (c_start != -1) {
      c_start = c_start + c_name.length + 1;      // 跳過名稱與 = 號
      var c_end = document.cookie.indexOf(";", c_start);
      if (c_end == -1) c_end = document.cookie.length; // 處理最後一筆
      return unescape(document.cookie.substring(c_start, c_end));
    }
  }
  return "";
}

除了這種字串寫法,也可以用陣列 split 或正則表達式來取值,邏輯一致,只是風格不同。

設定有效期

document.cookie = "name=value;expires=" + date;

其中 date 必須是 GMT 格式的字串,常見的「保留 30 天」寫法:

var _date = new Date();
_date.setDate(_date.getDate() + 30);
_date.toGMTString();

封裝成函式會更實用:

function setCookie(c_name, value, expiredays) {
  var exdate = new Date();
  exdate.setDate(exdate.getDate() + expiredays);
  document.cookie = c_name + "=" + escape(value) +
    ((expiredays == null) ? "" : ";expires=" + exdate.toGMTString());
}
// 用法:setCookie('username', 'Darren', 30)

若想以「小時」為單位,把時間運算換掉即可:

exdate.setHours(exdate.getHours() + expiredays);

反過來說,要讓 Cookie 立刻失效,只要把過期時間設為已經過去的一刻——這正是清除 Cookie 的程式化做法。

五、進階用法

路徑(path)

預設情況下,只有與建立 Cookie 的頁面位於同一目錄或其子目錄的頁面才讀得到它。例如在 /Darren_code/ 下建立的 Cookie,/Darren_code/archive/ 裡的頁面可以讀取,但根目錄或 /xxxx/ 下的頁面不行。

想放寬範圍,就明確指定路徑。最常見的做法是設為根目錄,讓全站都能共用:

document.cookie = "name=value;path=path";
document.cookie = "name=value;expires=date;path=path";
document.cookie = "name=Darren;path=/";

網域(domain)

路徑解決同網域內的問題,domain 則處理跨子網域共用。例如 www.qq.com 與 sports.qq.com 同屬 qq.com,若希望前者讀到後者寫入的 Cookie:

document.cookie = "username=Darren;path=/;domain=qq.com";

關鍵限制:只能往「父網域」方向放寬,不能把 domain 設成毫不相干的網域。

安全性(secure)

Cookie 一般透過 HTTP 明文傳輸,路徑上很容易被側錄。加上 secure 標記後,它只會在 HTTPS 或其他安全協議下傳送:

document.cookie = "username=Darren;secure"

但務必理解它的邊界:secure 只保護「傳輸過程」,本機存檔的 Cookie 檔案並未加密。也就是說,真正重要的資料,從一開始就不該放進 Cookie。

編碼細節

Cookie 值不能包含空白、分號、逗號等特殊字元,而實務上又經常需要存這類內容。解法就是寫入前編碼、讀出後解碼:

document.cookie = name + "=" + escape(value);
// 讀取時
return unescape(document.cookie.substring(c_start, c_end));

少了這一步,值裡只要出現分號就會直接破壞整筆 Cookie 的結構,這是初學者最常遇到的「詭異 bug」。

六、可直接複用的完整範例

/* 設定 Cookie */
function setCookie(c_name, value, expiredays, path, domain, secure) {
  var exdate = new Date();
  exdate.setDate(exdate.getDate() + expiredays);
  document.cookie = c_name + "=" + escape(value) +
    ((expiredays == null) ? "" : ";expires=" + exdate.toGMTString()) +
    ((path == null) ? '/' : ';path=' + path) +
    ((domain == null) ? '' : ';domain=' + domain) +
    ((secure == null) ? '' : ';secure=' + secure);
}
setCookie('test', 'name=sheng;sex=men;lancer=dullbear', 30);

/* 取得 Cookie,index 用於在多值中挑選第幾組 */
function getCookie(c_name, index) {
  var cookies = document.cookie;
  var cookieLen = cookies.length;
  if (cookieLen > 0) {
    var c_start = cookies.indexOf(c_name + '=');
    if (c_start > -1) {
      c_start += c_name.length + 1;
      var c_end = cookies.indexOf(';', c_start);
      if (c_end == -1) c_end = cookieLen;
      var cookieStr = unescape(cookies.substring(c_start, c_end));
      var cookieObj = cookieStr.split(';');
      index = (index == null) ? 0 : index;
      var goalStr = cookieObj[index].split('=');
      return goalStr[1];
    }
  } else {
    console.log('頁面沒有 cookie');
  }
}
alert(getCookie('test', 0));

結語

Cookie 的 API 面很小,難的是把細節想清楚:容量、生命週期、路徑、網域、編碼、安全性,每一項都會在真實專案裡回來找你。把這些觀念建立好,再搭配 localStorage、sessionStorage 做取捨,前端狀態管理就不再是黑盒子。

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