JS之document.cookie詳解以及$.cookie的使用

什么是cookie?

cookie 是存儲於訪問者的計算機中的變量。每當同一台計算機通過瀏覽器請求某個頁面時，就會發送這個 cookie。你可以使用 JavaScript 來創建和取回 cookie 的值。

設置cookie

每個cookie都是一個名/值對，可以把下面這樣一個字符串賦值給document.cookie：

document.cookie="userId=828";

document.cookie看上去就像一個屬性，可以賦不同的值。但它和一般的屬性不一樣，改變它的賦值並不意味着丟失原來的值，例如連續執行下面兩條語句：

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

這時瀏覽器將維護兩個cookie，分別是userId和userName，因此給document.cookie賦值更像執行類似這樣的語句：

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

事實上，瀏覽器就是按照這樣的方式來設置cookie的，如果要改變一個cookie的值，只需重新賦值，例如：

document.cookie="userId=929";

這樣就將名為userId的cookie值設置為了929。

獲取cookie的值

下面介紹如何獲取cookie的值。cookie的值可以由document.cookie直接獲得：

var strCookie=document.cookie; 

這將獲得以分號隔開的多個名/值對所組成的字符串，這些名/值對包括了該域名下的所有cookie。例如：

document.cookie="userId=828";
document.cookie="userName=hulk";
var strCookie=document.cookie;
console.log(strCookie); //userId=828; userName=hulk

當然這個要在環境下運行，因為是獲取當前域名下的cookie。

由此可見，只能夠一次獲取所有的cookie值，而不能指定cookie名稱來獲得指定的值，這正是處理cookie值最麻煩的一部分。

用戶必須自己分析這個字符串，來獲取指定的cookie值，例如，要獲取userId的值,可以這樣實現:

document.cookie="userId=828";
document.cookie="userName=hulk";
var strCookie=document.cookie;
console.log(strCookie); //userId=828; userName=hulk


function getdescookie(strcookie,matchcookie){
    var getMatchCookie;
    var arrCookie=strcookie.split(";");
    for(var i=0;i<arrCookie.length;i++){
         var arr=arrCookie[i].split("=");
         if(matchcookie == arr[0]){
                getMatchCookie = arr[1];
                break;
         }
    }
    return getMatchCookie;
}

var resultCookie = getdescookie(strCookie,'userId');
console.log(resultCookie); //828

這樣就得到了單個cookie的值。

如果在某個頁面創建了一個cookie，那么該頁面所在目錄中的其他頁面也可以訪問該cookie。如果這個目錄下還有子目錄，則在子目錄中也可以訪問。

為了控制cookie可以訪問的目錄，需要使用path參數設置cookie，語法如下：

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

其中cookieDir表示可訪問cookie的目錄。

例如：

document.cookie="userId=320; path=/shop";

就表示當前cookie僅能在shop目錄下使用。
如果要使cookie在整個網站下可用，可以將cookie_dir指定為根目錄，例如：

document.cookie="userId=320; path=/";

常用的cookie操作及其函數實現

addCookie

addCookie(name,value,expireHours) 該函數接收3個參數：cookie名稱，cookie值，以及在多少小時后過期。說明下，這個expireHours當然也可以設置成天或者秒等，只是在函數內部的處理稍微變一下而已：

function addCookie(name,value,expireHours){
     var exdate = new Date();　　　　
    exdate.setTime(exdate.getTime() + expireHours * 60 * 60 * 1000);　　　　
  document.cookie = c_name + "=" + escape(value) + ((expireHours == null) ? "" : ";expires=" + exdate.toUTCString());
}

getCookie

獲取指定名稱的cookie值：getCookie(name)。該函數返回名稱為name的cookie值，如果不存在則返回空。我們先來看下得到當前cookie的代碼：

document.cookie="userId=828";
document.cookie="userName=hulk";
console.log(document.cookie); //userId=828; userName=hulk

看到得到的cookie列表了吧，兩個cookie之間用；隔開后面還有空格，所以用正則匹配獲取當前指定的某個cookie名稱的值，實現如下：

function getCookie(name){
 var arr, reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)");
    if (arr = document.cookie.match(reg)){
        return (arr[2]);
    }else{
         return null;
    }      
}

上面arr匹配得到的數組結果為：

[" userName=hulk", " ", "hulk", "", index: 11, input: "userId=828; userName=hulk"]

如果全局匹配：

reg = new RegExp("(^| )" + name + "=([^;]*)(;|$)",'g');

那么得到的arr數組為:

[" userName=hulk"]

或者不用正則匹配，如下面代碼：

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 arr[1];
           }
     }
     return null;
}

deleteCookie

刪除指定名稱的cookie：deleteCookie(name)。該函數可以刪除指定名稱的cookie，其實現如下：

function deleteCookie(name){
    var exp = new Date();
    exp.setTime(exp.getTime() - 1);
    document.cookie = name + "=v;expires=" + exp.toUTCString();
}

說明下：這兒我用的toUTCString()方法，看了網上有的用的toGMTString()在格式化時間，但不贊成使用此方法。請使用 toUTCString() 取而代之！！，在W3C中看到這句話。

 jQuery cookie的使用

首先引入jquery與jquery.cookie

<script type="text/javascript" src="js/jquery-1.6.2.min.js"></script>  
<script type="text/javascript" src="js/jquery.cookie.js"></script>   

使用如下：

//新增cookie：  
$.cookie('cookieName', 'cookieValue');    
//注：如果沒有設置cookie的有效期，則cookie默認在瀏覽器關閉前都有效，故被稱為"會話cookie"。  
  
// 創建一個cookie並設置有效時間為7天:  
$.cookie('cookieName', 'cookieValue', { expires: 7 });  
  
// 創建一個cookie並設置cookie的有效路徑：  
$.cookie('cookieName', 'cookieValue', { expires: 7, path: '/' });  
  
//讀取cookie：  
$.cookie('cookieName'); // 若cookie存在則返回'cookieValue'；若cookie不存在則返回null   
  
//刪除cookie：把ncookie的值設為null即可  
$.cookie('the_cookie', null); 

可參考地址：w3school：JavaScript Cookies