Electron中文文档

新手 685983304  中级 642625556 高级 602866851 Q群区别? 征集友情链接公告

推荐版:3.0.10   测试版:4.0.0-beta.8   极客版:4.0.0-nightly.20181010  

webFrame

自定义渲染当前网页

进程: Renderer

webFrame export of the electron module is an instance of the WebFrame class representing the top frame of the current BrowserWindow. Sub-frames can be retrieved by certain properties and methods (e.g. webFrame.firstChild).

将当前页缩放到200% 的示例。

const {webFrame} = require('electron')
webFrame.setZoomFactor(2)

方法

The WebFrame class has the following instance methods:

webFrame.setZoomFactor(factor)

  • factor Number - 缩放比例

更改缩放比例。缩放比例是缩放百分比除以 100,如 300% = 3.0。

webFrame.getZoomFactor()

Returns Number - 当前的缩放比例。

webFrame.setZoomLevel(level)

  • level Number - 缩放等级。

更改缩放等级。 The original size is 0 and each increment above or below represents zooming 20% larger or smaller to default limits of 300% and 50% of original size, respectively.

webFrame.getZoomLevel()

Returns Number - The current zoom level.

webFrame.setVisualZoomLevelLimits(minimumLevel, maximumLevel)

  • minimumLevel Number
  • maximumLevel Number

设置最大和最小缩放级别。

webFrame.setLayoutZoomLevelLimits(minimumLevel, maximumLevel)

  • minimumLevel Number
  • maximumLevel Number

Sets the maximum and minimum layout-based (i.e. non-visual) zoom level.

webFrame.setSpellCheckProvider(language, autoCorrectWord, provider)

  • language String
  • autoCorrectWord Boolean
  • provider Object
    • spellCheck Function - Returns Boolean.
      • text String

Sets a provider for spell checking in input fields and text areas.

The provider must be an object that has a spellCheck method that returns whether the word passed is correctly spelled.

An example of using node-spellchecker as provider:

const {webFrame} = require('electron')
webFrame.setSpellCheckProvider('en-US', true, {
  spellCheck (text) {
    return !(require('spellchecker').isMisspelled(text))
  }
})

webFrame.registerURLSchemeAsBypassingCSP(scheme)

  • scheme String

无论当前页的内容安全策略如何, 都将从该 scheme 中加载资源。

webFrame.registerURLSchemeAsPrivileged(scheme[, options])

  • scheme String
  • options Object (可选)
    • secure Boolean (optional) - Default true.
    • bypassCSP Boolean (optional) - Default true.
    • allowServiceWorkers Boolean (optional) - Default true.
    • supportFetchAPI Boolean (optional) - Default true.
    • corsEnabled Boolean (optional) - Default true.

scheme 注册为安全, 绕过资源的内容安全策略, 允许注册 ServiceWorker 并支持获取 API。

指定一个值为 false 的选项, 将其从注册中省略。在不绕过内容安全策略的情况下注册特权方案的示例:

const {webFrame} = require('electron')
webFrame.registerURLSchemeAsPrivileged('foo', { bypassCSP: false })

webFrame.insertText(text)

  • text String

插入text 到焦点元素

webFrame.executeJavaScript(code[, userGesture, callback])

  • code String
  • userGesture Boolean (optional) - Default is false.
  • callback Function (可选) - 在脚本被执行后被调用。
    • result Any

Returns Promise - A promise that resolves with the result of the executed code or is rejected if the result of the code is a rejected promise.

在页面中执行 code

在浏览器窗口中,一些HTML API(如 requestFullScreen )只能是 由来自用户的手势调用。 将 userGesture 设置为 true 将删除此限制。

webFrame.executeJavaScriptInIsolatedWorld(worldId, scripts[, userGesture, callback])

  • worldId Integer
  • scriptsWebSource[]
  • userGesture Boolean (optional) - Default is false.
  • callback Function (可选) - 在脚本被执行后被调用。
    • result Any

Work like executeJavaScript but evaluates scripts in isolated context.

webFrame.setIsolatedWorldContentSecurityPolicy(worldId, csp)

  • worldId Integer
  • csp String

Set the content security policy of the isolated world.

webFrame.setIsolatedWorldHumanReadableName(worldId, name)

  • worldId Integer
  • name String

Set the name of the isolated world. Useful in devtools.

webFrame.setIsolatedWorldSecurityOrigin(worldId, securityOrigin)

  • worldId Integer
  • securityOrigin String

Set the security origin of the isolated world.

webFrame.getResourceUsage()

返回 Object:

Returns an object describing usage information of Blink's internal memory caches.

const {webFrame} = require('electron')
console.log(webFrame.getResourceUsage())

This will generate:

{
  images: {
    count: 22,
    size: 2549,
    liveSize: 2542
  },
  cssStyleSheets: {  },
  xslStyleSheets: {  },
  fonts: {  },
  other: {  }
}

webFrame.clearCache()

尝试释放不再使用的内存 (如以前导航中的图像)。

请注意, 盲目调用此方法可能使Electron较慢, 因为它将不得不重新填充这些清空的缓存。你应该只在这种情况下调用它, 就是当你的应用程序发生的一个事件, 使你认为你的网页实际只使用了较少的内存 (例如你从一个超级重页跳转到一个基本为空的页面, 并打算留在那)。

webFrame.getFrameForSelector(selector)

  • selector String - CSS selector for a frame element.

Returns WebFrame - The frame element in webFrame's document selected by selector, null would be returned if selector does not select a frame or if the frame is not in the current renderer process.

webFrame.findFrameByName(name)

  • name String

Returns WebFrame - A child of webFrame with the supplied name, null would be returned if there's no such frame or if the frame is not in the current renderer process.

webFrame.findFrameByRoutingId(routingId)

  • routingId Integer - An Integer representing the unique frame id in the current renderer process. Routing IDs can be retrieved from WebFrame instances (webFrame.routingId) and are also passed by frame specific WebContents navigation events (e.g. did-frame-navigate)

Returns WebFrame - that has the supplied routingId, null if not found.

属性

webFrame.top

A WebFrame representing top frame in frame hierarchy to which webFrame belongs, the property would be null if top frame is not in the current renderer process.

webFrame.opener

A WebFrame representing the frame which opened webFrame, the property would be null if there's no opener or opener is not in the current renderer process.

webFrame.parent

A WebFrame representing parent frame of webFrame, the property would be null if webFrame is top or parent is not in the current renderer process.

webFrame.firstChild

A WebFrame representing the first child frame of webFrame, the property would be null if webFrame has no children or if first child is not in the current renderer process.

webFrame.nextSibling

A WebFrame representing next sibling frame, the property would be null if webFrame is the last frame in its parent or if the next sibling is not in the current renderer process.

webFrame.routingId

An Integer representing the unique frame id in the current renderer process. Distinct WebFrame instances that refer to the same underlying frame will have the same routingId.



相关npm包集合




相关站点资源





官方指南

常见问题 (FAQ)

指南和教程

详细教程

API 参考

自定义 DOM 元素:

主进程可用的模块:

渲染进程(网页)可用的模块:

两种进程都可用的模块:

开发

  • mac 系统,electron 使用 packager 构建 exe 程序
  • electron 如何禁用页面缩放事件?
  • JS开发者社区

    和大家在一起

    新手/1元新手 685983304 
    中级/5元 中级 642625556
    高级/50元 高级 602866851