JavaScript Cookie
Cookie 让您可以在网页中存储用户信息。
什么是 Cookie?
Cookie 是存储在您计算机上小型文本文件中的数据。
当 Web 服务器向浏览器发送网页后,连接就会关闭,服务器会忘记关于用户的一切。
发明 Cookie 是为了解决“如何记住用户信息”的问题。
- 当用户访问网页时,他/她的名字可以存储在一个 Cookie 中。
- 下次用户访问该页面时,Cookie 会“记住”他/她的名字。
Cookie 以名称-值对的形式保存,例如
username = John Doe
当浏览器向服务器请求网页时,属于该页面的 Cookie 会添加到请求中。通过这种方式,服务器可以获取必要的数据来“记住”用户信息。
如果您的浏览器关闭了本地 Cookie 支持,以下任何示例都将无法工作。
使用 JavaScript 创建 Cookie
JavaScript 可以使用 document.cookie
属性创建、读取和删除 Cookie。
使用 JavaScript,可以像这样创建 Cookie:
document.cookie = "username=John Doe";
您还可以添加一个过期日期(以 UTC 时间表示)。默认情况下,当浏览器关闭时,Cookie 会被删除。
document.cookie = "username=John Doe; expires=Thu, 18 Dec 2013 12:00:00 UTC";
通过路径参数,您可以告诉浏览器 Cookie 属于哪个路径。默认情况下,Cookie 属于当前页面。
document.cookie = "username=John Doe; expires=Thu, 18 Dec 2013 12:00:00 UTC; path=/";
使用 JavaScript 读取 Cookie
使用 JavaScript,可以像这样读取 Cookie:
let x = document.cookie;
document.cookie
将以一个字符串的形式返回所有 Cookie,类似于:cookie1=value; cookie2=value; cookie3=value;
使用 JavaScript 更改 Cookie
使用 JavaScript,您可以像创建 Cookie 一样更改它:
document.cookie = "username=John Smith; expires=Thu, 18 Dec 2013 12:00:00 UTC; path=/";
旧的 Cookie 将被覆盖。
使用 JavaScript 删除 Cookie
删除 Cookie 非常简单。
删除 Cookie 时无需指定 Cookie 值。
只需将 expires 参数设置为一个过去日期:
document.cookie = "username=; expires=Thu, 01 Jan 1970 00:00:00 UTC; path=/;";
您应该定义 Cookie 路径以确保删除正确的 Cookie。
如果您不指定路径,某些浏览器将不允许您删除 Cookie。
Cookie 字符串
document.cookie
属性看起来像一个普通的文本字符串。但它不是。
即使您将整个 Cookie 字符串写入 document.cookie,当您再次读取它时,您只能看到它的名称-值对。
如果您设置一个新 Cookie,旧的 Cookie 不会被覆盖。新 Cookie 会添加到 document.cookie 中,因此如果您再次读取 document.cookie,您将得到类似以下内容:
cookie1=value; cookie2=value;
如果您想查找某个指定 Cookie 的值,您必须编写一个 JavaScript 函数,在该 Cookie 字符串中搜索 Cookie 值。
JavaScript Cookie 示例
在接下来的示例中,我们将创建一个存储访问者姓名的 Cookie。
当访问者第一次访问网页时,会要求他/她填写姓名。然后该姓名会存储在 Cookie 中。
下次访问者访问同一页面时,他/她将收到欢迎消息。
对于此示例,我们将创建 3 个 JavaScript 函数:
- 一个设置 Cookie 值的函数
- 一个获取 Cookie 值的函数
- 一个检查 Cookie 值的函数
一个设置 Cookie 的函数
首先,我们创建一个 函数
,它将访问者的姓名存储在一个 Cookie 变量中:
示例
function setCookie(cname, cvalue, exdays) {
const d = new Date();
d.setTime(d.getTime() + (exdays*24*60*60*1000));
let expires = "expires="+ d.toUTCString();
document.cookie = cname + "=" + cvalue + ";" + expires + ";path=/";
}
示例说明
上述函数的参数是 Cookie 的名称 (cname)、Cookie 的值 (cvalue) 和 Cookie 应过期前的天数 (exdays)。
该函数通过将 Cookie 名称、Cookie 值和过期字符串连接起来来设置 Cookie。
一个获取 Cookie 的函数
然后,我们创建一个 函数
,该函数返回指定 Cookie 的值:
示例
function getCookie(cname) {
let name = cname + "=";
let decodedCookie = decodeURIComponent(document.cookie);
let ca = decodedCookie.split(';');
for(let i = 0; i <ca.length; i++) {
let c = ca[i];
while (c.charAt(0) == ' ') {
c = c.substring(1);
}
if (c.indexOf(name) == 0) {
return c.substring(name.length, c.length);
}
}
return "";
}
函数解释
将 Cookie 名称作为参数 (cname)。
创建一个变量 (name),其中包含要搜索的文本 (cname + "=")。
解码 Cookie 字符串,以处理带有特殊字符(例如 '$')的 Cookie。
将 document.cookie 按分号拆分为一个名为 ca 的数组 (ca = decodedCookie.split(';'))。
遍历 ca 数组 (i = 0; i < ca.length; i++),并读取每个值 (c = ca[i])。
如果找到 Cookie (c.indexOf(name) == 0),则返回 Cookie 的值 (c.substring(name.length, c.length))。
如果未找到 Cookie,则返回 ""。
一个检查 Cookie 的函数
最后,我们创建检查 Cookie 是否已设置的函数。
如果 Cookie 已设置,它将显示问候语。
如果 Cookie 未设置,它将显示一个提示框,要求输入用户的姓名,并通过调用 setCookie
函数将用户名 Cookie 存储 365 天。
示例
function checkCookie() {
let username = getCookie("username");
if (username != "") {
alert("欢迎再次光临 " + username);
} else {
username = prompt("请输入您的姓名:", "");
if (username != "" && username != null) {
setCookie("username", username, 365);
}
}
}
现在一起
示例
function setCookie(cname, cvalue, exdays) {
const d = new Date();
d.setTime(d.getTime() + (exdays * 24 * 60 * 60 * 1000));
let expires = "expires="+d.toUTCString();
document.cookie = cname + "=" + cvalue + ";" + expires + ";path=/";
}
function getCookie(cname) {
let name = cname + "=";
let ca = document.cookie.split(';');
for(let i = 0; i < ca.length; i++) {
let c = ca[i];
while (c.charAt(0) == ' ') {
c = c.substring(1);
}
if (c.indexOf(name) == 0) {
return c.substring(name.length, c.length);
}
}
return "";
}
function checkCookie() {
let user = getCookie("username");
if (user != "") {
alert("欢迎再次光临 " + user);
} else {
user = prompt("请输入您的姓名:", "");
if (user != "" && user != null) {
setCookie("username", user, 365);
}
}
}
自己动手试一试 »
上面的示例在页面加载时运行 checkCookie()
函数。