[!info] related notes

• 所属 MOC: Electron MOC
• 前置概念: Electron 主进程, Electron 进程模型
• 并列概念: Electron preload 脚本, Electron WebContents, Electron contextIsolation, Electron 进程沙箱
• 易混淆概念: Electron 渲染进程
• 关系笔记: Electron

Electron BrowserWindow

一句话定义

BrowserWindow 是 Electron 中创建和管理窗口的核心对象，也是配置页面运行时边界的关键入口。

核心内容

它为什么重要

很多真正决定 Electron 行为和安全性的选项，都集中在 webPreferences 里。

也就是说，BrowserWindow 不只是“开个窗”，而是在定义：

• 这个页面加载什么
• 页面能拿到哪些能力
• preload 怎么注入
• 隔离和沙箱是否生效

常见关注点

• preload
• contextIsolation
• sandbox
• nodeIntegration
• 窗口尺寸、标题、显示时机、开发工具等行为项

一个实用理解

BrowserWindow 是把：

• 主进程的控制能力
• 渲染进程的页面运行时
• preload 的桥接层

串到一起的地方。

边界与易混淆点

• BrowserWindow 不是普通网页里的 window 对象
• “窗口配置”不只是 UI 外观配置，很多其实是运行时边界配置
• 如果 BrowserWindow 的安全默认值被随意改掉，后面的 preload 和 IPC 设计很容易失效