webFrame API 列表

本模块包含 25 个 API。

Methods(方法)

API 说明 鸿蒙支持
webFrame.setZoomFactor(factor) 将缩放因子设置为指定值,缩放因子等于缩放百分比除以 100,例如 300% 对应 3.0。 支持
webFrame.getZoomFactor() 返回 number — 当前缩放因子。 支持
webFrame.setZoomLevel(level) 将缩放级别设置为指定值,原始大小为 0,每增减 1 级对应放大或缩小 20%,默认限制范围为原始尺寸的 50%(缩小上限)到 300%(放大上限)。 支持
webFrame.getZoomLevel() 返回 number — 当前缩放级别。 支持
webFrame.setVisualZoomLevelLimits(minimumLevel, maximumLevel) 设置双指缩放的最大和最小缩放级别。 支持
webFrame.setSpellCheckProvider(language, provider) 为输入框和文本区域设置拼写检查提供程序。 支持
webFrame.insertCSS(css[, options]) 返回 string — 插入的 CSS 的标识键,可用于后续移除该样式。 支持
webFrame.removeInsertedCSS(key) 从当前网页中移除之前插入的 CSS,通过 webFrame.insertCSS(css) 返回的键来标识目标样式表。 支持
webFrame.insertText(text) 向当前聚焦的元素插入文本。 支持
webFrame.executeJavaScript(code[, userGesture, callback]) 返回 Promise,resolve 值为代码执行结果;若 frame 被挂起(如显示模态对话框),执行将同步进行,回调在方法返回前调用。 支持
webFrame.executeJavaScriptInIsolatedWorld(worldId, scripts[, userGesture, callback]) 返回 Promise,resolve 值为代码执行结果;worldId 范围为 1..536870911,0 为默认主世界,999 为 Electron contextIsolation 使用的隔离世界。 支持
webFrame.setIsolatedWorldInfo(worldId, info) 设置隔离世界的安全源、内容安全策略和名称;若指定了 csp,则必须同时指定 securityOrigin。 支持
webFrame.getResourceUsage() 返回包含资源使用情况的对象。 支持
webFrame.clearCache() 尝试释放不再使用的内存(如前一次导航遗留的图片缓存)。 支持
webFrame.getFrameForSelector(selector) 返回 WebFrame — webFrame 文档中与给定选择器匹配的 frame 元素。 支持
webFrame.findFrameByName(name) 返回 WebFrame — webFrame 中指定名称的子 frame,未找到则返回 null。 支持
webFrame.findFrameByRoutingId(routingId) 返回 WebFrame — 当前渲染进程中具有指定 routingId 的 frame,未找到则返回 null;routingId 可从 WebFrame 实例或帧相关的 WebContents 导航事件中获取。 支持
webFrame.isWordMisspelled(word) 返回 boolean,根据内置拼写检查器判断该单词是否拼写错误。 支持
webFrame.getWordSuggestions(word) 返回 string[] — 针对给定单词的拼写建议列表。 支持

Properties(属性)

API 说明 鸿蒙支持
webFrame.top WebFrame null,表示 webFrame 所属帧层级结构的顶层 frame;若顶层 frame 不在当前渲染进程中则为 null。
webFrame.opener WebFrame null,表示打开 webFrame 的 frame;若无 opener 或 opener 不在当前渲染进程中则为 null。
webFrame.parent WebFrame null,表示 webFrame 的父 frame;若 webFrame 为顶层或父 frame 不在当前渲染进程中则为 null。
webFrame.firstChild WebFrame null,表示 webFrame 的第一个子 frame;若无子 frame 或首个子 frame 不在当前渲染进程中则为 null。
webFrame.nextSibling WebFrame null,表示下一个兄弟 frame;若 webFrame 是父级的最后一个子 frame 或下一个兄弟不在当前渲染进程中则为 null。
webFrame.routingId 整数,表示当前渲染进程中唯一的 frame ID;指向同一底层 frame 的不同 WebFrame 实例具有相同的 routingId。 支持