Comunicação IPC entre processos

ipcMain.handle registra um canal nomeado no processo principal que responde às solicitações do processo de renderização. Ele aceita uma função de processamento assíncrona, e o valor retornado por ela se torna o valor resolvido da promessa no processo de renderização, o que o torna ideal para operações como ler arquivos ou consultar um banco de dados.

ipcRenderer.invoke envia uma mensagem por um canal nomeado e retorna uma promessa que é resolvida com o valor retornado pelo processador do processo principal. Isso cria um padrão assíncrono simples de solicitação e resposta, que funciona naturalmente com async/await tanto no script de pré-carregamento quanto nos componentes React.

O script de pré-carregamento encapsula chamadas a ipcRenderer.invoke e as expõe por meio do contextBridge. Por exemplo: api.readFile = (filePath) => ipcRenderer.invoke('read-file', filePath). O processo de renderização chama window.api.readFile(path) e recebe uma promessa de volta: de forma simples e em sandbox.

Com contextIsolation ativado, o processo de renderização não pode usar require('electron') nem importar ipcRenderer diretamente: o módulo simplesmente não está disponível. Toda comunicação IPC deve passar pela exposição do contextBridge no script de pré-carregamento. Isso é intencional, pois impede que ataques XSS obtenham acesso ao IPC.

ipcMain.on escuta mensagens unidirecionais enviadas com ipcRenderer.send, e não com invoke. Não há um canal de resposta automático; esse padrão é adequado para notificações ou comandos que não exigem uma resposta do processo de renderização, como registrar eventos ou acionar uma notificação nativa.

O processo principal pode enviar dados ao processo de renderização usando webContents.send('channel-name', data). Essa é a principal forma de o processo principal iniciar uma comunicação, por exemplo, encaminhando eventos de monitoramento do sistema de arquivos ou ações de menus nativos para a interface React.

No script de preload, ipcRenderer.on('update', callback) registra um ouvinte para mensagens enviadas pelo processo principal. A função de retorno recebe o evento e todos os dados enviados pelo processo principal, que então são encaminhados ao processo de renderização por meio da função exposta por contextBridge.

Um padrão claro para eventos enviados é: api.onUpdate = (callback) => ipcRenderer.on('update', (_event, data) => callback(data)). Os componentes React se inscrevem chamando window.api.onUpdate(setData), e a função de retorno atualiza o estado quando o processo principal envia novos dados.

Todo ouvinte ipcRenderer.on deve ser removido quando não for mais necessário, para evitar vazamentos de memória e funções de retorno duplicadas. A função de preload deve retornar uma função de limpeza (por exemplo, () => ipcRenderer.removeListener('update', callback)) que React chama no retorno de limpeza de useEffect.

As entradas IPC recebidas do processo de renderização devem ser tratadas como dados não confiáveis pelo manipulador do processo principal. Sempre valide os caminhos de arquivos (para impedir ataques de travessia de caminhos), higienize os parâmetros de consulta e verifique se a origem do remetente é a esperada. Nunca exponha um canal IPC genérico para eval ou exec.

À medida que seu aplicativo cresce, organize os canais IPC usando convenções de nomenclatura por espaço de nomes: 'fs:read-file', 'db:query', 'window:minimize'. Mantenha os nomes dos canais em um arquivo compartilhado de constantes, importado tanto por main.js quanto pelo script de preload, para evitar erros de digitação e tornar a refatoração mais segura.

O que acontece com o valor retornado por um manipulador ipcMain.handle?

IPC é a base da comunicação no Electron. ipcMain.handle e ipcRenderer.invoke formam um par de solicitação e resposta baseado em promessas para operações iniciadas pelo processo de renderização. Para envios iniciados pelo processo principal, webContents.send e ipcRenderer.on trabalham em conjunto. Toda comunicação IPC no processo de renderização deve passar pelo contextBridge do preload, e os ouvintes sempre devem ser removidos para evitar vazamentos de memória.