Electron中window.webContents.ipc为null报错的问题求助

报错原因 #

你遇到的错误是因为window.webContents.ipc为null，主要有两个常见诱因：

1. Electron版本过低：webContents.ipc是Electron v28.0.0及以上版本新增的API，若使用版本低于此，该属性会返回null。
2. webContents未完全初始化：创建BrowserWindow后立即访问webContents.ipc，可能碰到webContents尚未完成初始化的情况。

解决方案 #

1. 升级Electron版本

先检查当前Electron版本：

electron -v

若版本低于v28.0.0，执行升级命令：

npm install electron@latest --save-dev

2. 等待webContents就绪后注册事件

修改代码，确保在webContents完全初始化后再注册IPC事件，推荐两种实现方式：

方式一：异步等待页面加载完成

const { BrowserWindow } = require('electron');

async function createWindow() {
  let window = new BrowserWindow({ title: "First Window" });
  // 等待页面加载完成后再操作
  await window.loadFile("public/index.html");
  // 注册窗口专属IPC事件
  window.webContents.ipc.on('my-window-event', () => {
    console.log('my-window-event received');
  });
}

createWindow();

方式二：监听web-contents-created事件

const { BrowserWindow } = require('electron');

let window = new BrowserWindow({ title: "First Window" });
// 监听webContents创建完成的事件
window.on('web-contents-created', () => {
  window.webContents.ipc.on('my-window-event', () => {
    console.log('my-window-event received');
  });
});
window.loadFile("public/index.html");

补充说明 #

使用webContents.ipc时，渲染进程需要通过ipcRenderer.sendTo()或对应方法，将事件发送到目标窗口的webContentsID，示例（渲染进程代码）：

const { ipcRenderer } = require('electron');
// 需确保渲染进程已获取目标窗口的webContentsID
ipcRenderer.sendTo(webContentsId, 'my-window-event');

内容的提问来源于stack exchange，提问作者David