document.cookie

Cookie 是一个请求首部,其中含有先前由服务器通过 Set-Cookie 首部投放并存储到客户端的 HTTP cookies。

1. document.cookie

通过 document.cookie 可以获取与设置 cookie 。

2. 获取 cookie

document.cookie

通过 document.cookie 获取到的 cookie 由 cookie 的名称和值组成,由等号=分隔,并且可以有多条,每条 cookie 之间用分号 ‘;’ 分隔。

3. 设置cookie

var cookie = 'cookie名称=cookie值';

document.cookie = cookie;

设置 cookie 采用键值对的形式。

对应的就是 cookie的名称 和 cookie值 。

每次只能设置一条 cookie ,但可以同时设置这条 cookie的属性 。

如果需要设置多条 cookie ,则再次给 document.cookie 赋一个新值即可,但如果是相同名称的 cookie ,值就会被覆盖.

4. 设置 cookie 属性

设置 cookie 的同时可以设置这条 cookie 的属性。

document.cookie = '名称=值; 属性1=属性值1; 属性2=属性值2';

看起来是可以设置多条 cookie 一样,其实只有第一对值才是 cookie 的值,后面跟的都是这条 cookie 的属性。

可以跟随的属性有:

  • path cookie 生效的路径
  • domain cookie 生效的域名
  • max-age 过期时间,单位是秒
  • expires 过期时间,为一个 UTC 时间
  • secure 是否只能通过 https 来传递这条 cookie

这些属性具体作用可以参考 cookie 相关的内容。

设置完属性可以通过开发者工具查看。

5. 注意点

由于设置 cookie 是具有一定格式的,所以不能有字符来干扰这个格式。

var cookie = 'code=var a = 1; var b = 2;';

document.cookie = cookie;

这种情况下,cookie 就不符合预期了,被切断。

cookie 中不应该含有空格、分号、逗号这些符号。

借助 encodeURIComponent 方法,对 cookie 的值进行编码就可以避免这类问题。

var cookie = 'code=' + encodeURIComponent('var a = 1; var b = 2;');

document.cookie = cookie;

后续需要使用到这一条 cookie 的地方,再做一次解码操作即可。

注意:对字符串编码还可以使用 escape 方法,但已经从标准中移除,目前浏览器虽然还支持这个方法,但无法保证永远会保留这个方法,最好避免使用 escape 方法。

6. 小结

随着前端存储方案的增加,前端程序员访问 document.cookie 相对曾经减少了很多。

给 document.cookie 赋值可以增加一条 cookie,同时通过 ; 相隔,来设置这条 cookie 的属性。

当设置的 cookie 带有特殊字符的时候,如 ; 或者 =,应采用 encodeURIComponent 对内容编码,建议所有的 cookie 都进行编码。

 7.  实战应用

设置cookie的方法封装:

function setCookie(cname, cvalue, exdays) {
	let d = new Date()
	d.setTime(d.getTime() + (exdays = '24*60*60*1000'))
	let expires = 'expires=' + d.toGMTString()
	document.cookie = cname + '=' + cvalue + '; ' + expires
}

开发环境模拟设置cookie:

	async beforeCreate() {
		// 仿真环境 取出配置cookie模拟登陆
		if (process.env.VUE_APP_NODE_ENV == 'development') {
			// const cookieArr = process.env.VUE_APP_DEV_COOKIE.split('; ');
			const devCookie = window.localStorage.getItem('wbCookie')
			if (devCookie) {
				const cookieArr = devCookie.split('; ')
				for (let j = 0; j < cookieArr.length; j++) {
					const ckObj = cookieArr[j].split('=')
					setCookie(ckObj[0], ckObj[1])
				}
			}
		} else {
			// 服务器环境打印cookie
			console.log('wbCookie--------------', document.cookie)
		}
    }