import { expect } from 'chai'; import * as path from 'node:path'; import { BrowserView, BrowserWindow, screen, webContents } from 'electron/main'; import { closeWindow } from './lib/window-helpers'; import { defer, ifit, startRemoteControlApp } from './lib/spec-helpers'; import { ScreenCapture } from './lib/screen-helpers'; import { once } from 'node:events'; describe('BrowserView module', () => { const fixtures = path.resolve(__dirname, 'fixtures'); let w: BrowserWindow; let view: BrowserView; beforeEach(() => { expect(webContents.getAllWebContents().length).to.equal(0, 'expected no webContents to exist'); w = new BrowserWindow({ show: false, width: 400, height: 400, webPreferences: { backgroundThrottling: false } }); }); afterEach(async () => { if (!w.isDestroyed()) { const p = once(w.webContents, 'destroyed'); await closeWindow(w); w = null as any; await p; } if (view && view.webContents) { const p = once(view.webContents, 'destroyed'); view.webContents.destroy(); view = null as any; await p; } expect(webContents.getAllWebContents().length).to.equal(0, 'expected no webContents to exist'); }); it('sets the correct class name on the prototype', () => { expect(BrowserView.prototype.constructor.name).to.equal('BrowserView'); }); it('can be created with an existing webContents', async () => { const wc = (webContents as typeof ElectronInternal.WebContents).create({ sandbox: true }); await wc.loadURL('about:blank'); view = new BrowserView({ webContents: wc } as any); expect(view.webContents === wc).to.be.true('view.webContents === wc'); expect(view.webContents.getURL()).to.equal('about:blank'); }); it('has type browserView', () => { view = new BrowserView(); expect(view.webContents.getType()).to.equal('browserView'); }); describe('BrowserView.setBackgroundColor()', () => { it('does not throw for valid args', () => { view = new BrowserView(); view.setBackgroundColor('#000'); }); // We now treat invalid args as "no background". it('does not throw for invalid args', () => { view = new BrowserView(); expect(() => { view.setBackgroundColor({} as any); }).not.to.throw(); }); // Linux and arm64 platforms (WOA and macOS) do not return any capture sources ifit(process.platform === 'darwin' && process.arch === 'x64')('sets the background color to transparent if none is set', async () => { const display = screen.getPrimaryDisplay(); const WINDOW_BACKGROUND_COLOR = '#55ccbb'; w.show(); w.setBounds(display.bounds); w.setBackgroundColor(WINDOW_BACKGROUND_COLOR); await w.loadURL('about:blank'); view = new BrowserView(); view.setBounds(display.bounds); w.setBrowserView(view); await view.webContents.loadURL('data:text/html,hello there'); const screenCapture = await ScreenCapture.createForDisplay(display); await screenCapture.expectColorAtCenterMatches(WINDOW_BACKGROUND_COLOR); }); // Linux and arm64 platforms (WOA and macOS) do not return any capture sources ifit(process.platform === 'darwin' && process.arch === 'x64')('successfully applies the background color', async () => { const WINDOW_BACKGROUND_COLOR = '#55ccbb'; const VIEW_BACKGROUND_COLOR = '#ff00ff'; const display = screen.getPrimaryDisplay(); w.show(); w.setBounds(display.bounds); w.setBackgroundColor(WINDOW_BACKGROUND_COLOR); await w.loadURL('about:blank'); view = new BrowserView(); view.setBounds(display.bounds); w.setBrowserView(view); w.setBackgroundColor(VIEW_BACKGROUND_COLOR); await view.webContents.loadURL('data:text/html,hello there'); const screenCapture = await ScreenCapture.createForDisplay(display); await screenCapture.expectColorAtCenterMatches(VIEW_BACKGROUND_COLOR); }); }); describe('BrowserView.setAutoResize()', () => { it('does not throw for valid args', () => { view = new BrowserView(); view.setAutoResize({}); view.setAutoResize({ width: true, height: false }); }); it('throws for invalid args', () => { view = new BrowserView(); expect(() => { view.setAutoResize(null as any); }).to.throw(/Invalid auto resize options/); }); it('does not resize when the BrowserView has no AutoResize', () => { view = new BrowserView(); w.addBrowserView(view); view.setBounds({ x: 0, y: 0, width: 400, height: 200 }); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 400, height: 200 }); w.setSize(800, 400); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 400, height: 200 }); }); it('resizes horizontally when the window is resized horizontally', () => { view = new BrowserView(); view.setAutoResize({ width: true, height: false }); w.addBrowserView(view); view.setBounds({ x: 0, y: 0, width: 400, height: 200 }); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 400, height: 200 }); w.setSize(800, 400); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 800, height: 200 }); }); it('resizes vertically when the window is resized vertically', () => { view = new BrowserView(); view.setAutoResize({ width: false, height: true }); w.addBrowserView(view); view.setBounds({ x: 0, y: 0, width: 200, height: 400 }); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 200, height: 400 }); w.setSize(400, 800); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 200, height: 800 }); }); it('resizes both vertically and horizontally when the window is resized', () => { view = new BrowserView(); view.setAutoResize({ width: true, height: true }); w.addBrowserView(view); view.setBounds({ x: 0, y: 0, width: 400, height: 400 }); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 400, height: 400 }); w.setSize(800, 800); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 800, height: 800 }); }); it('resizes proportionally', () => { view = new BrowserView(); view.setAutoResize({ width: true, height: false }); w.addBrowserView(view); view.setBounds({ x: 0, y: 0, width: 200, height: 100 }); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 200, height: 100 }); w.setSize(800, 400); expect(view.getBounds()).to.deep.equal({ x: 0, y: 0, width: 600, height: 100 }); }); it('does not move x if horizontal: false', () => { view = new BrowserView(); view.setAutoResize({ width: true }); w.addBrowserView(view); view.setBounds({ x: 200, y: 0, width: 200, height: 100 }); w.setSize(800, 400); expect(view.getBounds()).to.deep.equal({ x: 200, y: 0, width: 600, height: 100 }); }); it('moves x if horizontal: true', () => { view = new BrowserView(); view.setAutoResize({ horizontal: true }); w.addBrowserView(view); view.setBounds({ x: 200, y: 0, width: 200, height: 100 }); w.setSize(800, 400); expect(view.getBounds()).to.deep.equal({ x: 400, y: 0, width: 400, height: 100 }); }); it('moves x if horizontal: true width: true', () => { view = new BrowserView(); view.setAutoResize({ horizontal: true, width: true }); w.addBrowserView(view); view.setBounds({ x: 200, y: 0, width: 200, height: 100 }); w.setSize(800, 400); expect(view.getBounds()).to.deep.equal({ x: 400, y: 0, width: 400, height: 100 }); }); }); describe('BrowserView.setBounds()', () => { it('does not throw for valid args', () => { view = new BrowserView(); view.setBounds({ x: 0, y: 0, width: 1, height: 1 }); }); it('throws for invalid args', () => { view = new BrowserView(); expect(() => { view.setBounds(null as any); }).to.throw(/conversion failure/); expect(() => { view.setBounds({} as any); }).to.throw(/conversion failure/); }); it('can set bounds after view is added to window', () => { view = new BrowserView(); const bounds = { x: 0, y: 0, width: 50, height: 50 }; w.addBrowserView(view); view.setBounds(bounds); expect(view.getBounds()).to.deep.equal(bounds); }); it('can set bounds before view is added to window', () => { view = new BrowserView(); const bounds = { x: 0, y: 0, width: 50, height: 50 }; view.setBounds(bounds); w.addBrowserView(view); expect(view.getBounds()).to.deep.equal(bounds); }); it('can update bounds', () => { view = new BrowserView(); w.addBrowserView(view); const bounds1 = { x: 0, y: 0, width: 50, height: 50 }; view.setBounds(bounds1); expect(view.getBounds()).to.deep.equal(bounds1); const bounds2 = { x: 0, y: 150, width: 50, height: 50 }; view.setBounds(bounds2); expect(view.getBounds()).to.deep.equal(bounds2); }); }); describe('BrowserView.getBounds()', () => { it('returns the current bounds', () => { view = new BrowserView(); const bounds = { x: 10, y: 20, width: 30, height: 40 }; view.setBounds(bounds); expect(view.getBounds()).to.deep.equal(bounds); }); it('does not changer after being added to a window', () => { view = new BrowserView(); const bounds = { x: 10, y: 20, width: 30, height: 40 }; view.setBounds(bounds); expect(view.getBounds()).to.deep.equal(bounds); w.addBrowserView(view); expect(view.getBounds()).to.deep.equal(bounds); }); }); describe('BrowserWindow.setBrowserView()', () => { it('does not throw for valid args', () => { view = new BrowserView(); w.setBrowserView(view); }); it('does not throw if called multiple times with same view', () => { view = new BrowserView(); w.setBrowserView(view); w.setBrowserView(view); w.setBrowserView(view); }); }); describe('BrowserWindow.getBrowserView()', () => { it('returns the set view', () => { view = new BrowserView(); w.setBrowserView(view); const view2 = w.getBrowserView(); expect(view2!.webContents.id).to.equal(view.webContents.id); }); it('returns null if none is set', () => { const view = w.getBrowserView(); expect(view).to.be.null('view'); }); it('throws if multiple BrowserViews are attached', () => { view = new BrowserView(); w.setBrowserView(view); const view2 = new BrowserView(); defer(() => view2.webContents.destroy()); w.addBrowserView(view2); defer(() => w.removeBrowserView(view2)); expect(() => { w.getBrowserView(); }).to.throw(/has multiple BrowserViews/); }); }); describe('BrowserWindow.addBrowserView()', () => { it('does not throw for valid args', () => { const view1 = new BrowserView(); defer(() => view1.webContents.destroy()); w.addBrowserView(view1); defer(() => w.removeBrowserView(view1)); const view2 = new BrowserView(); defer(() => view2.webContents.destroy()); w.addBrowserView(view2); defer(() => w.removeBrowserView(view2)); }); it('does not throw if called multiple times with same view', () => { view = new BrowserView(); w.addBrowserView(view); w.addBrowserView(view); w.addBrowserView(view); }); it('does not crash if the webContents is destroyed after a URL is loaded', () => { view = new BrowserView(); expect(async () => { view.setBounds({ x: 0, y: 0, width: 400, height: 300 }); await view.webContents.loadURL('data:text/html,hello there'); view.webContents.destroy(); }).to.not.throw(); }); it('can handle BrowserView reparenting', async () => { view = new BrowserView(); expect(view.ownerWindow).to.be.null('ownerWindow'); w.addBrowserView(view); view.webContents.loadURL('about:blank'); await once(view.webContents, 'did-finish-load'); expect(view.ownerWindow).to.equal(w); const w2 = new BrowserWindow({ show: false }); w2.addBrowserView(view); expect(view.ownerWindow).to.equal(w2); w.close(); view.webContents.loadURL(`file://${fixtures}/pages/blank.html`); await once(view.webContents, 'did-finish-load'); // Clean up - the afterEach hook assumes the webContents on w is still alive. w = new BrowserWindow({ show: false }); w2.close(); w2.destroy(); }); it('allows attaching a BrowserView with a previously-closed webContents', async () => { const w2 = new BrowserWindow({ show: false }); const view = new BrowserView(); expect(view.ownerWindow).to.be.null('ownerWindow'); view.webContents.close(); w2.addBrowserView(view); expect(view.ownerWindow).to.equal(w2); w2.webContents.loadURL('about:blank'); await once(w2.webContents, 'did-finish-load'); w2.close(); }); it('allows attaching a BrowserView with a previously-destroyed webContents', async () => { const view = new BrowserView(); expect(view.ownerWindow).to.be.null('ownerWindow'); view.webContents.destroy(); w.addBrowserView(view); expect(view.ownerWindow).to.equal(w); w.webContents.loadURL('about:blank'); await once(w.webContents, 'did-finish-load'); }); }); describe('BrowserWindow.removeBrowserView()', () => { it('does not throw if called multiple times with same view', () => { expect(() => { view = new BrowserView(); w.addBrowserView(view); w.removeBrowserView(view); w.removeBrowserView(view); }).to.not.throw(); }); it('can be called on a BrowserView with a destroyed webContents', async () => { view = new BrowserView(); w.addBrowserView(view); await view.webContents.loadURL('data:text/html,hello there'); const destroyed = once(view.webContents, 'destroyed'); view.webContents.close(); await destroyed; w.removeBrowserView(view); }); }); describe('BrowserWindow.getBrowserViews()', () => { it('returns same views as was added', () => { const view1 = new BrowserView(); defer(() => view1.webContents.destroy()); w.addBrowserView(view1); defer(() => w.removeBrowserView(view1)); const view2 = new BrowserView(); defer(() => view2.webContents.destroy()); w.addBrowserView(view2); defer(() => w.removeBrowserView(view2)); const views = w.getBrowserViews(); expect(views).to.have.lengthOf(2); expect(views[0].webContents.id).to.equal(view1.webContents.id); expect(views[1].webContents.id).to.equal(view2.webContents.id); }); it('persists ordering by z-index', () => { const view1 = new BrowserView(); defer(() => view1.webContents.destroy()); w.addBrowserView(view1); defer(() => w.removeBrowserView(view1)); const view2 = new BrowserView(); defer(() => view2.webContents.destroy()); w.addBrowserView(view2); defer(() => w.removeBrowserView(view2)); w.setTopBrowserView(view1); const views = w.getBrowserViews(); expect(views).to.have.lengthOf(2); expect(views[0].webContents.id).to.equal(view2.webContents.id); expect(views[1].webContents.id).to.equal(view1.webContents.id); }); }); describe('BrowserWindow.setTopBrowserView()', () => { it('should throw an error when a BrowserView is not attached to the window', () => { view = new BrowserView(); expect(() => { w.setTopBrowserView(view); }).to.throw(/is not attached/); }); it('should throw an error when a BrowserView is attached to some other window', () => { view = new BrowserView(); const win2 = new BrowserWindow(); w.addBrowserView(view); view.setBounds({ x: 0, y: 0, width: 100, height: 100 }); win2.addBrowserView(view); expect(() => { w.setTopBrowserView(view); }).to.throw(/is not attached/); win2.close(); win2.destroy(); }); it('should reorder the BrowserView to the top if it is already in the window', () => { view = new BrowserView(); const view2 = new BrowserView(); defer(() => view2.webContents.destroy()); w.addBrowserView(view); w.addBrowserView(view2); defer(() => w.removeBrowserView(view2)); w.setTopBrowserView(view); const views = w.getBrowserViews(); expect(views.indexOf(view)).to.equal(views.length - 1); }); }); describe('BrowserView owning window', () => { it('points to owning window', () => { view = new BrowserView(); expect(view.webContents.getOwnerBrowserWindow()).to.be.null('owner browser window'); expect(view.ownerWindow).to.be.null('ownerWindow'); w.setBrowserView(view); expect(view.webContents.getOwnerBrowserWindow()).to.equal(w); expect(view.ownerWindow).to.equal(w); w.setBrowserView(null); expect(view.webContents.getOwnerBrowserWindow()).to.be.null('owner browser window'); expect(view.ownerWindow).to.be.null('ownerWindow'); }); it('works correctly when the webContents is destroyed', async () => { view = new BrowserView(); w.setBrowserView(view); expect(view.webContents.getOwnerBrowserWindow()).to.equal(w); expect(view.ownerWindow).to.equal(w); const destroyed = once(view.webContents, 'destroyed'); view.webContents.close(); await destroyed; expect(view.ownerWindow).to.equal(w); }); it('works correctly when owner window is closed', async () => { view = new BrowserView(); w.setBrowserView(view); expect(view.webContents.getOwnerBrowserWindow()).to.equal(w); expect(view.ownerWindow).to.equal(w); const destroyed = once(w, 'closed'); w.close(); await destroyed; expect(view.ownerWindow).to.equal(null); }); }); describe('shutdown behavior', () => { it('emits the destroyed event when the host BrowserWindow is closed', async () => { view = new BrowserView(); w.addBrowserView(view); await view.webContents.loadURL(`data:text/html,