printServer/electron/preload.cjs

72 lines
2.3 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

const { contextBridge, ipcRenderer } = require('electron');
/**
* 预加载脚本 — 通过 contextBridge 暴露安全的 IPC API 到渲染进程。
* 渲染进程通过 window.printServerAPI 调用,不再直接连接 WebSocket。
*/
contextBridge.exposeInMainWorld('printServerAPI', {
/**
* 调用后端服务方法(替代 wsSendWithCallback)
* @param {string} method 服务方法路径,如 'printer.getWindowsPrinters'
* @param {any} data 请求参数
* @returns {Promise<{success: boolean, method: string, result: any}>}
*/
callService: (method, data) =>
ipcRenderer.invoke('service:call', method, data),
/**
* 监听服务端推送事件(替代 wsOn)
* @param {string} method 事件名
* @param {Function} callback 接收 {success, method, result}
* @returns {Function} 取消订阅函数
*/
onEvent: (method, callback) => {
const handler = (_event, payload) => {
if (payload.method === method) callback(payload);
};
ipcRenderer.on('service:event', handler);
return () => ipcRenderer.removeListener('service:event', handler);
},
/**
* 获取后端连接状态
* @returns {Promise<string>} 'connected' | 'disconnected'
*/
getBackendStatus: () =>
ipcRenderer.invoke('service:getBackendStatus'),
/**
* 监听后端连接状态变化(替代 setWsClientStatus 回调)
* @param {Function} callback
* @returns {Function} 取消订阅函数
*/
onBackendStatusChange: (callback) => {
const handler = (_event, status) => callback(status);
ipcRenderer.on('backend:status', handler);
return () => ipcRenderer.removeListener('backend:status', handler);
},
/**
* 获取后端 HTTP 端口(用于直接调用 HTTP API)
* @returns {Promise<number>}
*/
getHttpPort: () =>
ipcRenderer.invoke('service:getHttpPort'),
/**
* 通过 IPC 代理调用后端 HTTP API
* @param {string} path API 路径,如 '/api/hikvision/files?page=1'
* @param {object} options { method, body }
* @returns {Promise<object>}
*/
callApi: (path, options) =>
ipcRenderer.invoke('service:callApi', path, options || {}),
/**
* 打开文件夹选择对话框
* @returns {Promise<{canceled: boolean, path?: string}>}
*/
selectFolder: () =>
ipcRenderer.invoke('dialog:openFolder')
});