首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

小型文字档案 | Cookies

查询和修改会话的cookie。

Process: Main

Cookies类的实例通过使用a的cookies属性来访问Session

例如:

代码语言:javascript
复制
const {session} = require('electron')

// Query all cookies.
session.defaultSession.cookies.get({}, (error, cookies) => {
  console.log(error, cookies)
})

// Query all cookies associated with a specific url.
session.defaultSession.cookies.get({url: 'http://www.github.com'}, (error, cookies) => {
  console.log(error, cookies)
})

// Set a cookie with the given cookie data;
// may overwrite equivalent cookies if they exist.
const cookie = {url: 'http://www.github.com', name: 'dummy_name', value: 'dummy'}
session.defaultSession.cookies.set(cookie, (error) => {
  if (error) console.error(error)
})

实例事件

以下事件可用于以下情况的Cookies

Event: ‘changed’

  • event 事件
  • cookie Cookie - 已更改的cookie
  • cause 字符串 - 使用以下值之一进行更改的原因:
    • explicit - Cookie由消费者的行为直接改变。
    • overwrite - 由于重写它的插入操作,cookie被自动删除。
    • expired - Cookie在过期时自动删除。
    • evicted - 垃圾收集期间,Cookie被自动清除。
    • expired-overwrite - cookie已被过期的过期日期覆盖。
  • removed布尔值 - true如果cookie被移除,false否则。

当Cookie因添加,编辑,删除或过期而发生更改时发出。

实例方法

以下方法适用于以下情况的Cookies

cookies.get(filter, callback)

  • filter 对象
    • url字符串(可选) - 检索与之关联的Cookie url。空意味着检索所有网址的Cookie。
    • name 字符串(可选) - 按名称筛选Cookie。
    • domain 字符串(可选) - 检索域匹配或其子域名的cookie domains
    • path字符串(可选) - 检索路径匹配的Cookie path
    • secure 布尔(可选) - 通过其Secure属性过滤Cookie。
    • session 布尔(可选) - 过滤会话或永久性Cookie。
  • callback 功能
    • error 错误
    • cookies Cookie [] - 一个cookie对象数组。

发送请求以获取所有匹配细节的cookie,回调函数将在回调(错误,cookies)完成时调用。

cookies.set(details, callback)

  • details对象
    • url 字符串 - 将Cookie与之关联的网址。
    • name字符串(可选) - Cookie的名称。如果省略,则默认为空。
    • value字符串(可选) - Cookie的值。如果省略,则默认为空。
    • domain字符串(可选) - Cookie的域。如果省略,则默认为空。
    • path字符串(可选) - Cookie的路径。如果省略,则默认为空。
    • secure布尔(可选) - 是否应将cookie标记为安全。默认为false。
    • httpOnly布尔(可选) - cookie是否应该标记为仅HTTP。默认为false。
    • expirationDateDouble(可选) - cookie的到期日期,为自UNIX纪元以来的秒数。如果省略,那么cookie会变成会话cookie,并且不会在会话之间保留。
  • callback 功能
    • error 错误

设置一个cookie的细节,回调将被称为回调(错误)完成。

cookies.remove(url, name, callback)

  • url 字符串 - 与Cookie关联的网址。
  • name 字符串 - 要删除的Cookie的名称。
  • callback 功能

删除匹配url和名称的cookie,回调将在callback()完成时调用。

cookies.flushStore(callback)

  • callback Function

将任何不写入的cookie数据写入磁盘。

扫码关注腾讯云开发者

领取腾讯云代金券