HTML DOM Document cookie 属性

定义和用法

cookie 属性设置或返回以分号分隔的 key=value 对（文档 cookie）列表。

创建 cookie 的例子：

document.cookie="username=Bill Gates; expires=Thu, 18 Dec 2013 12:00:00 UTC; path=/";

提示：Cookie 不能包含逗号、分号或空格。encodeURIComponent() 方法 可确保它们不会。

另请参阅：

JavaScript Cookies 教程

建议：

有时 Storage API 是一个更好的工具：

localStorage 属性

sessionStorage 属性

实例

获取与此文档关联的所有 cookie：

let allCookies = document.cookie;

亲自试一试

语法

返回 cookie:

document.cookie

设置 cookie:

document.cookie = newCookie

参数

以分号分隔的 name=value 对列表，后跟任何可选值：

expires=date
GMT 格式的日期（使用 Date.toUTCString 方法）。
默认值：关闭浏览器时删除 cookie。
max-age=seconds
删除 cookie 之前的最大年龄。 如果为 0 或过去的某个日期，则删除 cookie。
path=path
cookie 所属目录的绝对路径 ('/dir')。 默认值：当前目录。
domain=domainname
站点的域（'example.com'）。 默认值：文档的域名。
secure
使用安全协议 (https) 将 cookie 发送到服务器。

返回值

类型 描述
字符串 以分号分隔的 key=value 对列表（文档 cookie）。

Cookie 与本地存储

Cookies 用于客户端-服务器（浏览器-服务器）应用程序。

本地存储（Local Storage）用于客户端（浏览器）应用程序。

Cookie 与网站相关联。如果数据供客户端使用，则在每个 HTTP 标头中发送 cookie 是对带宽的浪费。

一些用户的浏览器通常禁用 cookie。

Cookie 的大小限制为 4 KB。本地存储的每个域限制为 5 兆字节。

Cookie 有过期日期。本地存储没有。

浏览器支持

document.cookie 是 DOM Level 2 (2001) 特性。

所有浏览器都支持它：

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
支持 9-11 支持 支持 支持 支持