webFrame
自定义当前网页的渲染。
进程:渲染器
Electron 模块的 webFrame
导出是表示当前帧的 WebFrame
类的一个实例。子帧可以通过某些属性和方法(例如 webFrame.firstChild
)检索。
将当前页面缩放至 200% 的示例。
const { webFrame } = require('electron')
webFrame.setZoomFactor(2)
方法
WebFrame
类具有以下实例方法
webFrame.setZoomFactor(factor)
factor
Double - 缩放因子;默认为 1.0。
将缩放因子更改为指定的因子。缩放因子是缩放百分比除以 100,所以 300% = 3.0。
因子必须大于 0.0。
webFrame.getZoomFactor()
返回 number
- 当前的缩放因子。
webFrame.setZoomLevel(level)
level
number - 缩放级别。
将缩放级别更改为指定的级别。原始大小为 0,每个增量(无论增加或减少)都表示缩放 20%,分别达到原始大小的 300% 和 50% 的默认限制。
Chromium 级别的缩放策略是同源的,这意味着特定域的缩放级别会传播到具有相同域的所有窗口实例。区分窗口 URL 将使缩放功能在每个窗口中独立工作。
webFrame.getZoomLevel()
返回 number
- 当前的缩放级别。
webFrame.setVisualZoomLevelLimits(minimumLevel, maximumLevel)
minimumLevel
numbermaximumLevel
number
设置最大和最小捏合缩放级别。
Electron 中默认禁用视觉缩放。要重新启用它,请调用
webFrame.setVisualZoomLevelLimits(1, 3)
视觉缩放仅适用于捏合缩放行为。Cmd+/-/0 缩放快捷键由应用程序菜单中的“zoomIn”、“zoomOut”和“resetZoom”MenuItem 角色控制。要禁用快捷键,请手动定义菜单并从定义中省略缩放角色。
webFrame.setSpellCheckProvider(language, provider)
language
stringprovider
ObjectspellCheck
Functionwords
string[]callback
FunctionmisspeltWords
string[]
为输入字段和文本区域的拼写检查设置提供者。
如果你想使用此方法,你必须在构造窗口时禁用内置拼写检查器。
const mainWindow = new BrowserWindow({
webPreferences: {
spellcheck: false
}
})
provider
必须是一个包含 spellCheck
方法的对象,该方法接受一个用于拼写检查的单词数组。spellCheck
函数异步运行,并在完成后使用拼写错误的单词数组调用 callback
函数。
使用node-spellchecker作为提供者的示例
const { webFrame } = require('electron')
const spellChecker = require('spellchecker')
webFrame.setSpellCheckProvider('en-US', {
spellCheck (words, callback) {
setTimeout(() => {
const misspelled = words.filter(x => spellchecker.isMisspelled(x))
callback(misspelled)
}, 0)
}
})
webFrame.insertCSS(css[, options])
css
string
返回 string
- 插入的 CSS 的一个键,以后可以通过 webFrame.removeInsertedCSS(key)
删除该 CSS。
将 CSS 注入当前网页并返回插入样式表的唯一键。
webFrame.removeInsertedCSS(key)
key
string
从当前网页中删除已插入的 CSS。样式表由其键标识,该键由 webFrame.insertCSS(css)
返回。
webFrame.insertText(text)
text
string
将 text
插入到聚焦元素中。
webFrame.executeJavaScript(code[, userGesture, callback])
code
stringuserGesture
boolean (可选) - 默认为false
。callback
Function (可选) - 脚本执行后调用。除非帧被挂起(例如显示模态警告),否则执行将是同步的,并且在方法返回之前会调用回调。为了与此方法的旧版本兼容,错误参数是第二个。result
Anyerror
Error
返回 Promise<any>
- 一个 Promise,它以执行代码的结果解析,如果执行抛出错误或导致 Promise 被拒绝则拒绝。
在页面中评估 code
。
在浏览器窗口中,某些 HTML API(如 requestFullScreen
)只能通过用户手势调用。将 userGesture
设置为 true
将解除此限制。
webFrame.executeJavaScriptInIsolatedWorld(worldId, scripts[, userGesture, callback])
worldId
Integer - 运行 javascript 的世界 ID,0
是默认主世界(内容运行的地方),999
是 Electron 的contextIsolation
功能使用的世界。接受 1..536870911 范围内的值。scripts
WebSource[]userGesture
boolean (可选) - 默认为false
。callback
Function (可选) - 脚本执行后调用。除非帧被挂起(例如显示模态警告),否则执行将是同步的,并且在方法返回之前会调用回调。为了与此方法的旧版本兼容,错误参数是第二个。result
Anyerror
Error
返回 Promise<any>
- 一个 Promise,它以执行代码的结果解析,如果执行无法开始则拒绝。
作用类似于 executeJavaScript
,但在隔离上下文中评估 scripts
。
请注意,当脚本执行失败时,返回的 Promise 不会拒绝,并且 result
将为 undefined
。这是因为 Chromium 不会将隔离世界的错误分派给外部世界。
webFrame.setIsolatedWorldInfo(worldId, info)
worldId
Integer - 运行 javascript 的世界的 ID,0
是默认世界,999
是 Electron 的contextIsolation
功能使用的世界。Chrome 扩展程序保留[1 << 20, 1 << 29)
范围内的 ID。您可以在此处提供任何整数。info
ObjectsecurityOrigin
string (可选) - 隔离世界的安全源。csp
string (可选) - 隔离世界的内容安全策略。name
string (可选) - 隔离世界的名称。在开发工具中有用。
设置隔离世界的安全源、内容安全策略和名称。
如果指定了 csp
,则也必须指定 securityOrigin
。
webFrame.getResourceUsage()
返回 Object
images
MemoryUsageDetailsscripts
MemoryUsageDetailscssStyleSheets
MemoryUsageDetailsxslStyleSheets
MemoryUsageDetailsfonts
MemoryUsageDetailsother
MemoryUsageDetails
返回一个描述 Blink 内部内存缓存使用信息的对象。
const { webFrame } = require('electron')
console.log(webFrame.getResourceUsage())
这将生成
{
images: {
count: 22,
size: 2549,
liveSize: 2542
},
cssStyleSheets: { /* same with "images" */ },
xslStyleSheets: { /* same with "images" */ },
fonts: { /* same with "images" */ },
other: { /* same with "images" */ }
}
webFrame.clearCache()
尝试释放不再使用的内存(例如来自先前导航的图像)。
请注意,盲目调用此方法可能会使 Electron 变慢,因为它必须重新填充这些已清空的缓存。您应该仅在应用程序中发生某个事件,使您认为页面实际使用的内存较少时才调用它(即,您已从一个超重页面导航到一个几乎空白的页面,并打算停留在那里)。
webFrame.getFrameForSelector(selector)
selector
string - 帧元素的 CSS 选择器。
返回 WebFrame
- 在 webFrame
文档中由 selector
选择的帧元素;如果 selector
未选择帧或帧不在当前渲染进程中,则返回 null
。
webFrame.findFrameByName(name)
name
string
返回 WebFrame
- webFrame
的子帧,具有提供的 name
;如果不存在此类帧或帧不在当前渲染进程中,则返回 null
。
webFrame.findFrameByRoutingId(routingId)
routingId
Integer - 一个Integer
,表示当前渲染进程中唯一的帧 ID。路由 ID 可以从WebFrame
实例 (webFrame.routingId
) 中检索,并且也通过帧特定的WebContents
导航事件(例如did-frame-navigate
)传递
返回具有所提供 routingId
的 WebFrame
,如果未找到则返回 null
。
webFrame.isWordMisspelled(word)
word
string - 要进行拼写检查的单词。
返回 boolean
- 如果根据内置拼写检查器单词拼写错误,则为 True,否则为 False。如果没有加载词典,则始终返回 False。
webFrame.getWordSuggestions(word)
word
string - 拼写错误的单词。
返回 string[]
- 给定单词的建议单词列表。如果单词拼写正确,结果将为空。
属性
webFrame.top
只读
一个 WebFrame | null
,表示 webFrame
所属的帧层次结构中的顶层帧,如果顶层帧不在当前渲染进程中,则该属性为 null
。
webFrame.opener
只读
一个 WebFrame | null
,表示打开 webFrame
的帧;如果不存在打开者或打开者不在当前渲染进程中,则该属性为 null
。
webFrame.parent
只读
一个 WebFrame | null
,表示 webFrame
的父帧;如果 webFrame
是顶层帧或父帧不在当前渲染进程中,则该属性为 null
。
webFrame.firstChild
只读
一个 WebFrame | null
,表示 webFrame
的第一个子帧;如果 webFrame
没有子帧或第一个子帧不在当前渲染进程中,则该属性为 null
。
webFrame.nextSibling
只读
一个 WebFrame | null
,表示下一个同级帧;如果 webFrame
是其父级的最后一个帧,或者下一个同级帧不在当前渲染进程中,则该属性为 null
。
webFrame.routingId
只读
一个 Integer
,表示当前渲染进程中唯一的帧 ID。引用相同底层帧的不同 WebFrame 实例将具有相同的 routingId
。