import { expect } from 'chai'; import { screen, desktopCapturer, BrowserWindow } from 'electron/main'; import { once } from 'node:events'; import { setTimeout } from 'node:timers/promises'; import { ifdescribe, ifit } from './lib/spec-helpers'; import { closeAllWindows } from './lib/window-helpers'; ifdescribe(!process.arch.includes('arm') && process.platform !== 'win32')('desktopCapturer', () => { let w: BrowserWindow; before(async () => { w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } }); await w.loadURL('about:blank'); }); after(closeAllWindows); it('should return a non-empty array of sources', async () => { const sources = await desktopCapturer.getSources({ types: ['window', 'screen'] }); expect(sources).to.be.an('array').that.is.not.empty(); }); it('throws an error for invalid options', async () => { const promise = desktopCapturer.getSources(['window', 'screen'] as any); await expect(promise).to.be.eventually.rejectedWith(Error, 'Invalid options'); }); it('does not throw an error when called more than once (regression)', async () => { const sources1 = await desktopCapturer.getSources({ types: ['window', 'screen'] }); expect(sources1).to.be.an('array').that.is.not.empty(); const sources2 = await desktopCapturer.getSources({ types: ['window', 'screen'] }); expect(sources2).to.be.an('array').that.is.not.empty(); }); it('responds to subsequent calls of different options', async () => { const promise1 = desktopCapturer.getSources({ types: ['window'] }); await expect(promise1).to.eventually.be.fulfilled(); const promise2 = desktopCapturer.getSources({ types: ['screen'] }); await expect(promise2).to.eventually.be.fulfilled(); }); // Linux doesn't return any window sources. ifit(process.platform !== 'linux')('returns an empty display_id for window sources', async () => { const w = new BrowserWindow({ width: 200, height: 200 }); await w.loadURL('about:blank'); const sources = await desktopCapturer.getSources({ types: ['window'] }); w.destroy(); expect(sources).to.be.an('array').that.is.not.empty(); for (const { display_id: displayId } of sources) { expect(displayId).to.be.a('string').and.be.empty(); } }); ifit(process.platform !== 'linux')('returns display_ids matching the Screen API', async () => { const displays = screen.getAllDisplays(); const sources = await desktopCapturer.getSources({ types: ['screen'] }); expect(sources).to.be.an('array').of.length(displays.length); for (const [i, source] of sources.entries()) { expect(source.display_id).to.equal(displays[i].id.toString()); } }); it('disabling thumbnail should return empty images', async () => { const w2 = new BrowserWindow({ show: false, width: 200, height: 200, webPreferences: { contextIsolation: false } }); const wShown = once(w2, 'show'); w2.show(); await wShown; const isEmpties: boolean[] = (await desktopCapturer.getSources({ types: ['window', 'screen'], thumbnailSize: { width: 0, height: 0 } })).map(s => s.thumbnail.constructor.name === 'NativeImage' && s.thumbnail.isEmpty()); w2.destroy(); expect(isEmpties).to.be.an('array').that.is.not.empty(); expect(isEmpties.every(e => e === true)).to.be.true(); }); it('getMediaSourceId should match DesktopCapturerSource.id', async () => { const w = new BrowserWindow({ show: false, width: 100, height: 100, webPreferences: { contextIsolation: false } }); const wShown = once(w, 'show'); const wFocused = once(w, 'focus'); w.show(); w.focus(); await wShown; await wFocused; const mediaSourceId = w.getMediaSourceId(); const sources = await desktopCapturer.getSources({ types: ['window'], thumbnailSize: { width: 0, height: 0 } }); w.destroy(); // TODO(julien.isorce): investigate why |sources| is empty on the linux // bots while it is not on my workstation, as expected, with and without // the --ci parameter. if (process.platform === 'linux' && sources.length === 0) { it.skip('desktopCapturer.getSources returned an empty source list'); return; } expect(sources).to.be.an('array').that.is.not.empty(); const foundSource = sources.find((source) => { return source.id === mediaSourceId; }); expect(mediaSourceId).to.equal(foundSource!.id); }); it('getSources should not incorrectly duplicate window_id', async () => { const w = new BrowserWindow({ show: false, width: 100, height: 100, webPreferences: { contextIsolation: false } }); const wShown = once(w, 'show'); const wFocused = once(w, 'focus'); w.show(); w.focus(); await wShown; await wFocused; // ensure window_id isn't duplicated in getMediaSourceId, // which uses a different method than getSources const mediaSourceId = w.getMediaSourceId(); const ids = mediaSourceId.split(':'); expect(ids[1]).to.not.equal(ids[2]); const sources = await desktopCapturer.getSources({ types: ['window'], thumbnailSize: { width: 0, height: 0 } }); w.destroy(); // TODO(julien.isorce): investigate why |sources| is empty on the linux // bots while it is not on my workstation, as expected, with and without // the --ci parameter. if (process.platform === 'linux' && sources.length === 0) { it.skip('desktopCapturer.getSources returned an empty source list'); return; } expect(sources).to.be.an('array').that.is.not.empty(); for (const source of sources) { const sourceIds = source.id.split(':'); expect(sourceIds[1]).to.not.equal(sourceIds[2]); } }); it('moveAbove should move the window at the requested place', async () => { // DesktopCapturer.getSources() is guaranteed to return in the correct // z-order from foreground to background. const MAX_WIN = 4; const wList: BrowserWindow[] = []; const destroyWindows = () => { for (const w of wList) { w.destroy(); } }; try { for (let i = 0; i < MAX_WIN; i++) { const w = new BrowserWindow({ show: false, width: 100, height: 100 }); wList.push(w); } expect(wList.length).to.equal(MAX_WIN); // Show and focus all the windows. for (const w of wList) { const wShown = once(w, 'show'); const wFocused = once(w, 'focus'); w.show(); w.focus(); await wShown; await wFocused; } // At this point our windows should be showing from bottom to top. // DesktopCapturer.getSources() returns sources sorted from foreground to // background, i.e. top to bottom. let sources = await desktopCapturer.getSources({ types: ['window'], thumbnailSize: { width: 0, height: 0 } }); // TODO(julien.isorce): investigate why |sources| is empty on the linux // bots while it is not on my workstation, as expected, with and without // the --ci parameter. if (process.platform === 'linux' && sources.length === 0) { destroyWindows(); it.skip('desktopCapturer.getSources returned an empty source list'); return; } expect(sources).to.be.an('array').that.is.not.empty(); expect(sources.length).to.gte(MAX_WIN); // Only keep our windows, they must be in the MAX_WIN first windows. sources.splice(MAX_WIN, sources.length - MAX_WIN); expect(sources.length).to.equal(MAX_WIN); expect(sources.length).to.equal(wList.length); // Check that the sources and wList are sorted in the reverse order. // If they're not, skip remaining checks because either focus or // window placement are not reliable in the running test environment. const wListReversed = wList.slice().reverse(); const proceed = sources.every( (source, index) => source.id === wListReversed[index].getMediaSourceId()); if (!proceed) return; // Move windows so wList is sorted from foreground to background. for (const [i, w] of wList.entries()) { if (i < wList.length - 1) { const next = wList[wList.length - 1]; w.focus(); w.moveAbove(next.getMediaSourceId()); // Ensure the window has time to move. await setTimeout(2000); } } sources = await desktopCapturer.getSources({ types: ['window'], thumbnailSize: { width: 0, height: 0 } }); sources.splice(MAX_WIN, sources.length); expect(sources.length).to.equal(MAX_WIN); expect(sources.length).to.equal(wList.length); // Check that the sources and wList are sorted in the same order. for (const [index, source] of sources.entries()) { const wID = wList[index].getMediaSourceId(); expect(source.id).to.equal(wID); } } finally { destroyWindows(); } }); });