WindowManager

Defined in: main/WindowManager.ts:128

Main process window manager. Renderer calls RegisterWindow(id, props) + window.open(url, id), then this class intercepts the new window via setWindowOpenHandler / did-create-window and wraps it.

Security model:

• Iframe enforcement (main-frame-only) is handled by the generated IPC AppOrigin validator — it runs before these handlers at the IPC layer.
• Parent renderer origin is validated here via allowedOrigins config.
• Per-WebContents ownership: a renderer can only mutate windows it created. UnregisterWindow/UpdateWindow/DestroyWindow/WindowAction check that the caller’s WebContents matches the one that registered the window.

Constructors

Constructor

new WindowManager(config?): WindowManager

Defined in: main/WindowManager.ts:139

Parameters

config?

WindowManagerConfig = {}

Returns

WindowManager

Methods

destroy()

destroy(): void

Defined in: main/WindowManager.ts:695

Returns

void

---

getAllWindows()

getAllWindows(): WindowInstance[]

Defined in: main/WindowManager.ts:687

Returns

WindowInstance[]

---

getWindow()

getWindow(id): WindowInstance | undefined

Defined in: main/WindowManager.ts:683

Parameters

id

string

Returns

WindowInstance | undefined

---

getWindowState()

getWindowState(id): WindowState | null

Defined in: main/WindowManager.ts:691

Parameters

id

string

Returns

WindowState | null

---

setupForWindow()

setupForWindow(target, options?): void

Defined in: main/WindowManager.ts:237

Attach IPC handling and window.open interception to a WebContents. Works with BrowserWindow, WebContentsView, or any object with a webContents property.

Parameters

target

WebContents | BrowserWindow | { webContents: WebContents; }

options?

SetupOptions

Returns

void

Example

// BrowserWindow
manager.setupForWindow(mainWindow);

// WebContentsView (e.g., when the renderer is in a view, not the BrowserWindow itself)
manager.setupForWindow(mainView);

// With fallback handler for non-library window.open calls
manager.setupForWindow(mainView, {
  fallbackWindowOpenHandler: ({ url }) => {
    if (isExternalURL(url)) { shell.openExternal(url); return { action: "deny" }; }
    return { action: "allow" };
  },
});