会话

会话(Cookie)查询与修改操作类

进程: 主进程

const {session} = require('electron')
//查询所有Cookie。
session.defaultSession.cookies.get({}, (error, cookies) => {
  console.log(error, cookies)
})
//查询与特定网址相关联的所有Cookie。
session.defaultSession.cookies.get({url: 'http://www.github.com'}, (error, cookies) => {
  console.log(error, cookies)
})
//设置具有给定Cookie数据的Cookie;
//如果存在相同的Cookie,则覆盖。
const cookie = {url: 'http://www.github.com', name: 'dummy_name', value: 'dummy'}
session.defaultSession.cookies.set(cookie, (error) => {
  if (error) console.error(error)
})

实例事件

事件: 'changed'

触发:当Cookie因增加,编辑,删除,过期等改变时

• event Event

• cookie Cookie - 被改变的Cookie

• cause String - 修改方式,可选以下:

  • explicit - 直接改变

  • overwrite - 自动擦除并覆盖

  • expired - 过期后自动删除

  • evicted - 跟随垃圾收集过程销毁

  • expired-overwrite - 用已过期的数据覆盖

• removed Boolean - true 已删除, false 其它.

实例方法

cookies.get(filter, callback)

用途:获取所有匹配 filter的Cookie

• filter Object

  • url String (可选) -关联Cookie的URL. 不存在则所有网址的Cookie。

  • name String (可选) - 按名称过滤Cookie。

  • domain String (可选) - 按 domains域或子域检索Cookie。

  • path String (可选) - 按 path路径检索Cookie。

  • secure Boolean (可选) -按照其Secure属性排序

  • session Boolean (可选) - 排除会话或持久Cookie

• callback Function

  • error Error

  • cookies Cookies[] - cookie 对象的数组。

当 callback(error, cookies) 完成后调用 callback

cookies.set(details, callback)

用途:用 details创建或设置一个Cookie

• details对象

  • url String - 关联Cookie的URL。

  • name String(可选) - Cookie的名称。如果省略,默认为空。

  • value String(可选) - Cookie的值。如果省略,默认为空。

  • domain String(可选) - Cookie的域。如果省略,默认为空。

  • path String(可选) - Cookie的路径。如果省略,默认为空。

  • secure Boolean(可选) - Cookie是否应标记为安全。默认 为false。

  • httpOnly Boolean(可选) - Cookie是否应标记为仅HTTP。默认为 false。

  • expirationDate Double (可选) - Cookie的过期日期(秒级)。如果省略,则Cookie成为临时会话。

• callback Function

  • error Error

当 callback(error)完成后,用 details, callback设置Cookie

cookies.remove(url, name, callback)

用途:删除匹配 url和 name的Cookie

• url String - 关联Cookie的URL。

• name String - 要删除的Cookie的名称。

• callback Function

当 callback() 完成后,用 url 和 name, callback删除对应的Cookie

cookies.flushStore(callback)

用途:清理存储数据,将未写入的Cookie数据写到磁盘中

• callback Function