cookie.js轻量级的JavaScript API,用于处理浏览器cookie
一个简单,轻量级的JavaScript API,用于处理浏览器cookie,它易于使用,具有合理的占用空间(~3kb)(gzip:1.73kb),并且没有依赖关系。
cookie APIs
cookie('test', 'tank', 1) // Create a cookie that expires 1 days from now cookie('test') // Create a cookie, valid across the entire site cookie('test', null) // Delete cookie `test` cookie() // Get all cookie cookie.set('test', 'tank', 1) // ====cookie('test', 'tank', 1) cookie.get('test') // ====cookie('test') cookie.remove('test') // ====cookie('test',null) cookie.remove('test3', 'test4') // Delete cookie `test3` and `test4` cookie.clear() // Clean all cookie cookie.all() // Get all cookie
批量设置cookie的值
cookie.set({ name1: 'value1', name2: 'value2' });
Cookie Attributes
cookie("test","123",{ "expires": 7, "path": '/', "domain":"" }); cookie({"test":"123"},{ "expires": 7, "path": '/', "domain":"" });
通过在最后一个参数中传递一个普通对象来单独调用cookie.set(...)
。 每次调用属性会覆盖默认属性。
示例:
cookie('name', 'value', { 'expires': 30, 'path': '/', 'domain':'' }); cookie.get('name') cookie.remove('name')
expires
定义何时删除cookie。 值可以是一个数字,它将被解释为创建时的天数或Date实例。 如果省略,cookie 将成为会话 cookie。
cookie('name', 'value', { 'expires': 30 });
path
默认值:
/
路径,字符串类型,指示cookie可见的路径,指定与cookie关联的WEB页。值可以是一个目录,或者是一个路径。
cookie.set('name', 'value', { path: '' }); cookie.get('name'); // => 'value' cookie.remove('name', { path: '' });
domain
默认值:Cookie仅对创建cookie的页面的域或子域可见,Internet Explorer除外(请参阅:有关Internet Explorer默认行为的说明。
⚠️如果省略域属性,它将在IE中显示为子域。
指示cookie应该可见的有效域。 所有子域都可以看到cookie。
示例:
cookie.set('name', 'value', { domain: 'subdomain.website.com' }); cookie.get('name'); // => undefined (need to read at 'subdomain.website.com')
secure
默认值:无安全协议要求。
无论是 true
还是 false
,表明 cookie 传输是否需要安全协议(https)。
Examples:
cookie.set('name', 'value', { secure: true }); cookie.get('name'); // => 'value' cookie.remove('name');
评论