Electron webContents 模块

由 Loen 创建， 最后一次修改 2016-10-08 webContents 是一个 事件发出者.它负责渲染并控制网页，也是 BrowserWindow 对象的属性.一个使用 webContents 的例子:const BrowserWindow = require('electron').BrowserWindow;var win = new BrowserWindow({width: 800, height: 1500});win.loadURL("https://www.k88.net");var webContents = win.webContents;事件webContents 对象可发出下列事件:Event: 'did-finish-load'当导航完成时发出事件，onload 事件也完成.Event: 'did-fail-load'返回:event EventerrorCode IntegererrorDescription StringvalidatedURL String这个事件类似 did-finish-load ，但是是在加载失败或取消加载时发出, 例如， window.stop() 请求结束.错误代码的完整列表和它们的含义都可以在 here 找到.Event: 'did-frame-finish-load'返回:event EventisMainFrame Boolean当一个 frame 导航完成的时候发出事件.Event: 'did-start-loading'当 tab 的spinner 开始 spinning的时候.Event: 'did-stop-loading'当 tab 的spinner 结束 spinning的时候.Event: 'did-get-response-details'返回:event Eventstatus BooleannewURL StringoriginalURL StringhttpResponseCode IntegerrequestMethod Stringreferrer Stringheaders Object当有关请求资源的详细信息可用的时候发出事件. status 标识了 socket链接来下载资源.Event: 'did-get-redirect-request'返回:event EventoldURL StringnewURL StringisMainFrame BooleanhttpResponseCode IntegerrequestMethod Stringreferrer Stringheaders Object当在请求资源时收到重定向的时候发出事件.Event: 'dom-ready'返回:event Event当指定 frame 中的 文档加载完成的时候发出事件.Event: 'page-favicon-updated'返回:event Eventfavicons Array - Array of URLs当 page 收到图标 url 的时候发出事件.Event: 'new-window'返回:event Eventurl StringframeName Stringdisposition 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 Eventurl String当用户或 page 想要开始导航的时候发出事件.它可在当 window.location 对象改变或用户点击 page 中的链接的时候发生.当使用 api(如 webContents.loadURL 和 webContents.back) 以编程方式来启动导航的时候，这个事件将不会发出.它也不会在页内跳转发生， 例如点击锚链接或更新 window.location.hash.使用 did-navigate-in-page 事件可以达到目的.调用 event.preventDefault() 可以阻止导航.Event: 'did-navigate'返回:event Eventurl String当一个导航结束时候发出事件.页内跳转时不会发出这个事件，例如点击锚链接或更新 window.location.hash.使用 did-navigate-in-page 事件可以达到目的.Event: 'did-navigate-in-page'返回:event Eventurl String当页内导航发生的时候发出事件.当页内导航发生的时候，page 的url 改变，但是不会跳出界面.例如当点击锚链接时或者 DOM 的 hashchange 事件发生.Event: 'crashed'当渲染进程崩溃的时候发出事件.Event: 'plugin-crashed'返回:event Eventname Stringversion String当插件进程崩溃时候发出事件.Event: 'destroyed'当 webContents 被删除的时候发出事件.Event: 'devtools-opened'当开发者工具栏打开的时候发出事件.Event: 'devtools-closed'当开发者工具栏关闭时候发出事件.Event: 'devtools-focused'当开发者工具栏获得焦点或打开的时候发出事件.Event: 'certificate-error'返回:event Eventurl URLerror String - The error codecertificate Objectdata Buffer - PEM encoded dataissuerName Stringcallback Function当验证证书或 url 失败的时候发出事件.使用方法类似 app 的 certificate-error 事件.Event: 'select-client-certificate'返回:event Eventurl URLcertificateList [Objects]data Buffer - PEM encoded dataissuerName String - Issuer's Common Namecallback Function当请求客户端证书的时候发出事件.使用方法类似 app 的 select-client-certificate 事件.Event: 'login'返回:event Eventrequest Objectmethod Stringurl URLreferrer URLauthInfo ObjectisProxy Booleanscheme Stringhost Stringport Integerrealm Stringcallback Function当 webContents 想做基本验证的时候发出事件.使用方法类似 the login event of app.Event: 'found-in-page'返回:event Eventresult ObjectrequestId IntegerfinalUpdate Boolean - 标识是否还有更多的值可以查看.activeMatchOrdinal Integer (可选) - 活动匹配位置matches Integer (可选) - 匹配数量.selectionArea Object (可选) - 协调首个匹配位置.当使用 webContents.findInPage 进行页内查找并且找到可用值得时候发出事件.Event: 'media-started-playing'当媒体开始播放的时候发出事件.Event: 'media-paused'当媒体停止播放的时候发出事件.Event: 'did-change-theme-color'当page 的主题色时候发出事件.这通常由于引入了一个 meta 标签 :<meta name='theme-color' content='#ff0000'>Event: 'cursor-changed'返回:event Eventtype Stringimage NativeImage (可选)scale Float (可选)当鼠标的类型发生改变的时候发出事件. type 的参数可以是 default, crosshair, pointer, text, wait, help, e-resize, n-resize, ne-resize, nw-resize, s-resize, se-resize, sw-resize, w-resize, ns-resize, ew-resize, nesw-resize, nwse-resize, col-resize, row-resize, m-panning, e-panning, n-panning, ne-panning, nw-panning, s-panning, se-panning, sw-panning, w-panning, move, vertical-text, cell, context-menu, alias, progress, nodrop, copy, none,not-allowed, zoom-in, zoom-out, grab, grabbing, custom.如果 type 参数值为 custom, image 参数会在一个NativeImage 中控制自定义鼠标图片, 并且 scale 会控制图片的缩放比例.实例方法webContents 对象有如下的实例方法:webContents.loadURL(url[, options])url URLopt