fix(preload): 修复上下文隔离时 ipcRenderer 经 contextBridge 暴露无效的问题 · Pull Request !9 · dromara/electron-egg

## 问题

开启 `contextIsolation: true` 并使用 `preload/bridge.ts` 时，`window.electron.ipcRenderer` 下的方法（如 `removeAllListeners`、`on`、`send`）调用报错或监听不到消息，与未隔离时的行为不一致。

根因：`bridge.ts` 直接将 `ipcRenderer` 实例暴露给 `contextBridge.exposeInMainWorld`。Electron 从 PR [#40330](https://github.com/electron/electron/pull/40330) 起已不再支持将 `ipcRenderer` 直接经由 contextBridge 传递（changelog 原文：`ipcRenderer can no longer be sent over the contextBridge`）。contextBridge 代理只拷贝对象自有可枚举属性，且代理函数的接收者为代理对象而非原实例，导致原型链上的方法丢失、依赖内部状态的方法调用失败。

官方文档（[context-bridge](https://www.electronjs.org/docs/latest/api/context-bridge) / [context-isolation 教程](https://www.electronjs.org/docs/latest/tutorial/context-isolation)）给出的正反示例：

```js
// ❌ Bad code
contextBridge.exposeInMainWorld('myAPI', {
  send: ipcRenderer.send
})

// ✅ Good code
contextBridge.exposeInMainWorld('myAPI', {
  loadPreferences: () => ipcRenderer.invoke('load-prefs')
})
```

## 改动

按官方推荐模式，将 `ipcRenderer` 的每个方法包装为普通函数后在 preload 上下文中导出（闭包持有真正的 `ipcRenderer`，不依赖跨上下文丢失的 `this`）：

- `invoke` / `sendSync` / `send` / `postMessage` / `sendToHost`
- `on` / `once` / `removeListener` / `removeAllListeners`

仅改动 `electron/preload/bridge.ts` 一个文件，不影响 `contextIsolation: false` 的默认用法，也未改动其他任何默认配置。

## 验证

- 依据 Electron 39.8.10 的 `electron.d.ts` 做过严格模式类型检查，通过；
- 参照 Electron 源码 `shell/renderer/api/electron_api_context_bridge.cc` 的代理语义做了行为仿真：旧写法（直接暴露）下 `invoke`/`on`/`removeAllListeners` 全部失效，新写法（函数包装）全部可用；
- `frontend/src/utils/ipcRenderer.js` 中已有 `window.electron` 回退逻辑，修复后上下文隔离模式下可直接使用，无需改动。

类型	指派人员	状态
审查	哆啦好梦	进行中 (0/1人)
测试	哆啦好梦	进行中 (0/1人)

GVPdromara / electron-egg

搜索帮助

GVP dromara / electron-egg