session 模块可以用来创建一个新的 Session 对象.

你也可以通过使用 webContents 的属性 session 来使用一个已有页面的 session ，webContents是BrowserWindow 的属性.

const BrowserWindow = require('electron').BrowserWindow;

var win = new BrowserWindow({ width: 800, height: 600 });
win.loadURL("http://github.com");

var ses = win.webContents.session;

方法

session 模块有如下方法:

session.fromPartition(partition)

• partition String

从字符串 partition 返回一个新的 Session 实例.

如果 partition 以 persist: 开头，那么这个page将使用一个持久的 session，这个 session 将对应用的所有 page 可用.如果没前缀，这个 page 将使用一个历史 session.如果 partition 为空，那么将返回应用的默认 session .

属性

session 模块有如下属性:

session.defaultSession

返回应用的默认 session 对象.

Class: Session

可以在 session 模块中创建一个 Session 对象 :

const session = require('electron').session;

var ses = session.fromPartition('persist:name');

实例事件

实例 Session 有以下事件:

Event: 'will-download'

• event Event
• item DownloadItem
• webContents WebContents

当 Electron 将要从 webContents 下载 item 时触发.

调用 event.preventDefault() 可以取消下载，并且在进程的下个 tick中，这个 item 也不可用.

session.defaultSession.on('will-download', function(event, item, webContents) {
  event.preventDefault();
  require('request')(item.getURL(), function(data) {
    require('fs').writeFileSync('/somewhere', data);
  });
});

实例方法

实例 Session 有以下方法:

ses.cookies

cookies 赋予你全力来查询和修改 cookies. 例如:

// 查询所有 cookies.
session.defaultSession.cookies.get({}, function(error, cookies) {
  console.log(cookies);
});

// 查询与指定 url 相关的所有 cookies.
session.defaultSession.cookies.get({ url : "http://www.github.com" }, function(error, cookies) {
  console.log(cookies);
});

// 设置 cookie;
// may overwrite equivalent cookies if they exist.
var cookie = { url : "http://www.github.com", name : "dummy_name", value : "dummy" };
session.defaultSession.cookies.set(cookie, function(error) {
  if (error)
    console.error(error);
});

ses.cookies.get(filter, callback)

• filter Object
  • url String (可选) - 与获取 cookies 相关的 url.不设置的话就是从所有 url 获取 cookies .
  • name String (可选) - 通过 name 过滤 cookies.
  • domain String (可选) - 获取对应域名或子域名的 cookies .
  • path String (可选) - 获取对应路径的 cookies .
  • secure Boolean (可选) - 通过安全性过滤 cookies.
  • session Boolean (可选) - 过滤掉 session 或 持久的 cookies.
• callback Function

发送一个请求，希望获得所有匹配 details 的 cookies, 在完成的时候，将通过 callback(error, cookies) 调用 callback.

cookies是一个 cookie 对象.

• cookie Object
  • name String - cookie 名.
  • value String - cookie值.
  • domain String - cookie域名.
  • hostOnly String - 是否 cookie 是一个 host-only cookie.
  • path String - cookie路径.
  • secure Boolean - 是否是安全 cookie.
  • httpOnly Boolean - 是否只是 HTTP cookie.
  • session Boolean - cookie 是否是一个 session cookie 或一个带截至日期的持久 cookie .
  • expirationDate Double (可选) - cookie的截至日期，数值为UNIX纪元以来的秒数. 对session cookies 不提供.

ses.cookies.set(details, callback)

• details Object
  • url String - 与获取 cookies 相关的 url.
  • name String - cookie 名. 忽略默认为空.
  • value String - cookie 值. 忽略默认为空.
  • domain String - cookie的域名. 忽略默认为空.
  • path String - cookie 的路径. 忽略默认为空.

  • 鲜花

    握手

    雷人

    路过

    鸡蛋