mirrors/electron
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

session to zh-CN

Browse source
This commit is contained in:
Weiqiang Lin 2017-02-12 22:36:08 +08:00
parent 9fd9b39448
commit c9dd59eb86
1 changed files with 38 additions and 19 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

57
docs-translations/zh-CN/api/session.md
View file

@ -1,46 +1,64 @@
# session # session
`session` 模块可以用来创建一个新的 `Session` 对象. > 管理浏览器会话，Cookie，缓存，代理设置等。
你也可以通过使用 [`webContents`](web-contents.md) 的属性 `session` 来使用一个已有页面的 `session` ，`webContents` 是[`BrowserWindow`](browser-window.md) 的属性. 进程： [Main](../glossary.md#main-process)
`session` 模块可以用来创建一个新的 `Session` 对象。
你也可以通过使用 [`webContents`](web-contents.md) 的属性 `session` 来使用一个已有页面的 `session` ，`webContents` 是[`BrowserWindow`](browser-window.md) 的属性。
```javascript ```javascript
const BrowserWindow = require('electron').BrowserWindow const {BrowserWindow} = require('electron')
var win = new BrowserWindow({ width: 800, height: 600 }) let win = new BrowserWindow({width: 800, height: 600})
win.loadURL('http://github.com') win.loadURL('http://github.com')
var ses = win.webContents.session const ses = win.webContents.session
console.log(ses.getUserAgent())
``` ```
## 方法 ## 方法
`session` 模块有如下方法: `session` 模块有如下方法：
### session.fromPartition(partition) ### `session.fromPartition(partition[, options])`
* `partition` String * `partition` String
* `options` Object
* `cache` Boolean - 是否启用缓存。
从字符串 `partition` 返回一个新的 `Session` 实例. 从字符串 `partition` 返回一个新的 `Session` 实例。
如果 `partition` 以 `persist:` 开头，那么这个page将使用一个持久的 session，这个 session 将对应用的所有 page 可用.如果没前缀，这个 page 将使用一个历史 session.如果 `partition` 为空，那么将返回应用的默认 session . 返回 `Session` - 一个来自 `partition` 字符串的会话实例。当存在时
`Session` 与同一个 `partition`，它会被返回；否则一个新
`Session` 实例将使用 `options` 创建。
如果 `partition` 以 `persist:` 开头，那么这个 page 将使用一个持久的 session，这个 session 将对应用的所有 page 可用。如果没前缀，这个 page 将使用一个历史 session。如果 `partition` 为空，那么将返回应用的默认 session。
要用 `options` 创建一个 `Session`，你必须确保 `Session` 与
`partition` 从来没有被使用过。没有办法改变现有 `Session` 对象的 `options'。
## 属性 ## 属性
`session` 模块有如下属性: `session` 模块有如下属性：
### session.defaultSession ### session.defaultSession
返回应用的默认 session 对象. 返回应用的默认 `Session` 对象。
## Class: Session ## Class: Session
可以在 `session` 模块中创建一个 `Session` 对象 : > 获取和设置会话的属性。
进程: [Main](../glossary.md#main-process)
可以在 `session` 模块中创建一个 `Session` 对象：
```javascript ```javascript
const session = require('electron').session const {session} = require('electron')
const ses = session.fromPartition('persist:name')
var ses = session.fromPartition('persist:name') console.log(ses.getUserAgent())
``` ```
### 实例事件 ### 实例事件
@ -55,12 +73,13 @@ var ses = session.fromPartition('persist:name')
当 Electron 将要从 `webContents` 下载 `item` 时触发. 当 Electron 将要从 `webContents` 下载 `item` 时触发.
调用 `event.preventDefault()` 可以取消下载，并且在进程的下个 tick中，这个 `item` 也不可用. 调用 `event.preventDefault()` 可以取消下载，并且在进程的下个 tick 中，这个 `item` 也不可用。
```javascript ```javascript
session.defaultSession.on('will-download', function (event, item, webContents) { const {session} = require('electron')
session.defaultSession.on('will-download', (event, item, webContents) => {
event.preventDefault() event.preventDefault()
require('request')(item.getURL(), function (data) { require('request')(item.getURL(), (data) => {
require('fs').writeFileSync('/somewhere', data) require('fs').writeFileSync('/somewhere', data)
}) })
}) })
@ -68,7 +87,7 @@ session.defaultSession.on('will-download', function (event, item, webContents) {
### 实例方法 ### 实例方法
实例 `Session` 有以下方法: 实例 `Session` 有以下方法：
#### `ses.cookies` #### `ses.cookies`