Komunikacja IPC między procesami

ipcMain.handle rejestruje nazwany kanał w procesie głównym, który odpowiada na żądania renderera. Przyjmuje asynchroniczną funkcję obsługi, a jej wartość zwracana staje się rozwiązaną wartością Promise w rendererze, dzięki czemu rozwiązanie dobrze nadaje się do operacji takich jak odczytywanie plików lub wykonywanie zapytań do bazy danych.

ipcRenderer.invoke wysyła komunikat nazwanym kanałem i zwraca Promise, który zostaje rozstrzygnięty wartością zwróconą przez funkcję obsługi w procesie głównym. Tworzy to przejrzysty asynchroniczny wzorzec żądanie–odpowiedź, który naturalnie współpracuje z async/await zarówno w skrypcie preload, jak i w komponentach React.

Skrypt preload opakowuje wywołania ipcRenderer.invoke i udostępnia je za pośrednictwem contextBridge. Na przykład: api.readFile = (filePath) => ipcRenderer.invoke('read-file', filePath). Renderer wywołuje window.api.readFile(path) i otrzymuje z powrotem Promise — w przejrzysty i izolowany sposób.

Przy włączonym contextIsolation proces renderera nie może używać require('electron') ani bezpośrednio importować ipcRenderer — moduł jest po prostu niedostępny. Cała komunikacja IPC musi odbywać się za pośrednictwem udostępnienia przez contextBridge w skrypcie preload. Jest to zamierzone: zapobiega uzyskaniu przez ataki XSS dostępu do IPC.

ipcMain.on nasłuchuje jednokierunkowych komunikatów wysyłanych za pomocą ipcRenderer.send (a nie invoke). Nie ma automatycznego kanału odpowiedzi — ten wzorzec nadaje się do powiadomień lub poleceń, w przypadku których renderer nie potrzebuje odpowiedzi, takich jak rejestrowanie zdarzeń lub wywoływanie natywnego powiadomienia.

Proces główny może przesyłać dane do renderera za pomocą webContents.send('channel-name', data). Jest to podstawowy sposób inicjowania komunikacji przez proces główny — na przykład przekazywania zdarzeń obserwowania systemu plików lub działań natywnego menu do interfejsu React.

W skrypcie preload funkcja ipcRenderer.on('update', callback) rejestruje nasłuchiwanie komunikatów push z procesu głównego. Funkcja callback otrzymuje zdarzenie oraz wszelkie dane wysłane przez proces główny, które następnie przekazuje się do renderera za pośrednictwem funkcji udostępnionej przez contextBridge.

Przejrzysty wzorzec obsługi zdarzeń push wygląda następująco: api.onUpdate = (callback) => ipcRenderer.on('update', (_event, data) => callback(data)). Komponenty Reacta subskrybują zdarzenia, wywołując window.api.onUpdate(setData), a funkcja callback aktualizuje stan, gdy proces główny wypchnie nowe dane.

Każdy nasłuchiwacz ipcRenderer.on należy usunąć, gdy nie jest już potrzebny, aby zapobiec wyciekom pamięci i wielokrotnemu wywoływaniu funkcji callback. Funkcja w skrypcie preload powinna zwracać funkcję czyszczącą, na przykład () => ipcRenderer.removeListener('update', callback), którą React wywołuje w funkcji zwracanej przez mechanizm czyszczenia useEffect.

Dane wejściowe IPC pochodzące z renderera należy traktować jako niezaufane dane w procedurze obsługi procesu głównego. Zawsze należy sprawdzać ścieżki plików, aby zapobiegać atakom typu path traversal, sanityzować parametry zapytań oraz upewniać się, że źródło nadawcy jest oczekiwane. Nigdy nie należy udostępniać ogólnego kanału IPC dla eval lub exec.

W miarę rozrastania się aplikacji należy organizować kanały IPC za pomocą konwencji przestrzeni nazw, takich jak: 'fs:read-file', 'db:query', 'window:minimize'. Nazwy kanałów należy przechowywać we wspólnym pliku stałych importowanym zarówno przez main.js, jak i skrypt preload, aby zapobiegać literówkom i bezpieczniej przeprowadzać refaktoryzację.

Co dzieje się z wartością zwróconą przez procedurę obsługi ipcMain.handle?

IPC stanowi podstawę komunikacji w Electronie. ipcMain.handle i ipcRenderer.invoke tworzą opartą na Promise parę żądanie–odpowiedź dla operacji inicjowanych przez renderer. W przypadku komunikatów push inicjowanych przez proces główny webContents.send i ipcRenderer.on współpracują ze sobą. Cała komunikacja IPC w rendererze musi być kierowana przez contextBridge skryptu preload, a nasłuchiwacze należy zawsze usuwać, aby zapobiegać wyciekom pamięci.