轻松上手,快乐学习!

HTML DOM cookie 属性


实例

获取与当前文档关联的 cookies:

var x = document.cookie;
亲自试一试 »

定义和用法

cookie 属性返回当前文档所有 键/值 对的所有 cookies。

有关cookies的更多信息,请阅读 JavaScript Cookies 教程


浏览器支持

属性
cookie Yes Yes Yes Yes Yes

语法

返回 cookie 属性:

document.cookie

设置 cookie 属性:

document.cookie = newCookie

属性值

参数 描述
newCookie 字符串,指定以分号分隔的 name=value 对列表,或 name=value 对,以及以下任意可选值:
  • expires=date - 可选。以 GMT 格式指定日期(请参见 Date.toUTCString 方法)。如果未指定,浏览器关闭时将删除 cookie

  • path=path - 可选。告诉浏览器 cookie 所属目录的路径(例如"/"、"/dir")。注释: 这条路必须是绝对的。如果未指定,则cookie属于当前页面

  • domain=domainname - 可选。指定站点的域 (例如 'example.com', '.example.com' (包括所有子域), 'subdomain.example.com')。如果未指定,将使用当前文档的域

  • secure - 可选。告诉浏览器使用安全协议(https)将cookie发送到服务器

创建 cookie 的实例:

document.cookie="username=John Doe; expires=Thu, 18 Dec 2013 12:00:00 UTC; path=/";
注意: cookie 的值不能包含逗号、分号或空格。但是,可以使用 encodeURIComponent() 方法确保它们不会

技术细节

返回值: 字符串,包含文档中 cookie 的 name/value 对
DOM 版本 Core Level 2 Document Object

相关页面

JavaScript 教程: JavaScript Cookies


❮ Document 对象