lianjie5664 / cookie.js

:cookie:Interactive and easy cookies from your browser in javascript

cookie

对操作cookie的封装，提供简单的AIP 兼容IE6，压缩之后只有~2kb。

优缺点

规范：DOM Level 2: HTMLDocument.cookie
MDN Cookies MDN Cookies (Code snippets)

cookie虽然在持久保存客户端数据提供了方便，分担了服务器存储的负担，但还是有很多局限性的。

1.IE6或更低版本最多20个cookie
2.IE7和之后的版本最后可以有50个cookie。
3.Firefox最多50个cookie
4.chrome和Safari没有做硬性限制

cookie的最大大约为4096字节，为了兼容性，一般不能超过4095字节。

IE 提供了一种存储可以持久化用户数据，叫做userdata，从IE5.0就开始支持。每个数据最多128K，每个域名下最多1M。这个持久化数据放在缓存中，如果缓存没有清理，那么会一直存在。

安装

# 安装依赖
$ npm install

# bower
$ bower install icookie
$ bower info icookie # Run bower info icookie to list the available versions.

# npm
$ npm install cookiejs

生成压缩文件和开发模式

$ npm run build    # 生成带UMD的js原文件 以及 min.js
$ npm run watch    # 监听文件改变自动压缩生成js

测试

$ npm test
$ npm run ssr

# 浏览器打开 http://localhost:1987/test/test.html

使用

<script type="text/javascript" src="dist/cookie.js"></script>
<script type="text/javascript">
cookie("test","tank",1)
</script>

or

var cookie = require('cookiejs')
cookie("test","tank",1)

cookie APIs

cookie(key,value,num)

• key cookie的名字
• value cookie的值
• num 存储时常以天为单位，一小时可传值 0.1

cookie("test","tank",1)     //设置 cookie 的值，生存时间1天d
cookie("test")              //获取 cookie 的值，显示tank
cookie("test",null)         //删除cookie test

// 此方法清空cookie()🔫弃用，容易清空cookie
// 功能变更为获取所有cookie的简写方式
cookie()                    //获取所有cookie
cookie(null)                //清空所有cookie

cookie.set("test","tank",1)  //====cookie("test","tank",1)
cookie.get("test")           //====cookie("test")
cookie.remove("test")        //====cookie("test",null)
cookie.clear()               //====cookie(null)

cookie.all()                 //获取所有 cookie

批量设置cookie的值

cookie.set({
   name1: 'value1',
   name2: 'value2'
});

set

设置 cookie 的值，设置时间

cookie.set(name,value,options) 效果相同cookie(name,value,options)

cookie("test","tank",30)    //设置cookie，并设置过期时间30天

cookie("test","123",{       //设置cookie，并设置过期时间7天，路径、域
    "expires": 7,
    "path": '/',
    "domain":""
});

cookie({"test":"123","test2":"456"},{  //批量设置
    "expires": 7,
    "path": '/',
    "domain":""
});

get

获取 cookie 的值

cookie.get(name) 效果相同cookie(name)

store.get("wcj1") //获取wcj1的字符串数据
store("wcj1") //功能同上

clear

清空cookie

cookie.clear() 效果相同 cookie()

cookie()
cookie.clear()

remove

删除cookie

cookie.remove(name) 效果相同cookie(name,null)

cookie.remove("test") //删除cookie test
cookie("test",null) //这样也是 删除cookie test

expires过期时间、 path路径、 domain域、以及 secure安全。

cookie("test","123",{
    "expires": 7,
    "path": '/',
    "domain":""
});
cookie({"test":"123"},{
    "expires": 7,
    "path": '/',
    "domain":""
});

key	value	default value
expires	过期时间(天)。指定cookie的生命期。具体是值是过期日期。如果想让cookie的存在期限超过当前浏览器会话时间，就必须使用这个属性。当过了到期日期时，浏览器就可以删除cookie文件，没有任何影响。	浏览器关闭过期
domain	域。指定关联的WEB服务器或域。值是域名，比如pc175.com。这是对path路径属性的一个延伸。如果我们想让 catalog.pc175.com 能够访问shoppingcart.pc175.com设置的cookies，该怎么办? 我们可以把domain属性设置成“pc175.com”，并把path属性设置成“/”。tag：不能把cookies域属性设置成与设置它的服务器的所在域不同的值。	默认本域
path	路径。指定与cookie关联的WEB页。值可以是一个目录，或者是一个路径。如果http://www.pc175.com/devhead/index.html 建立了一个cookie，那么在http://www.pc175.com/devhead/目录里的所有页面，以及该目录下面任何子目录里的页面都可以访问这个cookie。这就是说，在http://www.pc175.com/devhead/stories/articles 里的任何页面都可以访问http://www.pc175.com/devhead/index.html建立的cookie。但是，如果http://www.pc175.com/zdnn/ 需要访问http://www.pc175.com/devhead/index.html设置的cookes，该怎么办？这时，我们要把cookies 的path属性设置成“/”。在指定路径的时候，凡是来自同一服务器，URL里有相同路径的所有WEB页面都可以共享cookies。现在看另一个例子：如果想让 http://www.pc175.com/devhead/filters/ 和http://www.pc175.com/devhead/stories/共享cookies，就要把path设成“/devhead”。	默认 /
secure	安全。指定cookie的值通过网络如何在用户和WEB服务器之间传递。这个属性的值或者是“secure”，或者为空。缺省情况下，该属性为空，也就是使用不安全的HTTP连接传递数据。如果一个 cookie 标记为secure，那么，它与WEB服务器之间就通过HTTPS或者其它安全协议传递数据。不过，设置了secure属性不代表其他人不能看到你机器本地保存的cookie。换句话说，把cookie设置为secure，只保证cookie与WEB服务器之间的数据传输过程加密，而保存在本地的cookie文件并不加密。如果想让本地cookie也加密，得自己加密数据。	false