[!info] related notes

• 所属 MOC: Electron MOC
• 前置概念: Electron BrowserWindow, Electron IPC 模式
• 并列概念: Electron 渲染进程, Electron 主进程
• 关系笔记: Electron 架构总览

Electron WebContents

一句话定义

WebContents 可以理解成 Electron 里页面内容的运行载体，也是 main 与特定 renderer 建立联系的重要对象。

核心内容

为什么它重要

主进程如果想主动对某个窗口里的页面做事，通常不会“直接找 renderer”，而是通过对应的 WebContents：

• 发消息
• 控制加载行为
• 观察页面状态

它和 BrowserWindow 的关系

• BrowserWindow 更像窗口容器
• WebContents 更像容器里的页面内容载体

在很多场景下，你要操作的其实不是窗口外壳，而是页面内容本身。

边界与易混淆点

• WebContents 不是 DOM，也不是浏览器里的 window
• 它更接近“主进程视角下的页面运行实例”