electron中preload.js文件的用法

在Electron中，preload.js文件扮演着非常重要的角色，它允许你在渲染进程中的全局作用域里安全地、有选择地集成Node.js和Electron的API。这是一种在保持渲染进程与主进程隔离的同时，又能使渲染进程具有访问特定Electron API的能力的方法。这种做法符合Electron的安全最佳实践，尤其是在使用了contextIsolation的情况下。

作用和重要性

安全性：自从Electron 12起，contextIsolation默认启用。这意味着渲染器的全局环境（如 window 对象）与Electron API 和 Node.js 是隔离的。preload.js 作为一个中间层，可以安全地在这两个环境之间进行沟通。
暴露API给渲染进程：通过preload.js，开发者可以精确控制哪些Node.js和Electron的API可以在网页中使用，而不是将整个Node.js API暴露给可能存在安全风险的前端环境。这样可以防止恶意脚本利用Node.js的功能来攻击系统。
自定义脚本加载：在加载网页之前，preload.js 允许你先行注入自定义的JavaScript代码，为网页提供必要的Node.js功能或配置。

如何使用`preload.js`

在Electron的BrowserWindow配置中指定preload.js路径。这个脚本在网页加载之前执行，但在网页的JavaScript开始运行之后：

const { app, BrowserWindow } = require('electron');
let mainWindow;

function createWindow() {
    mainWindow = new BrowserWindow({
        width: 800,
        height: 600,
        webPreferences: {
            preload: path.join(__dirname, 'preload.js'),
            contextIsolation: true, // 推荐开启
            enableRemoteModule: false // 推荐禁用，用ipcMain和ipcRenderer代替
        }
    });

    mainWindow.loadFile('index.html');
}

app.on('ready', createWindow);

示例 `preload.js`

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

contextBridge.exposeInMainWorld(
    'api', {
        send: (channel, data) => {
            // 白名单通道
            let validChannels = ['toMain'];
            if (validChannels.includes(channel)) {
                ipcRenderer.send(channel, data);
            }
        },
        receive: (channel, func) => {
            let validChannels = ['fromMain'];
            if (validChannels.includes(channel)) {
                // 过滤通道，只接受预定义的通道
                ipcRenderer.on(channel, (event, ...args) => func(...args));
            }
        }
    }
);