Electron コアコンセプト

Electron の本質はマルチプロセスデスクトップアプリケーションフレームワークであり、以下を組み合わせています。Chromium(レンダリング層)とNode.js(システム層)独立したプロセスモデルを通じて、UI表示、ロジック制御、安全な通信を実現します。

以下は Electron のコアアーキテクチャで、メインプロセス、レンダラープロセス、IPC通信、Preloadの関係を示しています。

メインプロセス(A):

  • Node.js を実行し、ウィンドウとシステムとのやり取りを制御します。
  • BrowserWindow を使用してレンダラープロセスを作成します。

レンダラープロセス(B):

  • 各ウィンドウは HTML/CSS/JS を独立して実行し、UIを表示します。

プリロードスクリプト(B2):

  • レンダラープロセスの読み込み前に実行され、メインプロセスとWebページ層を接続します。
  • contextBridge を通じて安全にAPIを公開します。

IPC 通信(点線の矢印):

  • メインプロセスとレンダラープロセスは ipcMain、ipcRenderer を通じて双方向通信します。

オペレーティングシステム(C):

  • メインプロセスはファイル、トレイ、通知などのシステム機能にアクセスできます。


メインプロセス(Main Process)

メインプロセスは Electron アプリの「司令塔」であり、Node.js 環境で動作します。
ウィンドウの作成、アプリのライフサイクル管理、システムAPIの呼び出し、レンダラープロセスとの通信を担当します。
アプリ全体が起動すると、システムはまずメインプロセスのスクリプトを実行します(通常はmain.js)。

メインプロセスの責務

  • アプリの起動と終了
  • BrowserWindow(ウィンドウ)の作成と破棄
  • メニュー、トレイ、グローバルショートカットの登録
  • OS機能(ファイルシステム、通知、ダイアログ)の呼び出し
  • レンダラープロセスから送信されたイベントの監視

メインプロセスのライフサイクル

メインプロセスのライフサイクルはアプリのライフサイクルと一致し、appモジュールから始まります:

サンプル

const { app, BrowserWindow } = require('electron');

app.whenReady().then(() => {
  const win = new BrowserWindow({ width: 800, height: 600 });
  win.loadFile('index.html');
});

app.on('window-all-closed', () => {
  if (process.platform !== 'darwin') app.quit();
});
  • app.whenReady():Electron の初期化完了後に発生します。
  • window-all-closed:すべてのウィンドウが閉じられたときに発生します。
  • app.quit():アプリ全体を終了します。
  • macOS でよくある特例:ユーザーがすべてのウィンドウを閉じても、プログラムはバックグラウンドで実行され続けます。

app モジュールの詳細

appモジュールはアプリ全体のライフサイクルを制御するために使用されます:

  • app.on('ready'):Electron の初期化が完了したときに発生します。
  • app.quit():アプリを終了します。
  • app.getPath('userData'):システムパスを取得します。
  • app.setAppUserModelId(id):Windows のタスクバーIDを設定します。
  • app.isPackaged:現在がパッケージング状態かどうかを判定します。

BrowserWindow ウィンドウ管理

メインプロセスはBrowserWindowを使用して可視ウィンドウを作成します:

サンプル

const win = new BrowserWindow({
  width: 1024,
  height: 768,
  resizable: true,
  webPreferences: {
    preload: './preload.js',
    nodeIntegration: false
  }
});
  • width, height:ウィンドウサイズ
  • resizable:サイズ変更が可能かどうか
  • webPreferences:レンダラープロセスの動作を設定するために使用

    • preload:プリロードスクリプト
    • nodeIntegration:レンダラープロセスでの Node.js 使用を許可するかどうか

メニュー、トレイ、ダイアログなどのネイティブ機能

Electron はシステム機能にアクセスするための複数のモジュールを提供します:

  • Menu / MenuItem:カスタムメニューバー
  • Tray:システムトレイアイコンの作成
  • Dialog:システムのファイル選択、警告ダイアログの呼び出し
  • Notification:ネイティブ通知
  • shell:外部リンクまたはファイルを開く、例:

    const { dialog } = require('electron');
    dialog.showOpenDialog({ properties: ['openFile', 'multiSelections'] });

レンダラープロセス(Renderer Process)

レンダラープロセスはUIの表示を担当し、Chromium 環境で動作します。
それぞれのBrowserWindowには独立したレンダラープロセスがあります。

レンダラープロセスの特徴

  • Chromium ベースで、HTML/CSS/JS を実行
  • デフォルトではNode.js API に直接アクセスできない(セキュリティ上の理由から)
  • Web テクノロジースタック(Vue、React、Svelte など)を使用可能
  • 各ウィンドウは独立したスレッドに対応し、互いに影響しません

マルチウィンドウとマルチレンダラープロセス

Electron の各ウィンドウ(BrowserWindow)は独立したレンダラープロセスを起動します:
1つのウィンドウを閉じても他のウィンドウには影響しません。ブラウザのマルチタブモデルに似ています。
これにより、アプリはクラッシュからの回復時により安全で信頼性が高くなります。

Webページの読み込みと表示

レンダラープロセスのコンテンツはメインプロセスによって読み込まれます:

win.loadFile('index.html');    // 加载本地页面
// 或者
win.loadURL('https://example.com'); // 加载远程网页

レンダラープロセスでの制限

  • セキュリティ上の理由から、Node.js モジュールを直接使用できません(例:fs、path)。
  • レンダラープロセスで高負荷な計算を実行することは推奨されません(UIが固まる可能性があります)。
  • システムとのやり取りはIPC通信またはpreloadで公開されたAPIを介して行う必要があります。

プロセス間通信(IPC)

Electron の核心的な仕組みの1つはメインプロセスとレンダラープロセス間の通信であり、これはIPC(Inter-Process Communication)。

ipcMain と ipcRenderer

  • ipcMain:メインプロセスで使用され、メッセージを受信します。
  • ipcRenderer:レンダラープロセスで使用され、メッセージを送信します。

単方向通信の例:

サンプル

// main.js
const { ipcMain } = require('electron');
ipcMain.on('ping', (event, arg) => {
  console.log(arg); // "hello from renderer" を出力
});

// renderer.js
const { ipcRenderer } = require('electron');
ipcRenderer.send('ping', 'hello from renderer');

双方向通信の例(メインプロセスがデータを返す):

ipcMain.on('getVersion', (event) => {
  event.reply('getVersionResponse', app.getVersion());
});

レンダラー側の受信:

ipcRenderer.on('getVersionResponse', (event, version) => {
  console.log(version);
});

invoke/handle パターン(推奨される書き方)

Electron はより簡潔な非同期リクエスト方式を提供します:

メインプロセス:

ipcMain.handle('get-app-path', () => app.getPath('userData'));

レンダラープロセス:

const result = await ipcRenderer.invoke('get-app-path');
console.log(result);

この方式はfetchリクエストに似ており、多層コールバックを回避します。

メッセージ送信のベストプラクティス

  • を使用する明確なチャンネル名(例:"user:getData")。
  • 複雑なオブジェクトの受け渡しを避ける(JSONを推奨)。
  • レンダラープロセスからのデータは、その発生元と型を検証する必要があります。
  • できるだけinvoke/handleを通じて構造化通信を実現します。

プリロードスクリプト(Preload Scripts)

プリロードスクリプトはレンダラープロセス作成前に実行され、メインプロセスとWebページの間に位置します。
その役割は、Node.js の機能をレンダラーページに安全に「橋渡し」することです。

preload の役割と意義

  • Node.js API にアクセス可能(分離されたコンテキスト内のため)
  • レンダラーページに少数のAPIを安全に公開可能
  • ファイルの読み書き、システムパスの取得、アプリ情報の受け渡しなどによく使用されます
// preload.js
const { contextBridge, ipcRenderer } = require('electron');

contextBridge.exposeInMainWorld('electronAPI', {
  getAppVersion: () => ipcRenderer.invoke('getVersion')
});

レンダラープロセスでの使用:

// index.html
<script>
  window.electronAPI.getAppVersion().then(v => {
    console.log('App version:', v);
  });
</script>

contextBridge による安全な通信

contextBridgeElectron が提供する安全なAPIであり、以下に使用されます:

  • 必要な関数のみを公開(ホワイトリスト機構)
  • 悪意のあるWebページがNode.js環境にアクセスするのを防ぐ
  • にcontextIsolation: trueモードでも安全に通信可能

サンドボックスモードでの使用

サンドボックスが有効な場合(sandbox: true)、レンダラープロセスは Node.js を完全に使用できません。
この場合、preload が唯一の橋渡し役となり、以下を担当します:

  • レンダラー側からの呼び出しを受信
  • IPC を通じてメインプロセスに転送
  • 結果をWebページ側に返す

まとめ

モジュール 役割 実行環境
メインプロセス (Main) アプリのライフサイクル、ウィンドウ、システムインターフェースを制御 Node.js
レンダラープロセス (Renderer) UIを表示し、フロントエンドロジックを実行 Chromium
IPC メインプロセスとレンダラープロセス間の通信を実現 双方向パイプ
Preload Node と Web を安全に橋渡し 中間層

一言で理解する:
メインプロセスは「中央制御室」のようなもので、レンダラープロセスは「各ウィンドウのスタッフ」のようなものです。
IPC は「トランシーバー」、Preload は「フィルタリングされた安全な通路」です。

その他の拡張