Electron中如何为渲染进程打开的新窗口执行预加载脚本？

我正在开发一款基于Web应用封装的Electron应用，希望用户点击按钮时打开新窗口拓展视图。目前通过渲染进程的window.open(...)能成功打开新窗口，窗口移动等参数正常，但新窗口里不存在window.application——主窗口通过预加载脚本在window对象上暴露的这个对象，在新窗口里没加载出来，预加载脚本根本没执行。

我试过以下方案都没解决：

• 在webContents.setWindowOpenHandler里配置overrideBrowserWindowOptions，指定预加载脚本路径，同时开启nodeIntegration等参数：

action: ActionType.Allow,
overrideBrowserWindowOptions: {
  fullscreen: isFullscreenEnabled(details),
  webPreferences: {
    devTools: true,
    nodeIntegration: true,
    nodeIntegrationInSubFrames: true,
    preload: '/absolute/path/to/preload.ts',
  },
}

• 渲染进程调用window.open时，在features参数里传入nodeIntegrationInSubFrames: true
• 用new BrowserWindow(...)创建窗口，在webPreferences里配置nodeIntegrationInSubFrames: true

请问怎么让渲染进程打开的新窗口执行预加载脚本？

1. 确保预加载脚本路径指向编译后的JS文件 #

Electron的preload参数要求传入编译后的JS文件绝对路径，直接用.ts文件路径会导致识别失败。可以用path.resolve结合app.getAppPath()生成正确路径：

const path = require('path');
const { app } = require('electron');

// 在setWindowOpenHandler的overrideBrowserWindowOptions中配置
webPreferences: {
  preload: path.resolve(app.getAppPath(), 'dist/preload.js'), // 替换为你实际的编译后文件路径
  contextIsolation: false, // 若预加载脚本直接挂载window对象需关闭；用contextBridge则保持true
  sandbox: false, // 沙箱模式会限制预加载脚本执行，必须关闭
}

2. 正确配置上下文隔离 #

如果预加载脚本通过contextBridge暴露API（推荐安全做法），需保持contextIsolation: true，并确保预加载脚本代码正确：

// 预加载脚本示例
const { contextBridge } = require('electron');

contextBridge.exposeInMainWorld('application', {
  // 这里定义要暴露给渲染进程的API方法
  openSettings: () => { /* 具体实现 */ }
});

若直接给window对象添加属性，则必须关闭contextIsolation，同时不建议开启nodeIntegration（存在安全风险）。

3. 关闭沙箱模式 #

Electron默认启用的沙箱模式会阻止预加载脚本在子窗口中执行，因此必须在webPreferences中显式设置sandbox: false。

4. 确保新窗口URL与主窗口同源 #

如果新窗口加载的URL和主窗口不同源，Electron的安全策略会限制预加载脚本执行。确保新窗口加载同域内容，或开发环境下临时设置webSecurity: false（生产环境禁用）。

5. 拦截window.open自定义创建窗口（兜底方案） #

若以上方法均无效，可在setWindowOpenHandler中阻止默认行为，手动创建BrowserWindow并配置预加载：

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

webContents.setWindowOpenHandler((details) => {
  const newWindow = new BrowserWindow({
    webPreferences: {
      preload: path.resolve(app.getAppPath(), 'dist/preload.js'),
      contextIsolation: true,
      sandbox: false,
    }
  });
  newWindow.loadURL(details.url);
  return { action: 'deny' }; // 阻止默认的window.open窗口创建
});

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