webContents 是一个 事件发出者.

它负责渲染并控制网页，也是 BrowserWindow 对象的属性.一个使用 webContents 的例子:

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

var win = new BrowserWindow({width: 800, height: 1500});
win.loadURL("https://www.ogeek.cn");

var webContents = win.webContents;

事件

webContents 对象可发出下列事件:

Event: 'did-finish-load'

当导航完成时发出事件，onload 事件也完成.

Event: 'did-fail-load'

返回:

• event Event
• errorCode Integer
• errorDescription String
• validatedURL String

这个事件类似 did-finish-load ，但是是在加载失败或取消加载时发出, 例如， window.stop() 请求结束.错误代码的完整列表和它们的含义都可以在 here 找到.

Event: 'did-frame-finish-load'

返回:

• event Event
• isMainFrame Boolean

当一个 frame 导航完成的时候发出事件.

Event: 'did-start-loading'

当 tab 的spinner 开始 spinning的时候.

Event: 'did-stop-loading'

当 tab 的spinner 结束 spinning的时候.

Event: 'did-get-response-details'

返回:

• event Event
• status Boolean
• newURL String
• originalURL String
• httpResponseCode Integer
• requestMethod String
• referrer String
• headers Object

当有关请求资源的详细信息可用的时候发出事件. status 标识了 socket链接来下载资源.

Event: 'did-get-redirect-request'

返回:

• event Event
• oldURL String
• newURL String
• isMainFrame Boolean
• httpResponseCode Integer
• requestMethod String
• referrer String
• headers Object

当在请求资源时收到重定向的时候发出事件.

Event: 'dom-ready'

返回:

• event Event

当指定 frame 中的 文档加载完成的时候发出事件.

Event: 'page-favicon-updated'

返回:

• event Event
• favicons Array - Array of URLs

当 page 收到图标 url 的时候发出事件.

Event: 'new-window'

返回:

• event Event
• url String
• frameName String
• disposition String - 可为 default, foreground-tab, background-tab, new-window 和 other.
• options Object - 创建新的 BrowserWindow时使用的参数.

当 page 请求打开指定 url 窗口的时候发出事件.这可以是通过 window.open 或一个外部连接如 <a target='_blank'> 发出的请求.

默认指定 url 的 BrowserWindow 会被创建.

调用 event.preventDefault() 可以用来阻止打开窗口.

Event: 'will-navigate'

返回:

• event Event
• url String

当用户或 page 想要开始导航的时候发出事件.它可在当 window.location 对象改变或用户点击 page 中的链接的时候发生.

当使用 api(如 webContents.loadURL 和 webContents.back) 以编程方式来启动导航的时候，这个事件将不会发出.

它也不会在页内跳转发生， 例如点击锚链接或更新 window.location.hash.使用 did-navigate-in-page 事件可以达到目的.

调用 event.preventDefault() 可以阻止导航.

Event: 'did-navigate'

返回:

• event Event

• 鲜花

  握手

  雷人

  路过

  鸡蛋