WebFrameMain API 列表

本模块包含 22 个 API。

Events（事件）

API	说明	鸿蒙支持
dom-ready	在文档加载完成时触发。	支持

Methods（方法）

API	说明	鸿蒙支持
webFrameMain.fromId(processId, routingId)	返回 WebFrameMain	undefined — 根据进程 ID 和路由 ID 查找对应的 frame，路由 ID 可从 WebFrameMain 实例的 frame.routingId 获取。
frame.executeJavaScript(code[, userGesture])	返回 Promise，resolve 值为代码执行结果。	支持
frame.reload()	返回 boolean，表示是否成功发起重新加载；若 frame 没有历史记录则返回 false。	支持
frame.isDestroyed()	返回 boolean，表示该 frame 是否已被销毁。	支持
frame.send(channel, ...args)	通过 channel 向渲染进程发送异步消息，参数使用结构化克隆算法序列化，原型链不会被包含在内。	支持
frame.postMessage(channel, message, [transfer])	向渲染进程发送消息，可选择性地转移零个或多个 MessagePortMain 对象的所有权。	支持
frame.collectJavaScriptCallStack()	返回 Promise	Promise，resolve 值为当前正在运行的 JavaScript 调用栈信息。

Properties（属性）

API	说明	鸿蒙支持
frame.ipc	限定在该 frame 作用域内的 IpcMain 实例。	支持
frame.url	字符串，表示该 frame 当前的 URL。	支持
frame.origin	字符串，表示该 frame 当前的源（按 RFC 6454 序列化），可能与 URL 不同。	支持
frame.top	WebFrameMain	null，表示该 frame 所属帧层级结构的顶层 frame。
frame.parent	WebFrameMain	null，表示该 frame 的父 frame；若为顶层 frame 则为 null。
frame.frames	WebFrameMain[] 集合，包含该 frame 的直接子 frame。	支持
frame.framesInSubtree	WebFrameMain[] 集合，包含该 frame 子树中的所有 frame（含自身），适用于遍历所有 frame。	支持
frame.frameTreeNodeId	整数，表示 frame 内部 FrameTreeNode 实例的 ID，在浏览器全局唯一，标识承载内容的 frame。	支持
frame.name	字符串，表示该 frame 的名称。	支持
frame.osProcessId	整数，表示拥有该 frame 的进程的操作系统进程 ID。	支持
frame.processId	整数，表示拥有该 frame 的进程的 Chromium 内部进程 ID，与操作系统进程 ID 不同，如需获取后者请使用 frame.osProcessId。	支持
frame.routingId	整数，表示当前渲染进程中唯一的 frame ID；指向同一底层 frame 的不同 WebFrameMain 实例具有相同的 routingId。	支持
frame.visibilityState	字符串，表示该 frame 的可见性状态。	支持
frame.detached	布尔值，表示该 frame 是否已从帧树中分离；若在页面运行 unload 监听器期间访问该 frame，可能因新页面替换了帧树中的旧 frame 而导致其变为分离状态。	支持