api-web-contents-spec.ts 77 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180
  1. import { expect } from 'chai';
  2. import { AddressInfo } from 'net';
  3. import * as path from 'path';
  4. import * as fs from 'fs';
  5. import * as http from 'http';
  6. import { BrowserWindow, ipcMain, webContents, session, WebContents, app, BrowserView } from 'electron/main';
  7. import { clipboard } from 'electron/common';
  8. import { emittedOnce } from './events-helpers';
  9. import { closeAllWindows } from './window-helpers';
  10. import { ifdescribe, ifit, delay, defer } from './spec-helpers';
  11. const pdfjs = require('pdfjs-dist');
  12. const fixturesPath = path.resolve(__dirname, '..', 'spec', 'fixtures');
  13. const mainFixturesPath = path.resolve(__dirname, 'fixtures');
  14. const features = process._linkedBinding('electron_common_features');
  15. describe('webContents module', () => {
  16. describe('getAllWebContents() API', () => {
  17. afterEach(closeAllWindows);
  18. it('returns an array of web contents', async () => {
  19. const w = new BrowserWindow({
  20. show: false,
  21. webPreferences: { webviewTag: true }
  22. });
  23. w.loadFile(path.join(fixturesPath, 'pages', 'webview-zoom-factor.html'));
  24. await emittedOnce(w.webContents, 'did-attach-webview');
  25. w.webContents.openDevTools();
  26. await emittedOnce(w.webContents, 'devtools-opened');
  27. const all = webContents.getAllWebContents().sort((a, b) => {
  28. return a.id - b.id;
  29. });
  30. expect(all).to.have.length(3);
  31. expect(all[0].getType()).to.equal('window');
  32. expect(all[all.length - 2].getType()).to.equal('webview');
  33. expect(all[all.length - 1].getType()).to.equal('remote');
  34. });
  35. });
  36. describe('fromId()', () => {
  37. it('returns undefined for an unknown id', () => {
  38. expect(webContents.fromId(12345)).to.be.undefined();
  39. });
  40. });
  41. describe('fromDevToolsTargetId()', () => {
  42. it('returns WebContents for attached DevTools target', async () => {
  43. const w = new BrowserWindow({ show: false });
  44. await w.loadURL('about:blank');
  45. try {
  46. await w.webContents.debugger.attach('1.3');
  47. const { targetInfo } = await w.webContents.debugger.sendCommand('Target.getTargetInfo');
  48. expect(webContents.fromDevToolsTargetId(targetInfo.targetId)).to.equal(w.webContents);
  49. } finally {
  50. await w.webContents.debugger.detach();
  51. }
  52. });
  53. it('returns undefined for an unknown id', () => {
  54. expect(webContents.fromDevToolsTargetId('nope')).to.be.undefined();
  55. });
  56. });
  57. describe('will-prevent-unload event', function () {
  58. afterEach(closeAllWindows);
  59. it('does not emit if beforeunload returns undefined in a BrowserWindow', async () => {
  60. const w = new BrowserWindow({ show: false });
  61. w.webContents.once('will-prevent-unload', () => {
  62. expect.fail('should not have fired');
  63. });
  64. await w.loadFile(path.join(__dirname, 'fixtures', 'api', 'beforeunload-undefined.html'));
  65. const wait = emittedOnce(w, 'closed');
  66. w.close();
  67. await wait;
  68. });
  69. it('does not emit if beforeunload returns undefined in a BrowserView', async () => {
  70. const w = new BrowserWindow({ show: false });
  71. const view = new BrowserView();
  72. w.setBrowserView(view);
  73. view.setBounds(w.getBounds());
  74. view.webContents.once('will-prevent-unload', () => {
  75. expect.fail('should not have fired');
  76. });
  77. await view.webContents.loadFile(path.join(__dirname, 'fixtures', 'api', 'beforeunload-undefined.html'));
  78. const wait = emittedOnce(w, 'closed');
  79. w.close();
  80. await wait;
  81. });
  82. it('emits if beforeunload returns false in a BrowserWindow', async () => {
  83. const w = new BrowserWindow({ show: false });
  84. await w.loadFile(path.join(__dirname, 'fixtures', 'api', 'beforeunload-false.html'));
  85. w.close();
  86. await emittedOnce(w.webContents, 'will-prevent-unload');
  87. });
  88. it('emits if beforeunload returns false in a BrowserView', async () => {
  89. const w = new BrowserWindow({ show: false });
  90. const view = new BrowserView();
  91. w.setBrowserView(view);
  92. view.setBounds(w.getBounds());
  93. await view.webContents.loadFile(path.join(__dirname, 'fixtures', 'api', 'beforeunload-false.html'));
  94. w.close();
  95. await emittedOnce(view.webContents, 'will-prevent-unload');
  96. });
  97. it('supports calling preventDefault on will-prevent-unload events in a BrowserWindow', async () => {
  98. const w = new BrowserWindow({ show: false });
  99. w.webContents.once('will-prevent-unload', event => event.preventDefault());
  100. await w.loadFile(path.join(__dirname, 'fixtures', 'api', 'beforeunload-false.html'));
  101. const wait = emittedOnce(w, 'closed');
  102. w.close();
  103. await wait;
  104. });
  105. });
  106. describe('webContents.send(channel, args...)', () => {
  107. afterEach(closeAllWindows);
  108. it('throws an error when the channel is missing', () => {
  109. const w = new BrowserWindow({ show: false });
  110. expect(() => {
  111. (w.webContents.send as any)();
  112. }).to.throw('Missing required channel argument');
  113. expect(() => {
  114. w.webContents.send(null as any);
  115. }).to.throw('Missing required channel argument');
  116. });
  117. it('does not block node async APIs when sent before document is ready', (done) => {
  118. // Please reference https://github.com/electron/electron/issues/19368 if
  119. // this test fails.
  120. ipcMain.once('async-node-api-done', () => {
  121. done();
  122. });
  123. const w = new BrowserWindow({
  124. show: false,
  125. webPreferences: {
  126. nodeIntegration: true,
  127. sandbox: false,
  128. contextIsolation: false
  129. }
  130. });
  131. w.loadFile(path.join(fixturesPath, 'pages', 'send-after-node.html'));
  132. setTimeout(() => {
  133. w.webContents.send('test');
  134. }, 50);
  135. });
  136. });
  137. ifdescribe(features.isPrintingEnabled())('webContents.print()', () => {
  138. let w: BrowserWindow;
  139. beforeEach(() => {
  140. w = new BrowserWindow({ show: false });
  141. });
  142. afterEach(closeAllWindows);
  143. it('throws when invalid settings are passed', () => {
  144. expect(() => {
  145. // @ts-ignore this line is intentionally incorrect
  146. w.webContents.print(true);
  147. }).to.throw('webContents.print(): Invalid print settings specified.');
  148. });
  149. it('throws when an invalid callback is passed', () => {
  150. expect(() => {
  151. // @ts-ignore this line is intentionally incorrect
  152. w.webContents.print({}, true);
  153. }).to.throw('webContents.print(): Invalid optional callback provided.');
  154. });
  155. ifit(process.platform !== 'linux')('throws when an invalid deviceName is passed', () => {
  156. expect(() => {
  157. w.webContents.print({ deviceName: 'i-am-a-nonexistent-printer' }, () => {});
  158. }).to.throw('webContents.print(): Invalid deviceName provided.');
  159. });
  160. it('throws when an invalid pageSize is passed', () => {
  161. expect(() => {
  162. // @ts-ignore this line is intentionally incorrect
  163. w.webContents.print({ pageSize: 'i-am-a-bad-pagesize' }, () => {});
  164. }).to.throw('Unsupported pageSize: i-am-a-bad-pagesize');
  165. });
  166. it('throws when an invalid custom pageSize is passed', () => {
  167. expect(() => {
  168. w.webContents.print({
  169. pageSize: {
  170. width: 100,
  171. height: 200
  172. }
  173. });
  174. }).to.throw('height and width properties must be minimum 352 microns.');
  175. });
  176. it('does not crash with custom margins', () => {
  177. expect(() => {
  178. w.webContents.print({
  179. silent: true,
  180. margins: {
  181. marginType: 'custom',
  182. top: 1,
  183. bottom: 1,
  184. left: 1,
  185. right: 1
  186. }
  187. });
  188. }).to.not.throw();
  189. });
  190. });
  191. describe('webContents.executeJavaScript', () => {
  192. describe('in about:blank', () => {
  193. const expected = 'hello, world!';
  194. const expectedErrorMsg = 'woops!';
  195. const code = `(() => "${expected}")()`;
  196. const asyncCode = `(() => new Promise(r => setTimeout(() => r("${expected}"), 500)))()`;
  197. const badAsyncCode = `(() => new Promise((r, e) => setTimeout(() => e("${expectedErrorMsg}"), 500)))()`;
  198. const errorTypes = new Set([
  199. Error,
  200. ReferenceError,
  201. EvalError,
  202. RangeError,
  203. SyntaxError,
  204. TypeError,
  205. URIError
  206. ]);
  207. let w: BrowserWindow;
  208. before(async () => {
  209. w = new BrowserWindow({ show: false, webPreferences: { contextIsolation: false } });
  210. await w.loadURL('about:blank');
  211. });
  212. after(closeAllWindows);
  213. it('resolves the returned promise with the result', async () => {
  214. const result = await w.webContents.executeJavaScript(code);
  215. expect(result).to.equal(expected);
  216. });
  217. it('resolves the returned promise with the result if the code returns an asyncronous promise', async () => {
  218. const result = await w.webContents.executeJavaScript(asyncCode);
  219. expect(result).to.equal(expected);
  220. });
  221. it('rejects the returned promise if an async error is thrown', async () => {
  222. await expect(w.webContents.executeJavaScript(badAsyncCode)).to.eventually.be.rejectedWith(expectedErrorMsg);
  223. });
  224. it('rejects the returned promise with an error if an Error.prototype is thrown', async () => {
  225. for (const error of errorTypes) {
  226. await expect(w.webContents.executeJavaScript(`Promise.reject(new ${error.name}("Wamp-wamp"))`))
  227. .to.eventually.be.rejectedWith(error);
  228. }
  229. });
  230. });
  231. describe('on a real page', () => {
  232. let w: BrowserWindow;
  233. beforeEach(() => {
  234. w = new BrowserWindow({ show: false });
  235. });
  236. afterEach(closeAllWindows);
  237. let server: http.Server = null as unknown as http.Server;
  238. let serverUrl: string = null as unknown as string;
  239. before((done) => {
  240. server = http.createServer((request, response) => {
  241. response.end();
  242. }).listen(0, '127.0.0.1', () => {
  243. serverUrl = 'http://127.0.0.1:' + (server.address() as AddressInfo).port;
  244. done();
  245. });
  246. });
  247. after(() => {
  248. server.close();
  249. });
  250. it('works after page load and during subframe load', async () => {
  251. await w.loadURL(serverUrl);
  252. // initiate a sub-frame load, then try and execute script during it
  253. await w.webContents.executeJavaScript(`
  254. var iframe = document.createElement('iframe')
  255. iframe.src = '${serverUrl}/slow'
  256. document.body.appendChild(iframe)
  257. null // don't return the iframe
  258. `);
  259. await w.webContents.executeJavaScript('console.log(\'hello\')');
  260. });
  261. it('executes after page load', async () => {
  262. const executeJavaScript = w.webContents.executeJavaScript('(() => "test")()');
  263. w.loadURL(serverUrl);
  264. const result = await executeJavaScript;
  265. expect(result).to.equal('test');
  266. });
  267. });
  268. });
  269. describe('webContents.executeJavaScriptInIsolatedWorld', () => {
  270. let w: BrowserWindow;
  271. before(async () => {
  272. w = new BrowserWindow({ show: false, webPreferences: { contextIsolation: true } });
  273. await w.loadURL('about:blank');
  274. });
  275. it('resolves the returned promise with the result', async () => {
  276. await w.webContents.executeJavaScriptInIsolatedWorld(999, [{ code: 'window.X = 123' }]);
  277. const isolatedResult = await w.webContents.executeJavaScriptInIsolatedWorld(999, [{ code: 'window.X' }]);
  278. const mainWorldResult = await w.webContents.executeJavaScript('window.X');
  279. expect(isolatedResult).to.equal(123);
  280. expect(mainWorldResult).to.equal(undefined);
  281. });
  282. });
  283. describe('loadURL() promise API', () => {
  284. let w: BrowserWindow;
  285. beforeEach(async () => {
  286. w = new BrowserWindow({ show: false });
  287. });
  288. afterEach(closeAllWindows);
  289. it('resolves when done loading', async () => {
  290. await expect(w.loadURL('about:blank')).to.eventually.be.fulfilled();
  291. });
  292. it('resolves when done loading a file URL', async () => {
  293. await expect(w.loadFile(path.join(fixturesPath, 'pages', 'base-page.html'))).to.eventually.be.fulfilled();
  294. });
  295. it('rejects when failing to load a file URL', async () => {
  296. await expect(w.loadURL('file:non-existent')).to.eventually.be.rejected()
  297. .and.have.property('code', 'ERR_FILE_NOT_FOUND');
  298. });
  299. // Temporarily disable on WOA until
  300. // https://github.com/electron/electron/issues/20008 is resolved
  301. const testFn = (process.platform === 'win32' && process.arch === 'arm64' ? it.skip : it);
  302. testFn('rejects when loading fails due to DNS not resolved', async () => {
  303. await expect(w.loadURL('https://err.name.not.resolved')).to.eventually.be.rejected()
  304. .and.have.property('code', 'ERR_NAME_NOT_RESOLVED');
  305. });
  306. it('rejects when navigation is cancelled due to a bad scheme', async () => {
  307. await expect(w.loadURL('bad-scheme://foo')).to.eventually.be.rejected()
  308. .and.have.property('code', 'ERR_FAILED');
  309. });
  310. it('sets appropriate error information on rejection', async () => {
  311. let err: any;
  312. try {
  313. await w.loadURL('file:non-existent');
  314. } catch (e) {
  315. err = e;
  316. }
  317. expect(err).not.to.be.null();
  318. expect(err.code).to.eql('ERR_FILE_NOT_FOUND');
  319. expect(err.errno).to.eql(-6);
  320. expect(err.url).to.eql(process.platform === 'win32' ? 'file://non-existent/' : 'file:///non-existent');
  321. });
  322. it('rejects if the load is aborted', async () => {
  323. const s = http.createServer(() => { /* never complete the request */ });
  324. await new Promise<void>(resolve => s.listen(0, '127.0.0.1', resolve));
  325. const { port } = s.address() as AddressInfo;
  326. const p = expect(w.loadURL(`http://127.0.0.1:${port}`)).to.eventually.be.rejectedWith(Error, /ERR_ABORTED/);
  327. // load a different file before the first load completes, causing the
  328. // first load to be aborted.
  329. await w.loadFile(path.join(fixturesPath, 'pages', 'base-page.html'));
  330. await p;
  331. s.close();
  332. });
  333. it("doesn't reject when a subframe fails to load", async () => {
  334. let resp = null as unknown as http.ServerResponse;
  335. const s = http.createServer((req, res) => {
  336. res.writeHead(200, { 'Content-Type': 'text/html' });
  337. res.write('<iframe src="http://err.name.not.resolved"></iframe>');
  338. resp = res;
  339. // don't end the response yet
  340. });
  341. await new Promise<void>(resolve => s.listen(0, '127.0.0.1', resolve));
  342. const { port } = s.address() as AddressInfo;
  343. const p = new Promise<void>(resolve => {
  344. w.webContents.on('did-fail-load', (event, errorCode, errorDescription, validatedURL, isMainFrame) => {
  345. if (!isMainFrame) {
  346. resolve();
  347. }
  348. });
  349. });
  350. const main = w.loadURL(`http://127.0.0.1:${port}`);
  351. await p;
  352. resp.end();
  353. await main;
  354. s.close();
  355. });
  356. it("doesn't resolve when a subframe loads", async () => {
  357. let resp = null as unknown as http.ServerResponse;
  358. const s = http.createServer((req, res) => {
  359. res.writeHead(200, { 'Content-Type': 'text/html' });
  360. res.write('<iframe src="about:blank"></iframe>');
  361. resp = res;
  362. // don't end the response yet
  363. });
  364. await new Promise<void>(resolve => s.listen(0, '127.0.0.1', resolve));
  365. const { port } = s.address() as AddressInfo;
  366. const p = new Promise<void>(resolve => {
  367. w.webContents.on('did-frame-finish-load', (event, isMainFrame) => {
  368. if (!isMainFrame) {
  369. resolve();
  370. }
  371. });
  372. });
  373. const main = w.loadURL(`http://127.0.0.1:${port}`);
  374. await p;
  375. resp.destroy(); // cause the main request to fail
  376. await expect(main).to.eventually.be.rejected()
  377. .and.have.property('errno', -355); // ERR_INCOMPLETE_CHUNKED_ENCODING
  378. s.close();
  379. });
  380. });
  381. describe('getFocusedWebContents() API', () => {
  382. afterEach(closeAllWindows);
  383. const testFn = (process.platform === 'win32' && process.arch === 'arm64' ? it.skip : it);
  384. testFn('returns the focused web contents', async () => {
  385. const w = new BrowserWindow({ show: true });
  386. await w.loadFile(path.join(__dirname, 'fixtures', 'blank.html'));
  387. expect(webContents.getFocusedWebContents().id).to.equal(w.webContents.id);
  388. const devToolsOpened = emittedOnce(w.webContents, 'devtools-opened');
  389. w.webContents.openDevTools();
  390. await devToolsOpened;
  391. expect(webContents.getFocusedWebContents().id).to.equal(w.webContents.devToolsWebContents!.id);
  392. const devToolsClosed = emittedOnce(w.webContents, 'devtools-closed');
  393. w.webContents.closeDevTools();
  394. await devToolsClosed;
  395. expect(webContents.getFocusedWebContents().id).to.equal(w.webContents.id);
  396. });
  397. it('does not crash when called on a detached dev tools window', async () => {
  398. const w = new BrowserWindow({ show: true });
  399. w.webContents.openDevTools({ mode: 'detach' });
  400. w.webContents.inspectElement(100, 100);
  401. // For some reason we have to wait for two focused events...?
  402. await emittedOnce(w.webContents, 'devtools-focused');
  403. expect(() => { webContents.getFocusedWebContents(); }).to.not.throw();
  404. // Work around https://github.com/electron/electron/issues/19985
  405. await delay();
  406. const devToolsClosed = emittedOnce(w.webContents, 'devtools-closed');
  407. w.webContents.closeDevTools();
  408. await devToolsClosed;
  409. expect(() => { webContents.getFocusedWebContents(); }).to.not.throw();
  410. });
  411. });
  412. describe('setDevToolsWebContents() API', () => {
  413. afterEach(closeAllWindows);
  414. it('sets arbitrary webContents as devtools', async () => {
  415. const w = new BrowserWindow({ show: false });
  416. const devtools = new BrowserWindow({ show: false });
  417. const promise = emittedOnce(devtools.webContents, 'dom-ready');
  418. w.webContents.setDevToolsWebContents(devtools.webContents);
  419. w.webContents.openDevTools();
  420. await promise;
  421. expect(devtools.webContents.getURL().startsWith('devtools://devtools')).to.be.true();
  422. const result = await devtools.webContents.executeJavaScript('InspectorFrontendHost.constructor.name');
  423. expect(result).to.equal('InspectorFrontendHostImpl');
  424. devtools.destroy();
  425. });
  426. });
  427. describe('isFocused() API', () => {
  428. it('returns false when the window is hidden', async () => {
  429. const w = new BrowserWindow({ show: false });
  430. await w.loadURL('about:blank');
  431. expect(w.isVisible()).to.be.false();
  432. expect(w.webContents.isFocused()).to.be.false();
  433. });
  434. });
  435. describe('isCurrentlyAudible() API', () => {
  436. afterEach(closeAllWindows);
  437. it('returns whether audio is playing', async () => {
  438. const w = new BrowserWindow({ show: false });
  439. await w.loadURL('about:blank');
  440. await w.webContents.executeJavaScript(`
  441. window.context = new AudioContext
  442. // Start in suspended state, because of the
  443. // new web audio api policy.
  444. context.suspend()
  445. window.oscillator = context.createOscillator()
  446. oscillator.connect(context.destination)
  447. oscillator.start()
  448. `);
  449. let p = emittedOnce(w.webContents, '-audio-state-changed');
  450. w.webContents.executeJavaScript('context.resume()');
  451. await p;
  452. expect(w.webContents.isCurrentlyAudible()).to.be.true();
  453. p = emittedOnce(w.webContents, '-audio-state-changed');
  454. w.webContents.executeJavaScript('oscillator.stop()');
  455. await p;
  456. expect(w.webContents.isCurrentlyAudible()).to.be.false();
  457. });
  458. });
  459. describe('openDevTools() API', () => {
  460. afterEach(closeAllWindows);
  461. it('can show window with activation', async () => {
  462. const w = new BrowserWindow({ show: false });
  463. const focused = emittedOnce(w, 'focus');
  464. w.show();
  465. await focused;
  466. expect(w.isFocused()).to.be.true();
  467. const blurred = emittedOnce(w, 'blur');
  468. w.webContents.openDevTools({ mode: 'detach', activate: true });
  469. await Promise.all([
  470. emittedOnce(w.webContents, 'devtools-opened'),
  471. emittedOnce(w.webContents, 'devtools-focused')
  472. ]);
  473. await blurred;
  474. expect(w.isFocused()).to.be.false();
  475. });
  476. it('can show window without activation', async () => {
  477. const w = new BrowserWindow({ show: false });
  478. const devtoolsOpened = emittedOnce(w.webContents, 'devtools-opened');
  479. w.webContents.openDevTools({ mode: 'detach', activate: false });
  480. await devtoolsOpened;
  481. expect(w.webContents.isDevToolsOpened()).to.be.true();
  482. });
  483. });
  484. describe('before-input-event event', () => {
  485. afterEach(closeAllWindows);
  486. it('can prevent document keyboard events', async () => {
  487. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  488. await w.loadFile(path.join(fixturesPath, 'pages', 'key-events.html'));
  489. const keyDown = new Promise(resolve => {
  490. ipcMain.once('keydown', (event, key) => resolve(key));
  491. });
  492. w.webContents.once('before-input-event', (event, input) => {
  493. if (input.key === 'a') event.preventDefault();
  494. });
  495. w.webContents.sendInputEvent({ type: 'keyDown', keyCode: 'a' });
  496. w.webContents.sendInputEvent({ type: 'keyDown', keyCode: 'b' });
  497. expect(await keyDown).to.equal('b');
  498. });
  499. it('has the correct properties', async () => {
  500. const w = new BrowserWindow({ show: false });
  501. await w.loadFile(path.join(fixturesPath, 'pages', 'base-page.html'));
  502. const testBeforeInput = async (opts: any) => {
  503. const modifiers = [];
  504. if (opts.shift) modifiers.push('shift');
  505. if (opts.control) modifiers.push('control');
  506. if (opts.alt) modifiers.push('alt');
  507. if (opts.meta) modifiers.push('meta');
  508. if (opts.isAutoRepeat) modifiers.push('isAutoRepeat');
  509. const p = emittedOnce(w.webContents, 'before-input-event');
  510. w.webContents.sendInputEvent({
  511. type: opts.type,
  512. keyCode: opts.keyCode,
  513. modifiers: modifiers as any
  514. });
  515. const [, input] = await p;
  516. expect(input.type).to.equal(opts.type);
  517. expect(input.key).to.equal(opts.key);
  518. expect(input.code).to.equal(opts.code);
  519. expect(input.isAutoRepeat).to.equal(opts.isAutoRepeat);
  520. expect(input.shift).to.equal(opts.shift);
  521. expect(input.control).to.equal(opts.control);
  522. expect(input.alt).to.equal(opts.alt);
  523. expect(input.meta).to.equal(opts.meta);
  524. };
  525. await testBeforeInput({
  526. type: 'keyDown',
  527. key: 'A',
  528. code: 'KeyA',
  529. keyCode: 'a',
  530. shift: true,
  531. control: true,
  532. alt: true,
  533. meta: true,
  534. isAutoRepeat: true
  535. });
  536. await testBeforeInput({
  537. type: 'keyUp',
  538. key: '.',
  539. code: 'Period',
  540. keyCode: '.',
  541. shift: false,
  542. control: true,
  543. alt: true,
  544. meta: false,
  545. isAutoRepeat: false
  546. });
  547. await testBeforeInput({
  548. type: 'keyUp',
  549. key: '!',
  550. code: 'Digit1',
  551. keyCode: '1',
  552. shift: true,
  553. control: false,
  554. alt: false,
  555. meta: true,
  556. isAutoRepeat: false
  557. });
  558. await testBeforeInput({
  559. type: 'keyUp',
  560. key: 'Tab',
  561. code: 'Tab',
  562. keyCode: 'Tab',
  563. shift: false,
  564. control: true,
  565. alt: false,
  566. meta: false,
  567. isAutoRepeat: true
  568. });
  569. });
  570. });
  571. // On Mac, zooming isn't done with the mouse wheel.
  572. ifdescribe(process.platform !== 'darwin')('zoom-changed', () => {
  573. afterEach(closeAllWindows);
  574. it('is emitted with the correct zoom-in info', async () => {
  575. const w = new BrowserWindow({ show: false });
  576. await w.loadFile(path.join(fixturesPath, 'pages', 'base-page.html'));
  577. const testZoomChanged = async () => {
  578. w.webContents.sendInputEvent({
  579. type: 'mouseWheel',
  580. x: 300,
  581. y: 300,
  582. deltaX: 0,
  583. deltaY: 1,
  584. wheelTicksX: 0,
  585. wheelTicksY: 1,
  586. modifiers: ['control', 'meta']
  587. });
  588. const [, zoomDirection] = await emittedOnce(w.webContents, 'zoom-changed');
  589. expect(zoomDirection).to.equal('in');
  590. };
  591. await testZoomChanged();
  592. });
  593. it('is emitted with the correct zoom-out info', async () => {
  594. const w = new BrowserWindow({ show: false });
  595. await w.loadFile(path.join(fixturesPath, 'pages', 'base-page.html'));
  596. const testZoomChanged = async () => {
  597. w.webContents.sendInputEvent({
  598. type: 'mouseWheel',
  599. x: 300,
  600. y: 300,
  601. deltaX: 0,
  602. deltaY: -1,
  603. wheelTicksX: 0,
  604. wheelTicksY: -1,
  605. modifiers: ['control', 'meta']
  606. });
  607. const [, zoomDirection] = await emittedOnce(w.webContents, 'zoom-changed');
  608. expect(zoomDirection).to.equal('out');
  609. };
  610. await testZoomChanged();
  611. });
  612. });
  613. describe('sendInputEvent(event)', () => {
  614. let w: BrowserWindow;
  615. beforeEach(async () => {
  616. w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  617. await w.loadFile(path.join(fixturesPath, 'pages', 'key-events.html'));
  618. });
  619. afterEach(closeAllWindows);
  620. it('can send keydown events', async () => {
  621. const keydown = emittedOnce(ipcMain, 'keydown');
  622. w.webContents.sendInputEvent({ type: 'keyDown', keyCode: 'A' });
  623. const [, key, code, keyCode, shiftKey, ctrlKey, altKey] = await keydown;
  624. expect(key).to.equal('a');
  625. expect(code).to.equal('KeyA');
  626. expect(keyCode).to.equal(65);
  627. expect(shiftKey).to.be.false();
  628. expect(ctrlKey).to.be.false();
  629. expect(altKey).to.be.false();
  630. });
  631. it('can send keydown events with modifiers', async () => {
  632. const keydown = emittedOnce(ipcMain, 'keydown');
  633. w.webContents.sendInputEvent({ type: 'keyDown', keyCode: 'Z', modifiers: ['shift', 'ctrl'] });
  634. const [, key, code, keyCode, shiftKey, ctrlKey, altKey] = await keydown;
  635. expect(key).to.equal('Z');
  636. expect(code).to.equal('KeyZ');
  637. expect(keyCode).to.equal(90);
  638. expect(shiftKey).to.be.true();
  639. expect(ctrlKey).to.be.true();
  640. expect(altKey).to.be.false();
  641. });
  642. it('can send keydown events with special keys', async () => {
  643. const keydown = emittedOnce(ipcMain, 'keydown');
  644. w.webContents.sendInputEvent({ type: 'keyDown', keyCode: 'Tab', modifiers: ['alt'] });
  645. const [, key, code, keyCode, shiftKey, ctrlKey, altKey] = await keydown;
  646. expect(key).to.equal('Tab');
  647. expect(code).to.equal('Tab');
  648. expect(keyCode).to.equal(9);
  649. expect(shiftKey).to.be.false();
  650. expect(ctrlKey).to.be.false();
  651. expect(altKey).to.be.true();
  652. });
  653. it('can send char events', async () => {
  654. const keypress = emittedOnce(ipcMain, 'keypress');
  655. w.webContents.sendInputEvent({ type: 'keyDown', keyCode: 'A' });
  656. w.webContents.sendInputEvent({ type: 'char', keyCode: 'A' });
  657. const [, key, code, keyCode, shiftKey, ctrlKey, altKey] = await keypress;
  658. expect(key).to.equal('a');
  659. expect(code).to.equal('KeyA');
  660. expect(keyCode).to.equal(65);
  661. expect(shiftKey).to.be.false();
  662. expect(ctrlKey).to.be.false();
  663. expect(altKey).to.be.false();
  664. });
  665. it('can send char events with modifiers', async () => {
  666. const keypress = emittedOnce(ipcMain, 'keypress');
  667. w.webContents.sendInputEvent({ type: 'keyDown', keyCode: 'Z' });
  668. w.webContents.sendInputEvent({ type: 'char', keyCode: 'Z', modifiers: ['shift', 'ctrl'] });
  669. const [, key, code, keyCode, shiftKey, ctrlKey, altKey] = await keypress;
  670. expect(key).to.equal('Z');
  671. expect(code).to.equal('KeyZ');
  672. expect(keyCode).to.equal(90);
  673. expect(shiftKey).to.be.true();
  674. expect(ctrlKey).to.be.true();
  675. expect(altKey).to.be.false();
  676. });
  677. });
  678. describe('insertCSS', () => {
  679. afterEach(closeAllWindows);
  680. it('supports inserting CSS', async () => {
  681. const w = new BrowserWindow({ show: false });
  682. w.loadURL('about:blank');
  683. await w.webContents.insertCSS('body { background-repeat: round; }');
  684. const result = await w.webContents.executeJavaScript('window.getComputedStyle(document.body).getPropertyValue("background-repeat")');
  685. expect(result).to.equal('round');
  686. });
  687. it('supports removing inserted CSS', async () => {
  688. const w = new BrowserWindow({ show: false });
  689. w.loadURL('about:blank');
  690. const key = await w.webContents.insertCSS('body { background-repeat: round; }');
  691. await w.webContents.removeInsertedCSS(key);
  692. const result = await w.webContents.executeJavaScript('window.getComputedStyle(document.body).getPropertyValue("background-repeat")');
  693. expect(result).to.equal('repeat');
  694. });
  695. });
  696. describe('inspectElement()', () => {
  697. afterEach(closeAllWindows);
  698. it('supports inspecting an element in the devtools', (done) => {
  699. const w = new BrowserWindow({ show: false });
  700. w.loadURL('about:blank');
  701. w.webContents.once('devtools-opened', () => { done(); });
  702. w.webContents.inspectElement(10, 10);
  703. });
  704. });
  705. describe('startDrag({file, icon})', () => {
  706. it('throws errors for a missing file or a missing/empty icon', () => {
  707. const w = new BrowserWindow({ show: false });
  708. expect(() => {
  709. w.webContents.startDrag({ icon: path.join(fixturesPath, 'assets', 'logo.png') } as any);
  710. }).to.throw('Must specify either \'file\' or \'files\' option');
  711. expect(() => {
  712. w.webContents.startDrag({ file: __filename } as any);
  713. }).to.throw('\'icon\' parameter is required');
  714. expect(() => {
  715. w.webContents.startDrag({ file: __filename, icon: path.join(mainFixturesPath, 'blank.png') });
  716. }).to.throw(/Failed to load image from path (.+)/);
  717. });
  718. });
  719. describe('focus APIs', () => {
  720. describe('focus()', () => {
  721. afterEach(closeAllWindows);
  722. it('does not blur the focused window when the web contents is hidden', async () => {
  723. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true } });
  724. w.show();
  725. await w.loadURL('about:blank');
  726. w.focus();
  727. const child = new BrowserWindow({ show: false });
  728. child.loadURL('about:blank');
  729. child.webContents.focus();
  730. const currentFocused = w.isFocused();
  731. const childFocused = child.isFocused();
  732. child.close();
  733. expect(currentFocused).to.be.true();
  734. expect(childFocused).to.be.false();
  735. });
  736. });
  737. const moveFocusToDevTools = async (win: BrowserWindow) => {
  738. const devToolsOpened = emittedOnce(win.webContents, 'devtools-opened');
  739. win.webContents.openDevTools({ mode: 'right' });
  740. await devToolsOpened;
  741. win.webContents.devToolsWebContents!.focus();
  742. };
  743. describe('focus event', () => {
  744. afterEach(closeAllWindows);
  745. it('is triggered when web contents is focused', async () => {
  746. const w = new BrowserWindow({ show: false });
  747. await w.loadURL('about:blank');
  748. await moveFocusToDevTools(w);
  749. const focusPromise = emittedOnce(w.webContents, 'focus');
  750. w.webContents.focus();
  751. await expect(focusPromise).to.eventually.be.fulfilled();
  752. });
  753. it('is triggered when BrowserWindow is focused', async () => {
  754. const window1 = new BrowserWindow({ show: false });
  755. const window2 = new BrowserWindow({ show: false });
  756. await Promise.all([
  757. window1.loadURL('about:blank'),
  758. window2.loadURL('about:blank')
  759. ]);
  760. const focusPromise1 = emittedOnce(window1.webContents, 'focus');
  761. const focusPromise2 = emittedOnce(window2.webContents, 'focus');
  762. window1.showInactive();
  763. window2.showInactive();
  764. window1.focus();
  765. await expect(focusPromise1).to.eventually.be.fulfilled();
  766. window2.focus();
  767. await expect(focusPromise2).to.eventually.be.fulfilled();
  768. });
  769. });
  770. describe('blur event', () => {
  771. afterEach(closeAllWindows);
  772. it('is triggered when web contents is blurred', async () => {
  773. const w = new BrowserWindow({ show: true });
  774. await w.loadURL('about:blank');
  775. w.webContents.focus();
  776. const blurPromise = emittedOnce(w.webContents, 'blur');
  777. await moveFocusToDevTools(w);
  778. await expect(blurPromise).to.eventually.be.fulfilled();
  779. });
  780. });
  781. });
  782. describe('getOSProcessId()', () => {
  783. afterEach(closeAllWindows);
  784. it('returns a valid procress id', async () => {
  785. const w = new BrowserWindow({ show: false });
  786. expect(w.webContents.getOSProcessId()).to.equal(0);
  787. await w.loadURL('about:blank');
  788. expect(w.webContents.getOSProcessId()).to.be.above(0);
  789. });
  790. });
  791. describe('getMediaSourceId()', () => {
  792. afterEach(closeAllWindows);
  793. it('returns a valid stream id', () => {
  794. const w = new BrowserWindow({ show: false });
  795. expect(w.webContents.getMediaSourceId(w.webContents)).to.be.a('string').that.is.not.empty();
  796. });
  797. });
  798. describe('userAgent APIs', () => {
  799. it('is not empty by default', () => {
  800. const w = new BrowserWindow({ show: false });
  801. const userAgent = w.webContents.getUserAgent();
  802. expect(userAgent).to.be.a('string').that.is.not.empty();
  803. });
  804. it('can set the user agent (functions)', () => {
  805. const w = new BrowserWindow({ show: false });
  806. const userAgent = w.webContents.getUserAgent();
  807. w.webContents.setUserAgent('my-user-agent');
  808. expect(w.webContents.getUserAgent()).to.equal('my-user-agent');
  809. w.webContents.setUserAgent(userAgent);
  810. expect(w.webContents.getUserAgent()).to.equal(userAgent);
  811. });
  812. it('can set the user agent (properties)', () => {
  813. const w = new BrowserWindow({ show: false });
  814. const userAgent = w.webContents.userAgent;
  815. w.webContents.userAgent = 'my-user-agent';
  816. expect(w.webContents.userAgent).to.equal('my-user-agent');
  817. w.webContents.userAgent = userAgent;
  818. expect(w.webContents.userAgent).to.equal(userAgent);
  819. });
  820. });
  821. describe('audioMuted APIs', () => {
  822. it('can set the audio mute level (functions)', () => {
  823. const w = new BrowserWindow({ show: false });
  824. w.webContents.setAudioMuted(true);
  825. expect(w.webContents.isAudioMuted()).to.be.true();
  826. w.webContents.setAudioMuted(false);
  827. expect(w.webContents.isAudioMuted()).to.be.false();
  828. });
  829. it('can set the audio mute level (functions)', () => {
  830. const w = new BrowserWindow({ show: false });
  831. w.webContents.audioMuted = true;
  832. expect(w.webContents.audioMuted).to.be.true();
  833. w.webContents.audioMuted = false;
  834. expect(w.webContents.audioMuted).to.be.false();
  835. });
  836. });
  837. describe('zoom api', () => {
  838. const hostZoomMap: Record<string, number> = {
  839. host1: 0.3,
  840. host2: 0.7,
  841. host3: 0.2
  842. };
  843. before(() => {
  844. const protocol = session.defaultSession.protocol;
  845. protocol.registerStringProtocol(standardScheme, (request, callback) => {
  846. const response = `<script>
  847. const {ipcRenderer} = require('electron')
  848. ipcRenderer.send('set-zoom', window.location.hostname)
  849. ipcRenderer.on(window.location.hostname + '-zoom-set', () => {
  850. ipcRenderer.send(window.location.hostname + '-zoom-level')
  851. })
  852. </script>`;
  853. callback({ data: response, mimeType: 'text/html' });
  854. });
  855. });
  856. after(() => {
  857. const protocol = session.defaultSession.protocol;
  858. protocol.unregisterProtocol(standardScheme);
  859. });
  860. afterEach(closeAllWindows);
  861. it('throws on an invalid zoomFactor', async () => {
  862. const w = new BrowserWindow({ show: false });
  863. await w.loadURL('about:blank');
  864. expect(() => {
  865. w.webContents.setZoomFactor(0.0);
  866. }).to.throw(/'zoomFactor' must be a double greater than 0.0/);
  867. expect(() => {
  868. w.webContents.setZoomFactor(-2.0);
  869. }).to.throw(/'zoomFactor' must be a double greater than 0.0/);
  870. });
  871. it('can set the correct zoom level (functions)', async () => {
  872. const w = new BrowserWindow({ show: false });
  873. try {
  874. await w.loadURL('about:blank');
  875. const zoomLevel = w.webContents.getZoomLevel();
  876. expect(zoomLevel).to.eql(0.0);
  877. w.webContents.setZoomLevel(0.5);
  878. const newZoomLevel = w.webContents.getZoomLevel();
  879. expect(newZoomLevel).to.eql(0.5);
  880. } finally {
  881. w.webContents.setZoomLevel(0);
  882. }
  883. });
  884. it('can set the correct zoom level (properties)', async () => {
  885. const w = new BrowserWindow({ show: false });
  886. try {
  887. await w.loadURL('about:blank');
  888. const zoomLevel = w.webContents.zoomLevel;
  889. expect(zoomLevel).to.eql(0.0);
  890. w.webContents.zoomLevel = 0.5;
  891. const newZoomLevel = w.webContents.zoomLevel;
  892. expect(newZoomLevel).to.eql(0.5);
  893. } finally {
  894. w.webContents.zoomLevel = 0;
  895. }
  896. });
  897. it('can set the correct zoom factor (functions)', async () => {
  898. const w = new BrowserWindow({ show: false });
  899. try {
  900. await w.loadURL('about:blank');
  901. const zoomFactor = w.webContents.getZoomFactor();
  902. expect(zoomFactor).to.eql(1.0);
  903. w.webContents.setZoomFactor(0.5);
  904. const newZoomFactor = w.webContents.getZoomFactor();
  905. expect(newZoomFactor).to.eql(0.5);
  906. } finally {
  907. w.webContents.setZoomFactor(1.0);
  908. }
  909. });
  910. it('can set the correct zoom factor (properties)', async () => {
  911. const w = new BrowserWindow({ show: false });
  912. try {
  913. await w.loadURL('about:blank');
  914. const zoomFactor = w.webContents.zoomFactor;
  915. expect(zoomFactor).to.eql(1.0);
  916. w.webContents.zoomFactor = 0.5;
  917. const newZoomFactor = w.webContents.zoomFactor;
  918. expect(newZoomFactor).to.eql(0.5);
  919. } finally {
  920. w.webContents.zoomFactor = 1.0;
  921. }
  922. });
  923. it('can persist zoom level across navigation', (done) => {
  924. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  925. let finalNavigation = false;
  926. ipcMain.on('set-zoom', (e, host) => {
  927. const zoomLevel = hostZoomMap[host];
  928. if (!finalNavigation) w.webContents.zoomLevel = zoomLevel;
  929. e.sender.send(`${host}-zoom-set`);
  930. });
  931. ipcMain.on('host1-zoom-level', (e) => {
  932. try {
  933. const zoomLevel = e.sender.getZoomLevel();
  934. const expectedZoomLevel = hostZoomMap.host1;
  935. expect(zoomLevel).to.equal(expectedZoomLevel);
  936. if (finalNavigation) {
  937. done();
  938. } else {
  939. w.loadURL(`${standardScheme}://host2`);
  940. }
  941. } catch (e) {
  942. done(e);
  943. }
  944. });
  945. ipcMain.once('host2-zoom-level', (e) => {
  946. try {
  947. const zoomLevel = e.sender.getZoomLevel();
  948. const expectedZoomLevel = hostZoomMap.host2;
  949. expect(zoomLevel).to.equal(expectedZoomLevel);
  950. finalNavigation = true;
  951. w.webContents.goBack();
  952. } catch (e) {
  953. done(e);
  954. }
  955. });
  956. w.loadURL(`${standardScheme}://host1`);
  957. });
  958. it('can propagate zoom level across same session', async () => {
  959. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true } });
  960. const w2 = new BrowserWindow({ show: false });
  961. defer(() => {
  962. w2.setClosable(true);
  963. w2.close();
  964. });
  965. await w.loadURL(`${standardScheme}://host3`);
  966. w.webContents.zoomLevel = hostZoomMap.host3;
  967. await w2.loadURL(`${standardScheme}://host3`);
  968. const zoomLevel1 = w.webContents.zoomLevel;
  969. expect(zoomLevel1).to.equal(hostZoomMap.host3);
  970. const zoomLevel2 = w2.webContents.zoomLevel;
  971. expect(zoomLevel1).to.equal(zoomLevel2);
  972. });
  973. it('cannot propagate zoom level across different session', async () => {
  974. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true } });
  975. const w2 = new BrowserWindow({
  976. show: false,
  977. webPreferences: {
  978. partition: 'temp'
  979. }
  980. });
  981. const protocol = w2.webContents.session.protocol;
  982. protocol.registerStringProtocol(standardScheme, (request, callback) => {
  983. callback('hello');
  984. });
  985. defer(() => {
  986. w2.setClosable(true);
  987. w2.close();
  988. protocol.unregisterProtocol(standardScheme);
  989. });
  990. await w.loadURL(`${standardScheme}://host3`);
  991. w.webContents.zoomLevel = hostZoomMap.host3;
  992. await w2.loadURL(`${standardScheme}://host3`);
  993. const zoomLevel1 = w.webContents.zoomLevel;
  994. expect(zoomLevel1).to.equal(hostZoomMap.host3);
  995. const zoomLevel2 = w2.webContents.zoomLevel;
  996. expect(zoomLevel2).to.equal(0);
  997. expect(zoomLevel1).to.not.equal(zoomLevel2);
  998. });
  999. it('can persist when it contains iframe', (done) => {
  1000. const w = new BrowserWindow({ show: false });
  1001. const server = http.createServer((req, res) => {
  1002. setTimeout(() => {
  1003. res.end();
  1004. }, 200);
  1005. });
  1006. server.listen(0, '127.0.0.1', () => {
  1007. const url = 'http://127.0.0.1:' + (server.address() as AddressInfo).port;
  1008. const content = `<iframe src=${url}></iframe>`;
  1009. w.webContents.on('did-frame-finish-load', (e, isMainFrame) => {
  1010. if (!isMainFrame) {
  1011. try {
  1012. const zoomLevel = w.webContents.zoomLevel;
  1013. expect(zoomLevel).to.equal(2.0);
  1014. w.webContents.zoomLevel = 0;
  1015. done();
  1016. } catch (e) {
  1017. done(e);
  1018. } finally {
  1019. server.close();
  1020. }
  1021. }
  1022. });
  1023. w.webContents.on('dom-ready', () => {
  1024. w.webContents.zoomLevel = 2.0;
  1025. });
  1026. w.loadURL(`data:text/html,${content}`);
  1027. });
  1028. });
  1029. it('cannot propagate when used with webframe', async () => {
  1030. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  1031. const w2 = new BrowserWindow({ show: false });
  1032. const temporaryZoomSet = emittedOnce(ipcMain, 'temporary-zoom-set');
  1033. w.loadFile(path.join(fixturesPath, 'pages', 'webframe-zoom.html'));
  1034. await temporaryZoomSet;
  1035. const finalZoomLevel = w.webContents.getZoomLevel();
  1036. await w2.loadFile(path.join(fixturesPath, 'pages', 'c.html'));
  1037. const zoomLevel1 = w.webContents.zoomLevel;
  1038. const zoomLevel2 = w2.webContents.zoomLevel;
  1039. w2.setClosable(true);
  1040. w2.close();
  1041. expect(zoomLevel1).to.equal(finalZoomLevel);
  1042. expect(zoomLevel2).to.equal(0);
  1043. expect(zoomLevel1).to.not.equal(zoomLevel2);
  1044. });
  1045. describe('with unique domains', () => {
  1046. let server: http.Server;
  1047. let serverUrl: string;
  1048. let crossSiteUrl: string;
  1049. before((done) => {
  1050. server = http.createServer((req, res) => {
  1051. setTimeout(() => res.end('hey'), 0);
  1052. });
  1053. server.listen(0, '127.0.0.1', () => {
  1054. serverUrl = `http://127.0.0.1:${(server.address() as AddressInfo).port}`;
  1055. crossSiteUrl = `http://localhost:${(server.address() as AddressInfo).port}`;
  1056. done();
  1057. });
  1058. });
  1059. after(() => {
  1060. server.close();
  1061. });
  1062. it('cannot persist zoom level after navigation with webFrame', async () => {
  1063. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  1064. const source = `
  1065. const {ipcRenderer, webFrame} = require('electron')
  1066. webFrame.setZoomLevel(0.6)
  1067. ipcRenderer.send('zoom-level-set', webFrame.getZoomLevel())
  1068. `;
  1069. const zoomLevelPromise = emittedOnce(ipcMain, 'zoom-level-set');
  1070. await w.loadURL(serverUrl);
  1071. await w.webContents.executeJavaScript(source);
  1072. let [, zoomLevel] = await zoomLevelPromise;
  1073. expect(zoomLevel).to.equal(0.6);
  1074. const loadPromise = emittedOnce(w.webContents, 'did-finish-load');
  1075. await w.loadURL(crossSiteUrl);
  1076. await loadPromise;
  1077. zoomLevel = w.webContents.zoomLevel;
  1078. expect(zoomLevel).to.equal(0);
  1079. });
  1080. });
  1081. });
  1082. describe('webrtc ip policy api', () => {
  1083. afterEach(closeAllWindows);
  1084. it('can set and get webrtc ip policies', () => {
  1085. const w = new BrowserWindow({ show: false });
  1086. const policies = [
  1087. 'default',
  1088. 'default_public_interface_only',
  1089. 'default_public_and_private_interfaces',
  1090. 'disable_non_proxied_udp'
  1091. ];
  1092. policies.forEach((policy) => {
  1093. w.webContents.setWebRTCIPHandlingPolicy(policy as any);
  1094. expect(w.webContents.getWebRTCIPHandlingPolicy()).to.equal(policy);
  1095. });
  1096. });
  1097. });
  1098. describe('render view deleted events', () => {
  1099. let server: http.Server;
  1100. let serverUrl: string;
  1101. let crossSiteUrl: string;
  1102. before((done) => {
  1103. server = http.createServer((req, res) => {
  1104. const respond = () => {
  1105. if (req.url === '/redirect-cross-site') {
  1106. res.setHeader('Location', `${crossSiteUrl}/redirected`);
  1107. res.statusCode = 302;
  1108. res.end();
  1109. } else if (req.url === '/redirected') {
  1110. res.end('<html><script>window.localStorage</script></html>');
  1111. } else if (req.url === '/first-window-open') {
  1112. res.end(`<html><script>window.open('${serverUrl}/second-window-open', 'first child');</script></html>`);
  1113. } else if (req.url === '/second-window-open') {
  1114. res.end('<html><script>window.open(\'wrong://url\', \'second child\');</script></html>');
  1115. } else {
  1116. res.end();
  1117. }
  1118. };
  1119. setTimeout(respond, 0);
  1120. });
  1121. server.listen(0, '127.0.0.1', () => {
  1122. serverUrl = `http://127.0.0.1:${(server.address() as AddressInfo).port}`;
  1123. crossSiteUrl = `http://localhost:${(server.address() as AddressInfo).port}`;
  1124. done();
  1125. });
  1126. });
  1127. after(() => {
  1128. server.close();
  1129. });
  1130. afterEach(closeAllWindows);
  1131. it('does not emit current-render-view-deleted when speculative RVHs are deleted', async () => {
  1132. const w = new BrowserWindow({ show: false });
  1133. let currentRenderViewDeletedEmitted = false;
  1134. const renderViewDeletedHandler = () => {
  1135. currentRenderViewDeletedEmitted = true;
  1136. };
  1137. w.webContents.on('current-render-view-deleted' as any, renderViewDeletedHandler);
  1138. w.webContents.on('did-finish-load', () => {
  1139. w.webContents.removeListener('current-render-view-deleted' as any, renderViewDeletedHandler);
  1140. w.close();
  1141. });
  1142. const destroyed = emittedOnce(w.webContents, 'destroyed');
  1143. w.loadURL(`${serverUrl}/redirect-cross-site`);
  1144. await destroyed;
  1145. expect(currentRenderViewDeletedEmitted).to.be.false('current-render-view-deleted was emitted');
  1146. });
  1147. it('does not emit current-render-view-deleted when speculative RVHs are deleted', async () => {
  1148. const parentWindow = new BrowserWindow({ show: false });
  1149. let currentRenderViewDeletedEmitted = false;
  1150. let childWindow: BrowserWindow | null = null;
  1151. const destroyed = emittedOnce(parentWindow.webContents, 'destroyed');
  1152. const renderViewDeletedHandler = () => {
  1153. currentRenderViewDeletedEmitted = true;
  1154. };
  1155. const childWindowCreated = new Promise<void>((resolve) => {
  1156. app.once('browser-window-created', (event, window) => {
  1157. childWindow = window;
  1158. window.webContents.on('current-render-view-deleted' as any, renderViewDeletedHandler);
  1159. resolve();
  1160. });
  1161. });
  1162. parentWindow.loadURL(`${serverUrl}/first-window-open`);
  1163. await childWindowCreated;
  1164. childWindow!.webContents.removeListener('current-render-view-deleted' as any, renderViewDeletedHandler);
  1165. parentWindow.close();
  1166. await destroyed;
  1167. expect(currentRenderViewDeletedEmitted).to.be.false('child window was destroyed');
  1168. });
  1169. it('emits current-render-view-deleted if the current RVHs are deleted', async () => {
  1170. const w = new BrowserWindow({ show: false });
  1171. let currentRenderViewDeletedEmitted = false;
  1172. w.webContents.on('current-render-view-deleted' as any, () => {
  1173. currentRenderViewDeletedEmitted = true;
  1174. });
  1175. w.webContents.on('did-finish-load', () => {
  1176. w.close();
  1177. });
  1178. const destroyed = emittedOnce(w.webContents, 'destroyed');
  1179. w.loadURL(`${serverUrl}/redirect-cross-site`);
  1180. await destroyed;
  1181. expect(currentRenderViewDeletedEmitted).to.be.true('current-render-view-deleted wasn\'t emitted');
  1182. });
  1183. it('emits render-view-deleted if any RVHs are deleted', async () => {
  1184. const w = new BrowserWindow({ show: false });
  1185. let rvhDeletedCount = 0;
  1186. w.webContents.on('render-view-deleted' as any, () => {
  1187. rvhDeletedCount++;
  1188. });
  1189. w.webContents.on('did-finish-load', () => {
  1190. w.close();
  1191. });
  1192. const destroyed = emittedOnce(w.webContents, 'destroyed');
  1193. w.loadURL(`${serverUrl}/redirect-cross-site`);
  1194. await destroyed;
  1195. const expectedRenderViewDeletedEventCount = 1;
  1196. expect(rvhDeletedCount).to.equal(expectedRenderViewDeletedEventCount, 'render-view-deleted wasn\'t emitted the expected nr. of times');
  1197. });
  1198. });
  1199. describe('setIgnoreMenuShortcuts(ignore)', () => {
  1200. afterEach(closeAllWindows);
  1201. it('does not throw', () => {
  1202. const w = new BrowserWindow({ show: false });
  1203. expect(() => {
  1204. w.webContents.setIgnoreMenuShortcuts(true);
  1205. w.webContents.setIgnoreMenuShortcuts(false);
  1206. }).to.not.throw();
  1207. });
  1208. });
  1209. const crashPrefs = [
  1210. {
  1211. nodeIntegration: true
  1212. },
  1213. {
  1214. sandbox: true
  1215. }
  1216. ];
  1217. const nicePrefs = (o: any) => {
  1218. let s = '';
  1219. for (const key of Object.keys(o)) {
  1220. s += `${key}=${o[key]}, `;
  1221. }
  1222. return `(${s.slice(0, s.length - 2)})`;
  1223. };
  1224. for (const prefs of crashPrefs) {
  1225. describe(`crash with webPreferences ${nicePrefs(prefs)}`, () => {
  1226. let w: BrowserWindow;
  1227. beforeEach(async () => {
  1228. w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true } });
  1229. await w.loadURL('about:blank');
  1230. });
  1231. afterEach(closeAllWindows);
  1232. it('isCrashed() is false by default', () => {
  1233. expect(w.webContents.isCrashed()).to.equal(false);
  1234. });
  1235. it('forcefullyCrashRenderer() crashes the process with reason=killed||crashed', async () => {
  1236. expect(w.webContents.isCrashed()).to.equal(false);
  1237. const crashEvent = emittedOnce(w.webContents, 'render-process-gone');
  1238. w.webContents.forcefullyCrashRenderer();
  1239. const [, details] = await crashEvent;
  1240. expect(details.reason === 'killed' || details.reason === 'crashed').to.equal(true, 'reason should be killed || crashed');
  1241. expect(w.webContents.isCrashed()).to.equal(true);
  1242. });
  1243. it('a crashed process is recoverable with reload()', async () => {
  1244. expect(w.webContents.isCrashed()).to.equal(false);
  1245. w.webContents.forcefullyCrashRenderer();
  1246. w.webContents.reload();
  1247. expect(w.webContents.isCrashed()).to.equal(false);
  1248. });
  1249. });
  1250. }
  1251. // Destroying webContents in its event listener is going to crash when
  1252. // Electron is built in Debug mode.
  1253. describe('destroy()', () => {
  1254. let server: http.Server;
  1255. let serverUrl: string;
  1256. before((done) => {
  1257. server = http.createServer((request, response) => {
  1258. switch (request.url) {
  1259. case '/net-error':
  1260. response.destroy();
  1261. break;
  1262. case '/200':
  1263. response.end();
  1264. break;
  1265. default:
  1266. done('unsupported endpoint');
  1267. }
  1268. }).listen(0, '127.0.0.1', () => {
  1269. serverUrl = 'http://127.0.0.1:' + (server.address() as AddressInfo).port;
  1270. done();
  1271. });
  1272. });
  1273. after(() => {
  1274. server.close();
  1275. });
  1276. const events = [
  1277. { name: 'did-start-loading', url: '/200' },
  1278. { name: 'dom-ready', url: '/200' },
  1279. { name: 'did-stop-loading', url: '/200' },
  1280. { name: 'did-finish-load', url: '/200' },
  1281. // FIXME: Multiple Emit calls inside an observer assume that object
  1282. // will be alive till end of the observer. Synchronous `destroy` api
  1283. // violates this contract and crashes.
  1284. { name: 'did-frame-finish-load', url: '/200' },
  1285. { name: 'did-fail-load', url: '/net-error' }
  1286. ];
  1287. for (const e of events) {
  1288. it(`should not crash when invoked synchronously inside ${e.name} handler`, async function () {
  1289. // This test is flaky on Windows CI and we don't know why, but the
  1290. // purpose of this test is to make sure Electron does not crash so it
  1291. // is fine to retry this test for a few times.
  1292. this.retries(3);
  1293. const contents = (webContents as any).create() as WebContents;
  1294. const originalEmit = contents.emit.bind(contents);
  1295. contents.emit = (...args) => { return originalEmit(...args); };
  1296. contents.once(e.name as any, () => (contents as any).destroy());
  1297. const destroyed = emittedOnce(contents, 'destroyed');
  1298. contents.loadURL(serverUrl + e.url);
  1299. await destroyed;
  1300. });
  1301. }
  1302. });
  1303. describe('did-change-theme-color event', () => {
  1304. afterEach(closeAllWindows);
  1305. it('is triggered with correct theme color', (done) => {
  1306. const w = new BrowserWindow({ show: true });
  1307. let count = 0;
  1308. w.webContents.on('did-change-theme-color', (e, color) => {
  1309. try {
  1310. if (count === 0) {
  1311. count += 1;
  1312. expect(color).to.equal('#FFEEDD');
  1313. w.loadFile(path.join(fixturesPath, 'pages', 'base-page.html'));
  1314. } else if (count === 1) {
  1315. expect(color).to.be.null();
  1316. done();
  1317. }
  1318. } catch (e) {
  1319. done(e);
  1320. }
  1321. });
  1322. w.loadFile(path.join(fixturesPath, 'pages', 'theme-color.html'));
  1323. });
  1324. });
  1325. describe('console-message event', () => {
  1326. afterEach(closeAllWindows);
  1327. it('is triggered with correct log message', (done) => {
  1328. const w = new BrowserWindow({ show: true });
  1329. w.webContents.on('console-message', (e, level, message) => {
  1330. // Don't just assert as Chromium might emit other logs that we should ignore.
  1331. if (message === 'a') {
  1332. done();
  1333. }
  1334. });
  1335. w.loadFile(path.join(fixturesPath, 'pages', 'a.html'));
  1336. });
  1337. });
  1338. describe('ipc-message event', () => {
  1339. afterEach(closeAllWindows);
  1340. it('emits when the renderer process sends an asynchronous message', async () => {
  1341. const w = new BrowserWindow({ show: true, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  1342. await w.webContents.loadURL('about:blank');
  1343. w.webContents.executeJavaScript(`
  1344. require('electron').ipcRenderer.send('message', 'Hello World!')
  1345. `);
  1346. const [, channel, message] = await emittedOnce(w.webContents, 'ipc-message');
  1347. expect(channel).to.equal('message');
  1348. expect(message).to.equal('Hello World!');
  1349. });
  1350. });
  1351. describe('ipc-message-sync event', () => {
  1352. afterEach(closeAllWindows);
  1353. it('emits when the renderer process sends a synchronous message', async () => {
  1354. const w = new BrowserWindow({ show: true, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  1355. await w.webContents.loadURL('about:blank');
  1356. const promise: Promise<[string, string]> = new Promise(resolve => {
  1357. w.webContents.once('ipc-message-sync', (event, channel, arg) => {
  1358. event.returnValue = 'foobar' as any;
  1359. resolve([channel, arg]);
  1360. });
  1361. });
  1362. const result = await w.webContents.executeJavaScript(`
  1363. require('electron').ipcRenderer.sendSync('message', 'Hello World!')
  1364. `);
  1365. const [channel, message] = await promise;
  1366. expect(channel).to.equal('message');
  1367. expect(message).to.equal('Hello World!');
  1368. expect(result).to.equal('foobar');
  1369. });
  1370. });
  1371. describe('referrer', () => {
  1372. afterEach(closeAllWindows);
  1373. it('propagates referrer information to new target=_blank windows', (done) => {
  1374. const w = new BrowserWindow({ show: false });
  1375. const server = http.createServer((req, res) => {
  1376. if (req.url === '/should_have_referrer') {
  1377. try {
  1378. expect(req.headers.referer).to.equal(`http://127.0.0.1:${(server.address() as AddressInfo).port}/`);
  1379. return done();
  1380. } catch (e) {
  1381. return done(e);
  1382. } finally {
  1383. server.close();
  1384. }
  1385. }
  1386. res.end('<a id="a" href="/should_have_referrer" target="_blank">link</a>');
  1387. });
  1388. server.listen(0, '127.0.0.1', () => {
  1389. const url = 'http://127.0.0.1:' + (server.address() as AddressInfo).port + '/';
  1390. w.webContents.once('did-finish-load', () => {
  1391. w.webContents.once('new-window', (event, newUrl, frameName, disposition, options, features, referrer) => {
  1392. expect(referrer.url).to.equal(url);
  1393. expect(referrer.policy).to.equal('strict-origin-when-cross-origin');
  1394. });
  1395. w.webContents.executeJavaScript('a.click()');
  1396. });
  1397. w.loadURL(url);
  1398. });
  1399. });
  1400. // TODO(jeremy): window.open() in a real browser passes the referrer, but
  1401. // our hacked-up window.open() shim doesn't. It should.
  1402. xit('propagates referrer information to windows opened with window.open', (done) => {
  1403. const w = new BrowserWindow({ show: false });
  1404. const server = http.createServer((req, res) => {
  1405. if (req.url === '/should_have_referrer') {
  1406. try {
  1407. expect(req.headers.referer).to.equal(`http://127.0.0.1:${(server.address() as AddressInfo).port}/`);
  1408. return done();
  1409. } catch (e) {
  1410. return done(e);
  1411. }
  1412. }
  1413. res.end('');
  1414. });
  1415. server.listen(0, '127.0.0.1', () => {
  1416. const url = 'http://127.0.0.1:' + (server.address() as AddressInfo).port + '/';
  1417. w.webContents.once('did-finish-load', () => {
  1418. w.webContents.once('new-window', (event, newUrl, frameName, disposition, options, features, referrer) => {
  1419. expect(referrer.url).to.equal(url);
  1420. expect(referrer.policy).to.equal('no-referrer-when-downgrade');
  1421. });
  1422. w.webContents.executeJavaScript('window.open(location.href + "should_have_referrer")');
  1423. });
  1424. w.loadURL(url);
  1425. });
  1426. });
  1427. });
  1428. describe('webframe messages in sandboxed contents', () => {
  1429. afterEach(closeAllWindows);
  1430. it('responds to executeJavaScript', async () => {
  1431. const w = new BrowserWindow({ show: false, webPreferences: { sandbox: true } });
  1432. await w.loadURL('about:blank');
  1433. const result = await w.webContents.executeJavaScript('37 + 5');
  1434. expect(result).to.equal(42);
  1435. });
  1436. });
  1437. describe('preload-error event', () => {
  1438. afterEach(closeAllWindows);
  1439. const generateSpecs = (description: string, sandbox: boolean) => {
  1440. describe(description, () => {
  1441. it('is triggered when unhandled exception is thrown', async () => {
  1442. const preload = path.join(fixturesPath, 'module', 'preload-error-exception.js');
  1443. const w = new BrowserWindow({
  1444. show: false,
  1445. webPreferences: {
  1446. sandbox,
  1447. preload
  1448. }
  1449. });
  1450. const promise = emittedOnce(w.webContents, 'preload-error');
  1451. w.loadURL('about:blank');
  1452. const [, preloadPath, error] = await promise;
  1453. expect(preloadPath).to.equal(preload);
  1454. expect(error.message).to.equal('Hello World!');
  1455. });
  1456. it('is triggered on syntax errors', async () => {
  1457. const preload = path.join(fixturesPath, 'module', 'preload-error-syntax.js');
  1458. const w = new BrowserWindow({
  1459. show: false,
  1460. webPreferences: {
  1461. sandbox,
  1462. preload
  1463. }
  1464. });
  1465. const promise = emittedOnce(w.webContents, 'preload-error');
  1466. w.loadURL('about:blank');
  1467. const [, preloadPath, error] = await promise;
  1468. expect(preloadPath).to.equal(preload);
  1469. expect(error.message).to.equal('foobar is not defined');
  1470. });
  1471. it('is triggered when preload script loading fails', async () => {
  1472. const preload = path.join(fixturesPath, 'module', 'preload-invalid.js');
  1473. const w = new BrowserWindow({
  1474. show: false,
  1475. webPreferences: {
  1476. sandbox,
  1477. preload
  1478. }
  1479. });
  1480. const promise = emittedOnce(w.webContents, 'preload-error');
  1481. w.loadURL('about:blank');
  1482. const [, preloadPath, error] = await promise;
  1483. expect(preloadPath).to.equal(preload);
  1484. expect(error.message).to.contain('preload-invalid.js');
  1485. });
  1486. });
  1487. };
  1488. generateSpecs('without sandbox', false);
  1489. generateSpecs('with sandbox', true);
  1490. });
  1491. describe('takeHeapSnapshot()', () => {
  1492. afterEach(closeAllWindows);
  1493. it('works with sandboxed renderers', async () => {
  1494. const w = new BrowserWindow({
  1495. show: false,
  1496. webPreferences: {
  1497. sandbox: true
  1498. }
  1499. });
  1500. await w.loadURL('about:blank');
  1501. const filePath = path.join(app.getPath('temp'), 'test.heapsnapshot');
  1502. const cleanup = () => {
  1503. try {
  1504. fs.unlinkSync(filePath);
  1505. } catch (e) {
  1506. // ignore error
  1507. }
  1508. };
  1509. try {
  1510. await w.webContents.takeHeapSnapshot(filePath);
  1511. const stats = fs.statSync(filePath);
  1512. expect(stats.size).not.to.be.equal(0);
  1513. } finally {
  1514. cleanup();
  1515. }
  1516. });
  1517. it('fails with invalid file path', async () => {
  1518. const w = new BrowserWindow({
  1519. show: false,
  1520. webPreferences: {
  1521. sandbox: true
  1522. }
  1523. });
  1524. await w.loadURL('about:blank');
  1525. const promise = w.webContents.takeHeapSnapshot('');
  1526. return expect(promise).to.be.eventually.rejectedWith(Error, 'takeHeapSnapshot failed');
  1527. });
  1528. });
  1529. describe('setBackgroundThrottling()', () => {
  1530. afterEach(closeAllWindows);
  1531. it('does not crash when allowing', () => {
  1532. const w = new BrowserWindow({ show: false });
  1533. w.webContents.setBackgroundThrottling(true);
  1534. });
  1535. it('does not crash when called via BrowserWindow', () => {
  1536. const w = new BrowserWindow({ show: false });
  1537. (w as any).setBackgroundThrottling(true);
  1538. });
  1539. it('does not crash when disallowing', () => {
  1540. const w = new BrowserWindow({ show: false, webPreferences: { backgroundThrottling: true } });
  1541. w.webContents.setBackgroundThrottling(false);
  1542. });
  1543. });
  1544. describe('getBackgroundThrottling()', () => {
  1545. afterEach(closeAllWindows);
  1546. it('works via getter', () => {
  1547. const w = new BrowserWindow({ show: false });
  1548. w.webContents.setBackgroundThrottling(false);
  1549. expect(w.webContents.getBackgroundThrottling()).to.equal(false);
  1550. w.webContents.setBackgroundThrottling(true);
  1551. expect(w.webContents.getBackgroundThrottling()).to.equal(true);
  1552. });
  1553. it('works via property', () => {
  1554. const w = new BrowserWindow({ show: false });
  1555. w.webContents.backgroundThrottling = false;
  1556. expect(w.webContents.backgroundThrottling).to.equal(false);
  1557. w.webContents.backgroundThrottling = true;
  1558. expect(w.webContents.backgroundThrottling).to.equal(true);
  1559. });
  1560. it('works via BrowserWindow', () => {
  1561. const w = new BrowserWindow({ show: false });
  1562. (w as any).setBackgroundThrottling(false);
  1563. expect((w as any).getBackgroundThrottling()).to.equal(false);
  1564. (w as any).setBackgroundThrottling(true);
  1565. expect((w as any).getBackgroundThrottling()).to.equal(true);
  1566. });
  1567. });
  1568. ifdescribe(features.isPrintingEnabled())('getPrinters()', () => {
  1569. afterEach(closeAllWindows);
  1570. it('can get printer list', async () => {
  1571. const w = new BrowserWindow({ show: false, webPreferences: { sandbox: true } });
  1572. await w.loadURL('about:blank');
  1573. const printers = w.webContents.getPrinters();
  1574. expect(printers).to.be.an('array');
  1575. });
  1576. });
  1577. ifdescribe(features.isPrintingEnabled())('getPrintersAsync()', () => {
  1578. afterEach(closeAllWindows);
  1579. it('can get printer list', async () => {
  1580. const w = new BrowserWindow({ show: false, webPreferences: { sandbox: true } });
  1581. await w.loadURL('about:blank');
  1582. const printers = await w.webContents.getPrintersAsync();
  1583. expect(printers).to.be.an('array');
  1584. });
  1585. });
  1586. ifdescribe(features.isPrintingEnabled())('printToPDF()', () => {
  1587. let w: BrowserWindow;
  1588. beforeEach(async () => {
  1589. w = new BrowserWindow({ show: false, webPreferences: { sandbox: true } });
  1590. await w.loadURL('data:text/html,<h1>Hello, World!</h1>');
  1591. });
  1592. afterEach(closeAllWindows);
  1593. it('rejects on incorrectly typed parameters', async () => {
  1594. const badTypes = {
  1595. marginsType: 'terrible',
  1596. scaleFactor: 'not-a-number',
  1597. landscape: [],
  1598. pageRanges: { oops: 'im-not-the-right-key' },
  1599. headerFooter: '123',
  1600. printSelectionOnly: 1,
  1601. printBackground: 2,
  1602. pageSize: 'IAmAPageSize'
  1603. };
  1604. // These will hard crash in Chromium unless we type-check
  1605. for (const [key, value] of Object.entries(badTypes)) {
  1606. const param = { [key]: value };
  1607. await expect(w.webContents.printToPDF(param)).to.eventually.be.rejected();
  1608. }
  1609. });
  1610. it('can print to PDF', async () => {
  1611. const data = await w.webContents.printToPDF({});
  1612. expect(data).to.be.an.instanceof(Buffer).that.is.not.empty();
  1613. });
  1614. it('does not crash when called multiple times in parallel', async () => {
  1615. const promises = [];
  1616. for (let i = 0; i < 3; i++) {
  1617. promises.push(w.webContents.printToPDF({}));
  1618. }
  1619. const results = await Promise.all(promises);
  1620. for (const data of results) {
  1621. expect(data).to.be.an.instanceof(Buffer).that.is.not.empty();
  1622. }
  1623. });
  1624. it('does not crash when called multiple times in sequence', async () => {
  1625. const results = [];
  1626. for (let i = 0; i < 3; i++) {
  1627. const result = await w.webContents.printToPDF({});
  1628. results.push(result);
  1629. }
  1630. for (const data of results) {
  1631. expect(data).to.be.an.instanceof(Buffer).that.is.not.empty();
  1632. }
  1633. });
  1634. // TODO(codebytere): Re-enable after Chromium fixes upstream v8_scriptormodule_legacy_lifetime crash.
  1635. xdescribe('using a large document', () => {
  1636. beforeEach(async () => {
  1637. w = new BrowserWindow({ show: false, webPreferences: { sandbox: true } });
  1638. await w.loadFile(path.join(__dirname, 'fixtures', 'api', 'print-to-pdf.html'));
  1639. });
  1640. afterEach(closeAllWindows);
  1641. it('respects custom settings', async () => {
  1642. const data = await w.webContents.printToPDF({
  1643. pageRanges: {
  1644. from: 0,
  1645. to: 2
  1646. },
  1647. landscape: true
  1648. });
  1649. const doc = await pdfjs.getDocument(data).promise;
  1650. // Check that correct # of pages are rendered.
  1651. expect(doc.numPages).to.equal(3);
  1652. // Check that PDF is generated in landscape mode.
  1653. const firstPage = await doc.getPage(1);
  1654. const { width, height } = firstPage.getViewport({ scale: 100 });
  1655. expect(width).to.be.greaterThan(height);
  1656. });
  1657. });
  1658. });
  1659. describe('PictureInPicture video', () => {
  1660. afterEach(closeAllWindows);
  1661. it('works as expected', async function () {
  1662. const w = new BrowserWindow({ show: false, webPreferences: { sandbox: true } });
  1663. await w.loadFile(path.join(fixturesPath, 'api', 'picture-in-picture.html'));
  1664. if (!await w.webContents.executeJavaScript('document.createElement(\'video\').canPlayType(\'video/webm; codecs="vp8.0"\')')) {
  1665. this.skip();
  1666. }
  1667. const result = await w.webContents.executeJavaScript(
  1668. `runTest(${features.isPictureInPictureEnabled()})`, true);
  1669. expect(result).to.be.true();
  1670. });
  1671. });
  1672. describe('devtools window', () => {
  1673. let hasRobotJS = false;
  1674. try {
  1675. // We have other tests that check if native modules work, if we fail to require
  1676. // robotjs let's skip this test to avoid false negatives
  1677. require('robotjs');
  1678. hasRobotJS = true;
  1679. } catch (err) { /* no-op */ }
  1680. afterEach(closeAllWindows);
  1681. // NB. on macOS, this requires that you grant your terminal the ability to
  1682. // control your computer. Open System Preferences > Security & Privacy >
  1683. // Privacy > Accessibility and grant your terminal the permission to control
  1684. // your computer.
  1685. ifit(hasRobotJS)('can receive and handle menu events', async () => {
  1686. const w = new BrowserWindow({ show: true, webPreferences: { nodeIntegration: true } });
  1687. w.loadFile(path.join(fixturesPath, 'pages', 'key-events.html'));
  1688. // Ensure the devtools are loaded
  1689. w.webContents.closeDevTools();
  1690. const opened = emittedOnce(w.webContents, 'devtools-opened');
  1691. w.webContents.openDevTools();
  1692. await opened;
  1693. await emittedOnce(w.webContents.devToolsWebContents!, 'did-finish-load');
  1694. w.webContents.devToolsWebContents!.focus();
  1695. // Focus an input field
  1696. await w.webContents.devToolsWebContents!.executeJavaScript(`
  1697. const input = document.createElement('input')
  1698. document.body.innerHTML = ''
  1699. document.body.appendChild(input)
  1700. input.focus()
  1701. `);
  1702. // Write something to the clipboard
  1703. clipboard.writeText('test value');
  1704. const pasted = w.webContents.devToolsWebContents!.executeJavaScript(`new Promise(resolve => {
  1705. document.querySelector('input').addEventListener('paste', (e) => {
  1706. resolve(e.target.value)
  1707. })
  1708. })`);
  1709. // Fake a paste request using robotjs to emulate a REAL keyboard paste event
  1710. require('robotjs').keyTap('v', process.platform === 'darwin' ? ['command'] : ['control']);
  1711. const val = await pasted;
  1712. // Once we're done expect the paste to have been successful
  1713. expect(val).to.equal('test value', 'value should eventually become the pasted value');
  1714. });
  1715. });
  1716. describe('Shared Workers', () => {
  1717. afterEach(closeAllWindows);
  1718. it('can get multiple shared workers', async () => {
  1719. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  1720. const ready = emittedOnce(ipcMain, 'ready');
  1721. w.loadFile(path.join(fixturesPath, 'api', 'shared-worker', 'shared-worker.html'));
  1722. await ready;
  1723. const sharedWorkers = w.webContents.getAllSharedWorkers();
  1724. expect(sharedWorkers).to.have.lengthOf(2);
  1725. expect(sharedWorkers[0].url).to.contain('shared-worker');
  1726. expect(sharedWorkers[1].url).to.contain('shared-worker');
  1727. });
  1728. it('can inspect a specific shared worker', async () => {
  1729. const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
  1730. const ready = emittedOnce(ipcMain, 'ready');
  1731. w.loadFile(path.join(fixturesPath, 'api', 'shared-worker', 'shared-worker.html'));
  1732. await ready;
  1733. const sharedWorkers = w.webContents.getAllSharedWorkers();
  1734. const devtoolsOpened = emittedOnce(w.webContents, 'devtools-opened');
  1735. w.webContents.inspectSharedWorkerById(sharedWorkers[0].id);
  1736. await devtoolsOpened;
  1737. const devtoolsClosed = emittedOnce(w.webContents, 'devtools-closed');
  1738. w.webContents.closeDevTools();
  1739. await devtoolsClosed;
  1740. });
  1741. });
  1742. describe('login event', () => {
  1743. afterEach(closeAllWindows);
  1744. let server: http.Server;
  1745. let serverUrl: string;
  1746. let serverPort: number;
  1747. let proxyServer: http.Server;
  1748. let proxyServerPort: number;
  1749. before((done) => {
  1750. server = http.createServer((request, response) => {
  1751. if (request.url === '/no-auth') {
  1752. return response.end('ok');
  1753. }
  1754. if (request.headers.authorization) {
  1755. response.writeHead(200, { 'Content-type': 'text/plain' });
  1756. return response.end(request.headers.authorization);
  1757. }
  1758. response
  1759. .writeHead(401, { 'WWW-Authenticate': 'Basic realm="Foo"' })
  1760. .end('401');
  1761. }).listen(0, '127.0.0.1', () => {
  1762. serverPort = (server.address() as AddressInfo).port;
  1763. serverUrl = `http://127.0.0.1:${serverPort}`;
  1764. done();
  1765. });
  1766. });
  1767. before((done) => {
  1768. proxyServer = http.createServer((request, response) => {
  1769. if (request.headers['proxy-authorization']) {
  1770. response.writeHead(200, { 'Content-type': 'text/plain' });
  1771. return response.end(request.headers['proxy-authorization']);
  1772. }
  1773. response
  1774. .writeHead(407, { 'Proxy-Authenticate': 'Basic realm="Foo"' })
  1775. .end();
  1776. }).listen(0, '127.0.0.1', () => {
  1777. proxyServerPort = (proxyServer.address() as AddressInfo).port;
  1778. done();
  1779. });
  1780. });
  1781. afterEach(async () => {
  1782. await session.defaultSession.clearAuthCache();
  1783. });
  1784. after(() => {
  1785. server.close();
  1786. proxyServer.close();
  1787. });
  1788. it('is emitted when navigating', async () => {
  1789. const [user, pass] = ['user', 'pass'];
  1790. const w = new BrowserWindow({ show: false });
  1791. let eventRequest: any;
  1792. let eventAuthInfo: any;
  1793. w.webContents.on('login', (event, request, authInfo, cb) => {
  1794. eventRequest = request;
  1795. eventAuthInfo = authInfo;
  1796. event.preventDefault();
  1797. cb(user, pass);
  1798. });
  1799. await w.loadURL(serverUrl);
  1800. const body = await w.webContents.executeJavaScript('document.documentElement.textContent');
  1801. expect(body).to.equal(`Basic ${Buffer.from(`${user}:${pass}`).toString('base64')}`);
  1802. expect(eventRequest.url).to.equal(serverUrl + '/');
  1803. expect(eventAuthInfo.isProxy).to.be.false();
  1804. expect(eventAuthInfo.scheme).to.equal('basic');
  1805. expect(eventAuthInfo.host).to.equal('127.0.0.1');
  1806. expect(eventAuthInfo.port).to.equal(serverPort);
  1807. expect(eventAuthInfo.realm).to.equal('Foo');
  1808. });
  1809. it('is emitted when a proxy requests authorization', async () => {
  1810. const customSession = session.fromPartition(`${Math.random()}`);
  1811. await customSession.setProxy({ proxyRules: `127.0.0.1:${proxyServerPort}`, proxyBypassRules: '<-loopback>' });
  1812. const [user, pass] = ['user', 'pass'];
  1813. const w = new BrowserWindow({ show: false, webPreferences: { session: customSession } });
  1814. let eventRequest: any;
  1815. let eventAuthInfo: any;
  1816. w.webContents.on('login', (event, request, authInfo, cb) => {
  1817. eventRequest = request;
  1818. eventAuthInfo = authInfo;
  1819. event.preventDefault();
  1820. cb(user, pass);
  1821. });
  1822. await w.loadURL(`${serverUrl}/no-auth`);
  1823. const body = await w.webContents.executeJavaScript('document.documentElement.textContent');
  1824. expect(body).to.equal(`Basic ${Buffer.from(`${user}:${pass}`).toString('base64')}`);
  1825. expect(eventRequest.url).to.equal(`${serverUrl}/no-auth`);
  1826. expect(eventAuthInfo.isProxy).to.be.true();
  1827. expect(eventAuthInfo.scheme).to.equal('basic');
  1828. expect(eventAuthInfo.host).to.equal('127.0.0.1');
  1829. expect(eventAuthInfo.port).to.equal(proxyServerPort);
  1830. expect(eventAuthInfo.realm).to.equal('Foo');
  1831. });
  1832. it('cancels authentication when callback is called with no arguments', async () => {
  1833. const w = new BrowserWindow({ show: false });
  1834. w.webContents.on('login', (event, request, authInfo, cb) => {
  1835. event.preventDefault();
  1836. cb();
  1837. });
  1838. await w.loadURL(serverUrl);
  1839. const body = await w.webContents.executeJavaScript('document.documentElement.textContent');
  1840. expect(body).to.equal('401');
  1841. });
  1842. });
  1843. describe('page-title-updated event', () => {
  1844. afterEach(closeAllWindows);
  1845. it('is emitted with a full title for pages with no navigation', async () => {
  1846. const bw = new BrowserWindow({ show: false });
  1847. await bw.loadURL('about:blank');
  1848. bw.webContents.executeJavaScript('child = window.open("", "", "show=no"); null');
  1849. const [, child] = await emittedOnce(app, 'web-contents-created');
  1850. bw.webContents.executeJavaScript('child.document.title = "new title"');
  1851. const [, title] = await emittedOnce(child, 'page-title-updated');
  1852. expect(title).to.equal('new title');
  1853. });
  1854. });
  1855. describe('crashed event', () => {
  1856. it('does not crash main process when destroying WebContents in it', (done) => {
  1857. const contents = (webContents as any).create({ nodeIntegration: true });
  1858. contents.once('crashed', () => {
  1859. contents.destroy();
  1860. done();
  1861. });
  1862. contents.loadURL('about:blank').then(() => contents.forcefullyCrashRenderer());
  1863. });
  1864. });
  1865. describe('context-menu event', () => {
  1866. afterEach(closeAllWindows);
  1867. it('emits when right-clicked in page', async () => {
  1868. const w = new BrowserWindow({ show: false });
  1869. await w.loadFile(path.join(fixturesPath, 'pages', 'base-page.html'));
  1870. const promise = emittedOnce(w.webContents, 'context-menu');
  1871. // Simulate right-click to create context-menu event.
  1872. const opts = { x: 0, y: 0, button: 'right' as any };
  1873. w.webContents.sendInputEvent({ ...opts, type: 'mouseDown' });
  1874. w.webContents.sendInputEvent({ ...opts, type: 'mouseUp' });
  1875. const [, params] = await promise;
  1876. expect(params.pageURL).to.equal(w.webContents.getURL());
  1877. expect(params.frame).to.be.an('object');
  1878. expect(params.x).to.be.a('number');
  1879. expect(params.y).to.be.a('number');
  1880. });
  1881. });
  1882. it('emits a cancelable event before creating a child webcontents', async () => {
  1883. const w = new BrowserWindow({
  1884. show: false,
  1885. webPreferences: {
  1886. sandbox: true
  1887. }
  1888. });
  1889. w.webContents.on('-will-add-new-contents' as any, (event: any, url: any) => {
  1890. expect(url).to.equal('about:blank');
  1891. event.preventDefault();
  1892. });
  1893. let wasCalled = false;
  1894. w.webContents.on('new-window' as any, () => {
  1895. wasCalled = true;
  1896. });
  1897. await w.loadURL('about:blank');
  1898. await w.webContents.executeJavaScript('window.open(\'about:blank\')');
  1899. await new Promise((resolve) => { process.nextTick(resolve); });
  1900. expect(wasCalled).to.equal(false);
  1901. await closeAllWindows();
  1902. });
  1903. });