jQuery（jquery.cookie用法详细解析）

COOKIE是由服务器端生成&＃xff0c;发送给User-Agent&＃xff08;一般是浏览器&＃xff09;&＃xff0c;浏览器会将COOKIE的key/value保存到某个目录下的文本文件内&＃xff0c;下次请求同一网站时就发送该COOKIE给服务器&＃xff08;前提是浏览器设置为启用COOKIE&＃xff09;。

例如购物网站存储用户曾经浏览过的产品列表&＃xff0c;或者门户网站记住用户喜欢选择浏览哪类新闻。 在用户允许的情况下&＃xff0c;还可以存储用户的登录信息&＃xff0c;使得用户在访问网站时不必每次都键入这些信息&＃xff1f;

怎么在js/jquery中操作处理COOKIE那&＃xff1f;今天分享一个COOKIE操作类--jQuery.COOKIE.js&＃xff0c;是一个轻量级的COOKIE管理插件。

COOKIE下载地址&＃xff1a; http://plugins.jquery.com/project/COOKIE.

特别提醒&＃xff0c;今日发现一个特别的错误&＃xff0c;google浏览器提示&＃xff1a;has no method $.COOKIE。火狐浏览器提示:$.COOKIE is not a function;调试了半天&＃xff0c;终于找到原因&＃xff0c;如果同一个页面两次或者多次引入Jquery插件就会报此错误。

　　使用方法&＃xff1a;

　　1、引入jQuery与jQuery.COOKIE.js插件。

2.将COOKIE写入文件

函数。

　　　语法&＃xff1a;$.COOKIE(名称,值,[option])

　　　(1)读取COOKIE值

　　　$.COOKIE(COOKIEName)　　　　　　　　　COOKIEName:要读取的COOKIE名称。

示例&＃xff1a;$.COOKIE("username"); 读取保存在COOKIE中名为的username的值。

　　　(2)写入设置COOKIE值&＃xff1a;

　　　$.COOKIE(COOKIEName,COOKIEValue);　　COOKIEName:要设置的COOKIE名称&＃xff0c;COOKIEValue表示相对应的值。

　　　示例:$.COOKIE("username","admin"); 将值"admin"写入COOKIE名为username的COOKIE中。

　　　　　 $.COOKIE("username",NULL);　　　销毁名称为username的COOKIE

　　　(3) [option]参数说明&＃xff1a;

　　　　　expires:　　有限日期&＃xff0c;可以是一个整数或一个日期(单位&＃xff1a;天)。　　这个地方也要注意&＃xff0c;如果不设置这个东西&＃xff0c;浏览器关闭之后此COOKIE就失效了

　　　　　path:　　　 COOKIE值保存的路径&＃xff0c;默认与创建页路径一致。

domin: COOKIE域名属性&＃xff0c;默认与创建页域名一样。　　这个地方要相当注意&＃xff0c;跨域的概念&＃xff0c;如果要主域名二级域名有效则要设置　　".xxx.com"

secrue:　　 一个布尔值&＃xff0c;表示传输COOKIE值时&＃xff0c;是否需要一个安全协议。

　　　　　示例&＃xff1a;

一个完整设置与读取COOKIE的页面代码&＃xff1a;

COOKIE本质上是一个txt文本&＃xff0c;因此只能够存入字符串&＃xff0c;对象通常要序列化之后才能存入COOKIE&＃xff0c;而取的时候要反序列才又能得到对象。

一个轻量级的COOKIE插件&＃xff0c;可以读取、写入、删除COOKIE。

jquery.COOKIE.js的配置

首先包含jQuery的库文件&＃xff0c;在后面包含jquery.COOKIE.js的库文件

使用方法

新添加一个会话COOKIE&＃xff1a;

$.COOKIE(&＃39;the_COOKIE&＃39;, &＃39;the_value&＃39;);

注&＃xff1a;当没有指明COOKIE有效时间时&＃xff0c;所创建的COOKIE有效期默认到用户关闭浏览器为止&＃xff0c;所以被称为“会话COOKIE&＃xff08;session COOKIE&＃xff09;”
 

创建一个COOKIE并设置有效时间为7天:

$.COOKIE(&＃39;the_COOKIE&＃39;, &＃39;the_value&＃39;, { expires: 7 });

注&＃xff1a;当指明了COOKIE有效时间时&＃xff0c;所创建的COOKIE被称为“持久COOKIE&＃xff08;persistent COOKIE&＃xff09;”。

创建一个COOKIE并设置COOKIE的有效路径&＃xff1a;

$.COOKIE(&＃39;the_COOKIE&＃39;, &＃39;the_value&＃39;, { expires: 7, path: &＃39;/&＃39; });

注&＃xff1a;在默认情况下&＃xff0c;只有设置COOKIE的网页才能读取该COOKIE。如果想让一个页面读取另一个页面设置的COOKIE&＃xff0c;必须设置COOKIE的路径。

COOKIE的路径用于设置能够读取COOKIE的顶级目录。将这个路径设置为网站的根目录&＃xff0c;可以让所有网页都能互相读取COOKIE&＃xff08;一般不要这样设置&＃xff0c;防止出现冲突&＃xff09;

读取COOKIE:

$.COOKIE(&＃39;the_COOKIE&＃39;);

// COOKIE存在 &＃61;> &＃39;the_value&＃39; $.COOKIE(&＃39;not_existing&＃39;); // COOKIE不存在 &＃61;> null

删除COOKIE&＃xff0c;通过传递null作为COOKIE的值即可&＃xff1a;

$.COOKIE(&＃39;the_COOKIE&＃39;, null);

相关参数的解释

expires: 365

定义COOKIE的有效时间&＃xff0c;值可以是一个&＃xff08;从创建COOKIE时算起&＃xff0c;以天为单位&＃xff09;或一个Date。

如果省略&＃xff0c;那么创建的COOKIE是会话COOKIE&＃xff0c;将在用户退出浏览器时被删除。
 

path: &＃39;/&＃39;

默认情况&＃xff1a;只有设置COOKIE的网页才能读取该COOKIE。

定义COOKIE的有效路径。默认情况下&＃xff0c;该参数的值为创建COOKIE的网页所在路径&＃xff08;标准浏览器的行为&＃xff09;。

如果你想在整个网站中访问这个COOKIE需要这样设置有效路径&＃xff1a;path: &＃39;/&＃39;。

如果你想删除一个定义了有效路径的COOKIE&＃xff0c;你需要在调用函数时包含这个路径:$.COOKIE(&＃39;the_COOKIE&＃39;, null, { path: &＃39;/&＃39; });。

domain: &＃39;example.com&＃39;

默认值&＃xff1a;创建COOKIE的网页所拥有的域名。
 

secure: true

默认值&＃xff1a;false。如果为true&＃xff0c;COOKIE的传输需要使用安全协议&＃xff08;HTTPS&＃xff09;。
 

raw: true

默认值&＃xff1a;false。 默认情况下&＃xff0c;读取和写入COOKIE的时候自动进行编码和解码&＃xff08;使用encodeURIComponent编码&＃xff0c;decodeURIComponent解码&＃xff09;。

要关闭这个功能设置raw: true即可。

$.COOKIE(&＃39;the_COOKIE&＃39;); // get COOKIE $.COOKIE(&＃39;the_COOKIE&＃39;, &＃39;the_value&＃39;); // set COOKIE $.COOKIE(&＃39;the_COOKIE&＃39;, &＃39;the_value&＃39;, { expires: 7 }); // set COOKIE with an expiration date seven days in the future $.COOKIE(&＃39;the_COOKIE&＃39;, &＃39;&＃39;, { expires: -1 }); // delete COOKIE 
$.COOKIE(&＃39;the_COOKIE&＃39;, null); // delete COOKIE

$.COOKIE(&＃39;the_COOKIE&＃39;,&＃39;the_value&＃39;, {expires: 7, path: &＃39;/&＃39;, domain:&＃39;80tvb.com&＃39;, secure: true});//完整调用方式

//或者这样&＃xff1a;$.COOKIE(&＃39;the_COOKIE&＃39;,&＃39;the_value&＃39;);

//删除COOKIE&＃xff1a; $.COOKIE(&＃39;the_COOKIE&＃39;,null);

jQuery操作COOKIE的插件,大概的使用方法如下

$.COOKIE(&＃39;the_COOKIE&＃39;); //读取COOKIE值
$.COOKIE(&＃39;the_COOKIE&＃39;, ‘the_value&＃39;); //设置COOKIE的值
$.COOKIE(&＃39;the_COOKIE&＃39;, ‘the_value&＃39;, {expires: 7, path: ‘/&＃39;, domain: ‘jquery.com&＃39;, secure: true});//新建一个COOKIE 包括有效期 路径域名等
$.COOKIE(&＃39;the_COOKIE&＃39;, ‘the_value&＃39;); //新建COOKIE
$.COOKIE(&＃39;the_COOKIE&＃39;, null); //删除一个COOKIE

jquery设置COOKIE过期时间与检查COOKIEs是否可用

让COOKIEs在x分钟后过期
var date &＃61; new date();
date.settime(date.gettime() &＃43; (x * 60 * 1000));
$.COOKIE(‘example&＃39;, ‘foo&＃39;, { expires: date });

$.COOKIE(‘example&＃39;, ‘foo&＃39;, { expires: 7});

检查COOKIEs是否可用
$(document).ready(function() {var dt &＃61; new date();dt.setseconds(dt.getseconds() &＃43; 60);document.COOKIE &＃61; “COOKIEtest&＃61;1; expires&＃61;” &＃43; dt.togmtstring();var COOKIEsenabled &＃61; document.COOKIE.indexof(“COOKIEtest&＃61;”) !&＃61; -1;if(!COOKIEsenabled){//COOKIEs不能用……..}});