IPC-Kommunikation zwischen Prozessen

ipcMain.handle registriert im Hauptprozess einen benannten Kanal, der auf Anfragen des Renderers antwortet. Es akzeptiert eine asynchrone Handler-Funktion, und ihr Rückgabewert wird zum aufgelösten Wert des Promise im Renderer. Dadurch eignet es sich ideal für Vorgänge wie das Lesen von Dateien oder das Abfragen einer Datenbank.

ipcRenderer.invoke sendet eine Nachricht über einen benannten Kanal und gibt ein Promise zurück, das mit dem Rückgabewert des Handlers im Hauptprozess aufgelöst wird. Dadurch entsteht ein übersichtliches asynchrones Anfrage-Antwort-Muster, das sowohl im Preload-Skript als auch in React-Komponenten natürlich mit async/await funktioniert.

Das Preload-Skript kapselt Aufrufe von ipcRenderer.invoke und gibt sie über contextBridge frei. Beispiel: api.readFile = (filePath) => ipcRenderer.invoke('read-file', filePath). Der Renderer ruft window.api.readFile(path) auf und erhält ein Promise zurück – übersichtlich und in einer Sandbox.

Bei aktiviertem contextIsolation kann der Renderer-Prozess nicht require('electron') verwenden oder ipcRenderer direkt importieren – das Modul ist schlicht nicht verfügbar. Die gesamte IPC-Kommunikation muss über die contextBridge-Freigabe des Preload-Skripts erfolgen. Dies ist beabsichtigt: Dadurch werden XSS-Angriffe daran gehindert, auf IPC zuzugreifen.

ipcMain.on wartet auf Einweg-Nachrichten, die mit ipcRenderer.send (nicht invoke) gesendet werden. Es gibt keinen automatischen Antwortkanal – dieses Muster eignet sich für Benachrichtigungen oder Befehle, bei denen der Renderer keine Antwort benötigt, etwa zum Protokollieren von Ereignissen oder zum Auslösen einer nativen Benachrichtigung.

Der Hauptprozess kann Daten mithilfe von webContents.send('channel-name', data) an den Renderer senden. Dies ist die wichtigste Möglichkeit, wie der Hauptprozess eine Kommunikation initiiert – beispielsweise, um Dateisystem-Überwachungsereignisse oder Aktionen aus nativen Menüs an die React-Oberfläche weiterzuleiten.

Im Preload-Skript registriert ipcRenderer.on('update', callback) einen Listener für Push-Nachrichten vom Hauptprozess. Der Callback empfängt das Ereignis und alle vom Hauptprozess gesendeten Daten, die Sie anschließend über die von contextBridge bereitgestellte Funktion an den Renderer weiterleiten.

Ein sauberes Muster für Push-Ereignisse sieht so aus: api.onUpdate = (callback) => ipcRenderer.on('update', (_event, data) => callback(data)). React-Komponenten abonnieren die Ereignisse mit window.api.onUpdate(setData), und der Callback aktualisiert den Zustand, sobald der Hauptprozess neue Daten sendet.

Jeder ipcRenderer.on-Listener muss entfernt werden, sobald er nicht mehr benötigt wird, um Speicherlecks und doppelte Callbacks zu verhindern. Die Preload-Funktion sollte eine Bereinigungsfunktion zurückgeben, etwa () => ipcRenderer.removeListener('update', callback), die React aus dem Cleanup-Return von useEffect aufruft.

IPC-Eingaben aus dem Renderer sollten im Handler des Hauptprozesses als nicht vertrauenswürdige Daten behandelt werden. Validieren Sie Dateipfade immer, um Path-Traversal-Angriffe zu verhindern, bereinigen Sie Query-Parameter und prüfen Sie, ob der Ursprung des Absenders erwartet wird. Stellen Sie niemals einen generischen eval- oder exec-IPC-Kanal bereit.

Wenn Ihre Anwendung wächst, sollten Sie IPC-Kanäle mithilfe von Namespacing-Konventionen organisieren: 'fs:read-file', 'db:query', 'window:minimize'. Legen Sie die Kanalnamen in einer gemeinsamen Konstantendatei ab, die sowohl von main.js als auch vom Preload-Skript importiert wird. So verhindern Sie Tippfehler und machen Refactorings sicherer.

Was geschieht mit dem Wert, den ein ipcMain.handle-Handler zurückgibt?

IPC bildet das Rückgrat der Kommunikation in Electron. ipcMain.handle und ipcRenderer.invoke bilden ein Promise-basiertes Anfrage-Antwort-Paar für vom Renderer initiierte Vorgänge. Für vom Hauptprozess initiierte Push-Nachrichten arbeiten webContents.send und ipcRenderer.on zusammen. Jegliche IPC-Kommunikation im Renderer muss über die contextBridge des Preload-Skripts geleitet werden, und Listener sollten immer bereinigt werden, um Speicherlecks zu verhindern.