文章详情

短信预约-IT技能 免费直播动态提醒

请输入下面的图形验证码

提交验证

短信预约提醒成功

操作cookie的原生方法有哪些

2023-06-15 02:11

关注

这篇文章主要介绍操作cookie的原生方法有哪些,文中介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们一定要看完!

1. 平时如何操作 cookie

document.cookie 能获取到当前域所有的 cookie 字符串。每个 cookie 用分号进行隔开:

document.cookie; // "a=1; b=2; c=wenzi"

操作 cookie,均是在操作 document.cookie。如下面就是我常用的一段代码:

export const setCookie = (name: string, value: string | number, day = 30): void => {  const exp = new Date();  exp.setTime(exp.getTime() + day * 24 * 60 * 60 * 1000);  document.cookie = `${name}=${escape(value.toString())};path=/;expires=${exp.toUTCString()}`;};export const getCookie = (name: string): string | null => {  const reg = new RegExp(`(^| )${name}=([^;]*)(;|$)`);  const arr = document.cookie.match(reg);  if (arr) {    return unescape(arr[2]);  }  return null;};export const delCookie = (name: string) => {  if (!name) return;  const ex: Date = new Date();  ex.setTime(ex.getTime() - 1);  document.cookie = `${name}=; expires=${ex.toUTCString()};path=/`;};

可以看到设置、获取和删除 cookie,都是在 document.cookie 上进行操作的。

2. 新方式 cookieStore

现在 Chrome 有了更方便操作 cookie 的方法了cookieStore,这个方法是在 Chrome87 版本加入的,兼容性还不太好。

下图是当前日期 2021/03/15 的兼容性概览,可以发现仅仅是 Chrome 体系支持了 cookieStore。

操作cookie的原生方法有哪些

不过我们可以先来了解它的用法。

cookieStore 现在只能在https 协议下的域名才能访问的到;其他 http 协议的域名里会提示 cookieStore 为 undefined,或者设置失败。

2.1 基本方法

cookieStore 是一个类似localStorage的 object 类型变量。

操作cookie的原生方法有哪些

可以看到 cookieStore 主要有 5 个方法:

前 4 个方法天然支持 Promise。接下来我们一个个来了解下。

2.2 设置 cookie

cookieStore.set 方法可以设置 cookie,并返回一个 Promise 状态,表示是否设置成功。

cookieStore  .set('username', 'wenzi')  .then(() => console.log('设置username成功'))  .catch(() => console.error('设置username失败'));

操作cookie的原生方法有哪些

如果我们想要设置更多的属性,例如过期时间,可以传入一个 Object 类型:

cookieStore  .set({    name: 'age',    value: 18,    expires: new Date().getTime() + 24 * 60 * 60 * 1000,  })  .then(() => console.log('设置age成功'))  .catch(() => console.error('设置age失败'));

操作cookie的原生方法有哪些

value 中所有的数据都会默认先执行toString(),然后再进行存储,因此有些非基本类型的数据,最好先转换好。

上面都是我们设置 cookie 成功的情况,那么什么时候会设置失败呢?在本地 localhost 环境会设置失败。

本地 localhost,我们是能获取到cookieStore这个全局变量,也能执行相应的方法,但无法设置成功:

cookieStore.set('username', 'wenzi');

浏览器会发出提示,无法在不安全的域名下通过 CookieStore 中的 set 设置 cookie:

Uncaught (in promise) TypeError: Failed to execute 'set' on 'CookieStore': Cannot modify a secure cookie on insecure origin

添加 catch 后,就能捕获到这个错误:

cookieStore  .set('username', 'wenzi')  .then(() => console.log('设置username成功'))  .catch(() => console.error('设置username失败'));

操作cookie的原生方法有哪些

因此在想使用 cookieStore 时,不能直接通过下面的方式判断,还得新增一个页面 url 的协议来判断:

typeof cookieStore === 'object'; // 判断不准确,本地localhost也会存在

应当使用:

const isSupportCookieStore = typeof cookieStore === 'object' && location.protocol === 'https:'; // 只有在https协议下才使用cookieStore

2.3 获取 cookie

cookieStore.get(name)方法可以获取 name 对应的 cookie,会以 Promise 格式返回所有的属性:

await cookieStore.get('username');

操作cookie的原生方法有哪些

get()方法还可以接收一个 Object 类型,测试后发现,key 的值只能是 name:

await cookieStore.get({ name: 'username' });

当获取的 cookie 不存在时,则返回一个 Promise<null>。

2.4 获取所有的 cookie

cookieStore.getAll()方法可以获取当前所有的 cookie,以 Promise<[]>的形式返回的形式返回,数组中的每一项与通过 get()方式获取到的格式一样;若当前域没有 cookie,或者获取不到指定的 cookie,则为空数组;

await cookieStore.getAll();

操作cookie的原生方法有哪些

getAll()方法也可以传入一个 name,用来获取对应的 cookie:

await cookieStore.getAll('username');await cookieStore.getAll({ name: 'username' });

2.5 删除 cookie

cookieStore.delete(name)用来删除指定的 cookie:

cookieStore  .delete('age')  .then(() => console.log('删除age成功'))  .catch(() => console.error('删除age失败'));

删除成功后则会提示删除成功。

即使删除一个不存在的 cookie,也会提示删除成功。因此,当再次执行上面的代码时,还是会正常提示。

同样的,在 localhost 环境下会提示删除失败。

2.6 监听 cookie 的变化

我们可以通过添加change事件,来监听 cookie 的变化,无论是通过 cookieStore 操作,还是直接操作 document.cookie,都能监听。

添加监听事件:

cookieStore.addEventListener('change', (event) => {  const type = event.changed.length ? 'change' : 'delete';  const data = (event.changed.length ? event.changed : event.deleted).map((item) => item.name);  console.log(`刚才进行了 ${type} 操作,cookie有:${JSON.stringify(data)}`);});

这里面有 2 个重要的字段changed数组和deleted数组,当设置 cookie 时,则 changed 数组里为刚才设置的 cookie;当删除 cookie 时,则 deleted 数组里为刚才删除的 cookie。

1 设置操作

当调用 set()方法时,会触发 change 事件,同时影响的 cookie 会放在event.changed数组中。

通过 document.cookie 设置或者删除的 cookie,均认为是在修改 cookie,而不是删除。

每次设置 cookie 时,即使两次的 name 和 value 完全一样,也会触发change事件。

cookieStore.set('math', 90);

操作cookie的原生方法有哪些

2 删除操作

通过 delete()方法删除一个存在的 cookie 时,会触发 change 事件,被删除的 cookie 会放在event.deleted数组中。

如果删除一个不存在的 cookie,则不会触发 change 事件。

cookieStore.delete('math');

操作cookie的原生方法有哪些

可以看到,当第二次删除 name 为 math 的 cookie 时,就没有触发 change 事件。

以上是“操作cookie的原生方法有哪些”这篇文章的所有内容,感谢各位的阅读!希望分享的内容对大家有帮助,更多相关知识,欢迎关注编程网行业资讯频道!

阅读原文内容投诉

免责声明:

① 本站未注明“稿件来源”的信息均来自网络整理。其文字、图片和音视频稿件的所属权归原作者所有。本站收集整理出于非商业性的教育和科研之目的,并不意味着本站赞同其观点或证实其内容的真实性。仅作为临时的测试数据,供内部测试之用。本站并未授权任何人以任何方式主动获取本站任何信息。

② 本站未注明“稿件来源”的临时测试数据将在测试完成后最终做删除处理。有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341

软考中级精品资料免费领

  • 历年真题答案解析
  • 备考技巧名师总结
  • 高频考点精准押题
  • 2024年上半年信息系统项目管理师第二批次真题及答案解析(完整版)

    难度     813人已做
    查看
  • 【考后总结】2024年5月26日信息系统项目管理师第2批次考情分析

    难度     354人已做
    查看
  • 【考后总结】2024年5月25日信息系统项目管理师第1批次考情分析

    难度     318人已做
    查看
  • 2024年上半年软考高项第一、二批次真题考点汇总(完整版)

    难度     435人已做
    查看
  • 2024年上半年系统架构设计师考试综合知识真题

    难度     224人已做
    查看

相关文章

发现更多好内容

猜你喜欢

AI推送时光机
位置:首页-资讯-后端开发
咦!没有更多了?去看看其它编程学习网 内容吧
首页课程
资料下载
问答资讯