Komunikasi IPC Antarproses

ipcMain.handle mendaftarkan kanal bernama di proses utama yang merespons permintaan dari proses perender. Fungsi ini menerima fungsi penangan asinkron, dan nilai kembalinya menjadi nilai Promise yang telah diselesaikan di proses perender, sehingga ideal untuk operasi seperti membaca berkas atau mengkueri basis data.

ipcRenderer.invoke mengirim pesan melalui kanal bernama dan mengembalikan Promise yang diselesaikan dengan nilai kembalian dari penangan di proses utama. Hal ini membentuk pola permintaan dan respons asinkron yang bersih dan secara alami dapat digunakan dengan async/await baik dalam skrip pramuat maupun komponen React.

Skrip pramuat membungkus pemanggilan ipcRenderer.invoke dan mengeksposnya melalui contextBridge. Contohnya: api.readFile = (filePath) => ipcRenderer.invoke('read-file', filePath). Proses perender memanggil window.api.readFile(path) dan menerima Promise — bersih serta tersandbox.

Dengan contextIsolation yang diaktifkan, proses perender tidak dapat menggunakan require('electron') atau mengimpor ipcRenderer secara langsung — modul tersebut tidak tersedia. Semua IPC harus melewati paparan contextBridge dari skrip pramuat. Hal ini memang disengaja: cara ini mencegah serangan XSS memperoleh akses IPC.

ipcMain.on mendengarkan pesan satu arah yang dikirim dengan ipcRenderer.send (bukan invoke). Tidak ada kanal respons otomatis — pola ini cocok untuk notifikasi atau perintah yang tidak memerlukan balasan dari proses perender, seperti mencatat peristiwa atau memicu notifikasi asli.

Proses utama dapat mendorong data ke proses perender menggunakan webContents.send('channel-name', data). Ini adalah cara utama proses utama memulai komunikasi — misalnya, meneruskan peristiwa pemantauan sistem berkas atau tindakan menu asli ke UI React.

Dalam skrip pramuat, ipcRenderer.on('update', callback) mendaftarkan pendengar untuk pesan yang dikirim oleh proses utama. Fungsi panggilan balik menerima peristiwa dan data apa pun yang dikirim proses utama, lalu Anda meneruskannya ke perender melalui fungsi yang diekspos oleh contextBridge.

Pola yang rapi untuk peristiwa yang dikirim secara proaktif adalah: api.onUpdate = (callback) => ipcRenderer.on('update', (_event, data) => callback(data)). Komponen React berlangganan dengan memanggil window.api.onUpdate(setData), dan fungsi panggilan balik memperbarui status saat proses utama mengirim data baru.

Setiap pendengar ipcRenderer.on harus dihapus ketika tidak lagi diperlukan untuk mencegah kebocoran memori dan fungsi panggilan balik ganda. Fungsi pramuat harus mengembalikan fungsi pembersihan (misalnya, () => ipcRenderer.removeListener('update', callback)) yang dipanggil React dari nilai pengembalian pembersihan useEffect.

Masukan IPC dari perender harus diperlakukan sebagai data yang tidak tepercaya dalam penangan proses utama. Selalu validasi jalur berkas (cegah serangan penelusuran jalur), bersihkan parameter kueri, dan periksa apakah asal pengirim sesuai yang diharapkan. Jangan pernah mengekspos saluran IPC eval atau exec generik.

Seiring pertumbuhan aplikasi, atur saluran IPC menggunakan konvensi pemberian ruang nama: 'fs:read-file', 'db:query', 'window:minimize'. Simpan nama saluran dalam berkas konstanta bersama yang diimpor oleh main.js dan skrip pramuat untuk mencegah kesalahan ketik dan membuat pemfaktoran ulang lebih aman.

Apa yang terjadi pada nilai yang dikembalikan oleh penangan ipcMain.handle?

IPC adalah tulang punggung komunikasi Electron. ipcMain.handle dan ipcRenderer.invoke membentuk pasangan permintaan-respons berbasis Promise untuk operasi yang dimulai perender. Untuk pengiriman yang dimulai proses utama, webContents.send dan ipcRenderer.on bekerja bersama. Semua IPC di perender harus disalurkan melalui contextBridge pada pramuat, dan pendengar harus selalu dibersihkan untuk mencegah kebocoran memori.