Electron中无法调用chess.js实例方法（preload与render进程问题）

开发基于Electron的棋盘应用时，需要在render.js中调用chess.js的move()、fen()等方法。已设置sandbox: false，并通过preload.js的contextBridge暴露获取Chess实例的方法，但在render.js中调用实例方法时均报错Uncaught TypeError: chess.move is not a function，且不想开启nodeIntegration: true。

Electron的contextBridge仅支持传递可序列化的JSON对象，Chess实例的方法挂载在原型链上，无法通过序列化传递到渲染进程，导致render.js中获取到的对象仅保留实例属性，丢失了所有原型方法。

方案一：在preload.js中封装所有需要的chess.js方法 #

通过contextBridge暴露一个封装好的API对象，每个方法对应调用Chess实例的原生方法，避免直接传递实例。

修改preload.js： #

const { contextBridge } = require('electron');
const { Chess } = require('chess.js');

// 初始化全局Chess实例
const chess = new Chess();

contextBridge.exposeInMainWorld('electronChess', {
    // 按需封装需要的方法
    move: (move) => chess.move(move),
    inCheck: () => chess.inCheck(),
    fen: () => chess.fen(),
    load: (fenStr) => chess.load(fenStr),
    clear: () => chess.clear(),
    board: () => chess.board(),
    isAttacked: (square, color) => chess.isAttacked(square, color),
    png: (options) => chess.png(options)
});

在render.js中调用： #

// 使用封装后的API
electronChess.move('e4');
console.log('当前FEN:', electronChess.fen());
console.log('是否被将军:', electronChess.inCheck());

方案二：直接在前端引入chess.js（更简便） #

将chess.js作为前端依赖安装，直接在render.js中导入使用，无需通过preload传递实例。开启contextIsolation后，前端代码无法访问Node.js环境，完全符合安全规范。

步骤： #

1. 安装依赖：

npm install chess.js

2. 在render.js中使用：

import { Chess } from 'chess.js';

// 直接创建实例并调用方法
const chess = new Chess();
chess.move('e4');
console.log('当前棋盘状态:', chess.board());
console.log('FEN字符串:', chess.fen());

两种方案均无需开启nodeIntegration: true，保持了Electron应用的安全性。方案一更适合主进程与渲染进程共享同一Chess实例的场景；方案二更适合仅在渲染进程独立使用chess.js的场景。

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