Electron中如何获取webContents以查询backgroundThrottling状态

算力阿峰

2026-10-6

问题原因

webContents 是Electron主进程专属的API接口，默认不会挂载到渲染进程的window对象上，你直接读取window.webContents自然会返回undefined触发报错。你打印的window就是正常的渲染进程浏览器窗口对象，包含文档内容符合预期，并不是什么特殊的Electron全局对象。

推荐解决方案（符合Electron安全规范）

Electron官方推荐通过预加载脚本（preload）+ IPC通信的方式，将你需要的能力从主进程暴露给渲染进程，具体实现步骤如下：

调整主进程创建BrowserWindow的配置，指定预加载脚本路径

const { BrowserWindow, ipcMain } = require('electron')
const path = require('path')

const mainWindow = new BrowserWindow({
  // 其他窗口配置
  webPreferences: {
    preload: path.join(__dirname, 'preload.js') // 替换为你自己的preload脚本实际路径
  }
})

主进程添加IPC事件监听，返回当前窗口的backgroundThrottling状态

ipcMain.handle('get-background-throttling', (event) => {
  return event.sender.backgroundThrottling
})

编写preload.js预加载脚本，通过contextBridge将查询方法暴露给渲染进程

const { contextBridge, ipcRenderer } = require('electron')

contextBridge.exposeInMainWorld('electronUtils', {
  getBackgroundThrottling: () => ipcRenderer.invoke('get-background-throttling')
})

渲染进程index.html中直接调用暴露的方法即可

window.addEventListener('blur', async () => {
  const isThrottlingEnabled = await window.electronUtils.getBackgroundThrottling()
  if (isThrottlingEnabled) {
    // 你的业务逻辑
  }
})

快速测试方案（仅本地开发可用，不推荐生产环境使用）

如果你只是做个人小项目不需要严格安全校验，也可以开启node集成并关闭上下文隔离，直接通过remote模块获取webContents：

主进程创建窗口时添加配置：

const mainWindow = new BrowserWindow({
  webPreferences: {
    nodeIntegration: true,
    contextIsolation: false
  }
})

渲染进程中直接调用（Electron 14及以上版本需要先安装@electron/remote依赖并在主进程初始化）

window.addEventListener('blur', () => {
  const currentWebContents = require('@electron/remote').getCurrentWebContents()
  if (currentWebContents.backgroundThrottling) {
    // 你的业务逻辑
  }
})

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