123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344134513461347134813491350135113521353135413551356135713581359136013611362136313641365136613671368136913701371137213731374137513761377137813791380138113821383138413851386138713881389139013911392139313941395139613971398139914001401140214031404140514061407140814091410141114121413141414151416141714181419142014211422142314241425142614271428142914301431143214331434143514361437143814391440144114421443144414451446144714481449145014511452145314541455145614571458145914601461146214631464146514661467146814691470147114721473147414751476147714781479148014811482148314841485148614871488148914901491149214931494149514961497149814991500150115021503150415051506150715081509151015111512151315141515151615171518151915201521152215231524152515261527152815291530153115321533153415351536153715381539154015411542154315441545154615471548154915501551155215531554155515561557155815591560156115621563156415651566156715681569157015711572157315741575157615771578157915801581158215831584158515861587158815891590159115921593159415951596159715981599160016011602160316041605160616071608160916101611161216131614161516161617161816191620162116221623162416251626162716281629163016311632163316341635163616371638163916401641164216431644164516461647164816491650165116521653165416551656165716581659166016611662166316641665166616671668166916701671167216731674167516761677167816791680168116821683168416851686168716881689169016911692169316941695169616971698169917001701170217031704170517061707170817091710171117121713171417151716171717181719172017211722172317241725172617271728172917301731173217331734173517361737173817391740174117421743174417451746174717481749175017511752175317541755175617571758175917601761176217631764176517661767176817691770177117721773177417751776177717781779178017811782178317841785178617871788178917901791179217931794179517961797179817991800180118021803180418051806180718081809181018111812181318141815181618171818181918201821182218231824182518261827182818291830183118321833183418351836183718381839184018411842184318441845184618471848184918501851185218531854185518561857185818591860186118621863186418651866186718681869187018711872187318741875187618771878187918801881188218831884188518861887188818891890189118921893189418951896189718981899190019011902190319041905190619071908190919101911191219131914191519161917191819191920192119221923192419251926192719281929193019311932193319341935193619371938193919401941194219431944194519461947194819491950195119521953195419551956195719581959196019611962196319641965196619671968196919701971197219731974197519761977197819791980198119821983198419851986198719881989199019911992199319941995199619971998199920002001200220032004200520062007200820092010201120122013201420152016201720182019202020212022202320242025202620272028202920302031203220332034203520362037203820392040204120422043204420452046204720482049205020512052205320542055205620572058205920602061206220632064206520662067206820692070207120722073207420752076207720782079208020812082208320842085208620872088208920902091209220932094209520962097209820992100210121022103210421052106210721082109211021112112211321142115211621172118211921202121212221232124212521262127212821292130213121322133213421352136213721382139214021412142214321442145214621472148214921502151215221532154215521562157215821592160216121622163216421652166216721682169217021712172217321742175217621772178217921802181218221832184218521862187218821892190219121922193219421952196219721982199220022012202220322042205220622072208220922102211221222132214221522162217221822192220222122222223222422252226222722282229223022312232223322342235223622372238223922402241224222432244224522462247224822492250225122522253225422552256225722582259226022612262226322642265226622672268226922702271227222732274227522762277227822792280228122822283228422852286228722882289229022912292229322942295229622972298229923002301230223032304230523062307230823092310231123122313231423152316231723182319232023212322232323242325232623272328232923302331233223332334233523362337233823392340234123422343234423452346234723482349235023512352235323542355235623572358235923602361236223632364236523662367236823692370237123722373237423752376237723782379238023812382238323842385238623872388238923902391239223932394239523962397239823992400240124022403240424052406240724082409241024112412241324142415241624172418241924202421242224232424242524262427242824292430243124322433243424352436243724382439244024412442244324442445244624472448244924502451245224532454245524562457245824592460246124622463246424652466246724682469247024712472247324742475247624772478247924802481248224832484248524862487248824892490249124922493249424952496249724982499250025012502250325042505250625072508250925102511251225132514251525162517251825192520252125222523252425252526252725282529253025312532253325342535253625372538253925402541254225432544254525462547254825492550255125522553255425552556255725582559256025612562256325642565256625672568256925702571257225732574257525762577257825792580258125822583258425852586258725882589259025912592259325942595259625972598259926002601260226032604260526062607260826092610261126122613261426152616261726182619262026212622262326242625262626272628262926302631263226332634263526362637263826392640264126422643264426452646264726482649265026512652265326542655265626572658265926602661266226632664266526662667266826692670267126722673267426752676267726782679268026812682268326842685268626872688268926902691269226932694269526962697269826992700270127022703270427052706270727082709271027112712271327142715271627172718271927202721272227232724272527262727272827292730273127322733273427352736273727382739274027412742274327442745274627472748274927502751275227532754275527562757275827592760276127622763276427652766276727682769277027712772277327742775277627772778277927802781278227832784278527862787278827892790279127922793279427952796279727982799280028012802280328042805280628072808280928102811281228132814281528162817281828192820282128222823282428252826282728282829283028312832283328342835283628372838283928402841284228432844284528462847284828492850285128522853285428552856285728582859286028612862286328642865286628672868286928702871287228732874287528762877287828792880288128822883288428852886288728882889289028912892289328942895289628972898289929002901290229032904290529062907290829092910291129122913291429152916291729182919292029212922292329242925292629272928292929302931293229332934293529362937293829392940294129422943294429452946294729482949295029512952295329542955295629572958295929602961296229632964296529662967296829692970297129722973297429752976297729782979298029812982298329842985298629872988298929902991299229932994299529962997299829993000300130023003300430053006300730083009301030113012301330143015301630173018301930203021302230233024302530263027302830293030303130323033303430353036303730383039304030413042304330443045304630473048304930503051305230533054305530563057305830593060306130623063306430653066306730683069307030713072307330743075307630773078307930803081308230833084308530863087308830893090309130923093309430953096309730983099310031013102310331043105310631073108310931103111311231133114311531163117311831193120312131223123312431253126312731283129313031313132313331343135313631373138313931403141314231433144314531463147314831493150315131523153315431553156315731583159316031613162316331643165316631673168316931703171317231733174317531763177317831793180318131823183318431853186318731883189319031913192319331943195319631973198319932003201320232033204320532063207320832093210321132123213321432153216321732183219322032213222322332243225322632273228322932303231323232333234323532363237323832393240324132423243324432453246324732483249325032513252325332543255325632573258325932603261326232633264326532663267326832693270327132723273327432753276327732783279328032813282328332843285328632873288328932903291329232933294329532963297329832993300330133023303330433053306330733083309331033113312331333143315331633173318331933203321332233233324332533263327 |
- import { expect } from 'chai';
- import { BrowserWindow, WebContents, webFrameMain, session, ipcMain, app, protocol, webContents } from 'electron/main';
- import { closeAllWindows } from './lib/window-helpers';
- import * as https from 'node:https';
- import * as http from 'node:http';
- import * as path from 'node:path';
- import * as fs from 'node:fs';
- import * as url from 'node:url';
- import * as ChildProcess from 'node:child_process';
- import { EventEmitter, once } from 'node:events';
- import { promisify } from 'node:util';
- import { ifit, ifdescribe, defer, itremote, listen } from './lib/spec-helpers';
- import { PipeTransport } from './pipe-transport';
- import * as ws from 'ws';
- import { setTimeout } from 'node:timers/promises';
- const features = process._linkedBinding('electron_common_features');
- const fixturesPath = path.resolve(__dirname, 'fixtures');
- const certPath = path.join(fixturesPath, 'certificates');
- describe('reporting api', () => {
- it('sends a report for an intervention', async () => {
- const reporting = new EventEmitter();
- // The Reporting API only works on https with valid certs. To dodge having
- // to set up a trusted certificate, hack the validator.
- session.defaultSession.setCertificateVerifyProc((req, cb) => {
- cb(0);
- });
- const options = {
- key: fs.readFileSync(path.join(certPath, 'server.key')),
- cert: fs.readFileSync(path.join(certPath, 'server.pem')),
- ca: [
- fs.readFileSync(path.join(certPath, 'rootCA.pem')),
- fs.readFileSync(path.join(certPath, 'intermediateCA.pem'))
- ],
- requestCert: true,
- rejectUnauthorized: false
- };
- const server = https.createServer(options, (req, res) => {
- if (req.url?.endsWith('report')) {
- let data = '';
- req.on('data', (d) => { data += d.toString('utf-8'); });
- req.on('end', () => {
- reporting.emit('report', JSON.parse(data));
- });
- }
- const { port } = server.address() as any;
- res.setHeader('Reporting-Endpoints', `default="https://localhost:${port}/report"`);
- res.setHeader('Content-Type', 'text/html');
- res.end('<script>window.navigator.vibrate(1)</script>');
- });
- await new Promise<void>(resolve => server.listen(0, '127.0.0.1', resolve));
- const bw = new BrowserWindow({ show: false });
- try {
- const reportGenerated = once(reporting, 'report');
- await bw.loadURL(`https://localhost:${(server.address() as any).port}/a`);
- const [reports] = await reportGenerated;
- expect(reports).to.be.an('array').with.lengthOf(1);
- const { type, url, body } = reports[0];
- expect(type).to.equal('intervention');
- expect(url).to.equal(url);
- expect(body.id).to.equal('NavigatorVibrate');
- expect(body.message).to.match(/Blocked call to navigator.vibrate because user hasn't tapped on the frame or any embedded frame yet/);
- } finally {
- bw.destroy();
- server.close();
- }
- });
- });
- describe('window.postMessage', () => {
- afterEach(async () => {
- await closeAllWindows();
- });
- it('sets the source and origin correctly', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
- w.loadURL(`file://${fixturesPath}/pages/window-open-postMessage-driver.html`);
- const [, message] = await once(ipcMain, 'complete');
- expect(message.data).to.equal('testing');
- expect(message.origin).to.equal('file://');
- expect(message.sourceEqualsOpener).to.equal(true);
- expect(message.eventOrigin).to.equal('file://');
- });
- });
- describe('focus handling', () => {
- let webviewContents: WebContents;
- let w: BrowserWindow;
- beforeEach(async () => {
- w = new BrowserWindow({
- show: true,
- webPreferences: {
- nodeIntegration: true,
- webviewTag: true,
- contextIsolation: false
- }
- });
- const webviewReady = once(w.webContents, 'did-attach-webview') as Promise<[any, WebContents]>;
- await w.loadFile(path.join(fixturesPath, 'pages', 'tab-focus-loop-elements.html'));
- const [, wvContents] = await webviewReady;
- webviewContents = wvContents;
- await once(webviewContents, 'did-finish-load');
- w.focus();
- });
- afterEach(() => {
- webviewContents = null as unknown as WebContents;
- w.destroy();
- w = null as unknown as BrowserWindow;
- });
- const expectFocusChange = async () => {
- const [, focusedElementId] = await once(ipcMain, 'focus-changed');
- return focusedElementId;
- };
- describe('a TAB press', () => {
- const tabPressEvent: any = {
- type: 'keyDown',
- keyCode: 'Tab'
- };
- it('moves focus to the next focusable item', async () => {
- let focusChange = expectFocusChange();
- w.webContents.sendInputEvent(tabPressEvent);
- let focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-1', `should start focused in element-1, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- w.webContents.sendInputEvent(tabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-2', `focus should've moved to element-2, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- w.webContents.sendInputEvent(tabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-wv-element-1', `focus should've moved to the webview's element-1, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- webviewContents.sendInputEvent(tabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-wv-element-2', `focus should've moved to the webview's element-2, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- webviewContents.sendInputEvent(tabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-3', `focus should've moved to element-3, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- w.webContents.sendInputEvent(tabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-1', `focus should've looped back to element-1, it's instead in ${focusedElementId}`);
- });
- });
- describe('a SHIFT + TAB press', () => {
- const shiftTabPressEvent: any = {
- type: 'keyDown',
- modifiers: ['Shift'],
- keyCode: 'Tab'
- };
- it('moves focus to the previous focusable item', async () => {
- let focusChange = expectFocusChange();
- w.webContents.sendInputEvent(shiftTabPressEvent);
- let focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-3', `should start focused in element-3, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- w.webContents.sendInputEvent(shiftTabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-wv-element-2', `focus should've moved to the webview's element-2, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- webviewContents.sendInputEvent(shiftTabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-wv-element-1', `focus should've moved to the webview's element-1, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- webviewContents.sendInputEvent(shiftTabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-2', `focus should've moved to element-2, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- w.webContents.sendInputEvent(shiftTabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-1', `focus should've moved to element-1, it's instead in ${focusedElementId}`);
- focusChange = expectFocusChange();
- w.webContents.sendInputEvent(shiftTabPressEvent);
- focusedElementId = await focusChange;
- expect(focusedElementId).to.equal('BUTTON-element-3', `focus should've looped back to element-3, it's instead in ${focusedElementId}`);
- });
- });
- });
- describe('web security', () => {
- afterEach(closeAllWindows);
- let server: http.Server;
- let serverUrl: string;
- before(async () => {
- server = http.createServer((req, res) => {
- res.setHeader('Content-Type', 'text/html');
- res.end('<body>');
- });
- serverUrl = (await listen(server)).url;
- });
- after(() => {
- server.close();
- });
- it('engages CORB when web security is not disabled', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { webSecurity: true, nodeIntegration: true, contextIsolation: false } });
- const p = once(ipcMain, 'success');
- await w.loadURL(`data:text/html,<script>
- const s = document.createElement('script')
- s.src = "${serverUrl}"
- // The script will load successfully but its body will be emptied out
- // by CORB, so we don't expect a syntax error.
- s.onload = () => { require('electron').ipcRenderer.send('success') }
- document.documentElement.appendChild(s)
- </script>`);
- await p;
- });
- it('bypasses CORB when web security is disabled', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { webSecurity: false, nodeIntegration: true, contextIsolation: false } });
- const p = once(ipcMain, 'success');
- await w.loadURL(`data:text/html,
- <script>
- window.onerror = (e) => { require('electron').ipcRenderer.send('success', e) }
- </script>
- <script src="${serverUrl}"></script>`);
- await p;
- });
- it('engages CORS when web security is not disabled', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { webSecurity: true, nodeIntegration: true, contextIsolation: false } });
- const p = once(ipcMain, 'response');
- await w.loadURL(`data:text/html,<script>
- (async function() {
- try {
- await fetch('${serverUrl}');
- require('electron').ipcRenderer.send('response', 'passed');
- } catch {
- require('electron').ipcRenderer.send('response', 'failed');
- }
- })();
- </script>`);
- const [, response] = await p;
- expect(response).to.equal('failed');
- });
- it('bypasses CORS when web security is disabled', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { webSecurity: false, nodeIntegration: true, contextIsolation: false } });
- const p = once(ipcMain, 'response');
- await w.loadURL(`data:text/html,<script>
- (async function() {
- try {
- await fetch('${serverUrl}');
- require('electron').ipcRenderer.send('response', 'passed');
- } catch {
- require('electron').ipcRenderer.send('response', 'failed');
- }
- })();
- </script>`);
- const [, response] = await p;
- expect(response).to.equal('passed');
- });
- describe('accessing file://', () => {
- async function loadFile (w: BrowserWindow) {
- const thisFile = url.format({
- pathname: __filename.replace(/\\/g, '/'),
- protocol: 'file',
- slashes: true
- });
- await w.loadURL(`data:text/html,<script>
- function loadFile() {
- return new Promise((resolve) => {
- fetch('${thisFile}').then(
- () => resolve('loaded'),
- () => resolve('failed')
- )
- });
- }
- </script>`);
- return await w.webContents.executeJavaScript('loadFile()');
- }
- it('is forbidden when web security is enabled', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { webSecurity: true } });
- const result = await loadFile(w);
- expect(result).to.equal('failed');
- });
- it('is allowed when web security is disabled', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { webSecurity: false } });
- const result = await loadFile(w);
- expect(result).to.equal('loaded');
- });
- });
- describe('wasm-eval csp', () => {
- async function loadWasm (csp: string) {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- sandbox: true,
- enableBlinkFeatures: 'WebAssemblyCSP'
- }
- });
- await w.loadURL(`data:text/html,<head>
- <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self' 'unsafe-inline' ${csp}">
- </head>
- <script>
- function loadWasm() {
- const wasmBin = new Uint8Array([0, 97, 115, 109, 1, 0, 0, 0])
- return new Promise((resolve) => {
- WebAssembly.instantiate(wasmBin).then(() => {
- resolve('loaded')
- }).catch((error) => {
- resolve(error.message)
- })
- });
- }
- </script>`);
- return await w.webContents.executeJavaScript('loadWasm()');
- }
- it('wasm codegen is disallowed by default', async () => {
- const r = await loadWasm('');
- expect(r).to.equal('WebAssembly.instantiate(): Refused to compile or instantiate WebAssembly module because \'unsafe-eval\' is not an allowed source of script in the following Content Security Policy directive: "script-src \'self\' \'unsafe-inline\'"');
- });
- it('wasm codegen is allowed with "wasm-unsafe-eval" csp', async () => {
- const r = await loadWasm("'wasm-unsafe-eval'");
- expect(r).to.equal('loaded');
- });
- });
- describe('csp', () => {
- for (const sandbox of [true, false]) {
- describe(`when sandbox: ${sandbox}`, () => {
- for (const contextIsolation of [true, false]) {
- describe(`when contextIsolation: ${contextIsolation}`, () => {
- it('prevents eval from running in an inline script', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: { sandbox, contextIsolation }
- });
- w.loadURL(`data:text/html,<head>
- <meta http-equiv="Content-Security-Policy" content="default-src 'self'; script-src 'self' 'unsafe-inline'">
- </head>
- <script>
- try {
- // We use console.log here because it is easier than making a
- // preload script, and the behavior under test changes when
- // contextIsolation: false
- console.log(eval('true'))
- } catch (e) {
- console.log(e.message)
- }
- </script>`);
- const [,, message] = await once(w.webContents, 'console-message');
- expect(message).to.match(/Refused to evaluate a string/);
- });
- it('does not prevent eval from running in an inline script when there is no csp', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: { sandbox, contextIsolation }
- });
- w.loadURL(`data:text/html,
- <script>
- try {
- // We use console.log here because it is easier than making a
- // preload script, and the behavior under test changes when
- // contextIsolation: false
- console.log(eval('true'))
- } catch (e) {
- console.log(e.message)
- }
- </script>`);
- const [,, message] = await once(w.webContents, 'console-message');
- expect(message).to.equal('true');
- });
- it('prevents eval from running in executeJavaScript', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: { sandbox, contextIsolation }
- });
- w.loadURL('data:text/html,<head><meta http-equiv="Content-Security-Policy" content="default-src \'self\'; script-src \'self\' \'unsafe-inline\'"></meta></head>');
- await expect(w.webContents.executeJavaScript('eval("true")')).to.be.rejected();
- });
- it('does not prevent eval from running in executeJavaScript when there is no csp', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: { sandbox, contextIsolation }
- });
- w.loadURL('data:text/html,');
- expect(await w.webContents.executeJavaScript('eval("true")')).to.be.true();
- });
- });
- }
- });
- }
- });
- it('does not crash when multiple WebContent are created with web security disabled', () => {
- const options = { show: false, webPreferences: { webSecurity: false } };
- const w1 = new BrowserWindow(options);
- w1.loadURL(serverUrl);
- const w2 = new BrowserWindow(options);
- w2.loadURL(serverUrl);
- });
- });
- describe('command line switches', () => {
- let appProcess: ChildProcess.ChildProcessWithoutNullStreams | undefined;
- afterEach(() => {
- if (appProcess && !appProcess.killed) {
- appProcess.kill();
- appProcess = undefined;
- }
- });
- describe('--lang switch', () => {
- const currentLocale = app.getLocale();
- const currentSystemLocale = app.getSystemLocale();
- const currentPreferredLanguages = JSON.stringify(app.getPreferredSystemLanguages());
- const testLocale = async (locale: string, result: string, printEnv: boolean = false) => {
- const appPath = path.join(fixturesPath, 'api', 'locale-check');
- const args = [appPath, `--set-lang=${locale}`];
- if (printEnv) {
- args.push('--print-env');
- }
- appProcess = ChildProcess.spawn(process.execPath, args);
- let output = '';
- appProcess.stdout.on('data', (data) => { output += data; });
- let stderr = '';
- appProcess.stderr.on('data', (data) => { stderr += data; });
- const [code, signal] = await once(appProcess, 'exit');
- if (code !== 0) {
- throw new Error(`Process exited with code "${code}" signal "${signal}" output "${output}" stderr "${stderr}"`);
- }
- output = output.replace(/(\r\n|\n|\r)/gm, '');
- expect(output).to.equal(result);
- };
- it('should set the locale', async () => testLocale('fr', `fr|${currentSystemLocale}|${currentPreferredLanguages}`));
- it('should set the locale with country code', async () => testLocale('zh-CN', `zh-CN|${currentSystemLocale}|${currentPreferredLanguages}`));
- it('should not set an invalid locale', async () => testLocale('asdfkl', `${currentLocale}|${currentSystemLocale}|${currentPreferredLanguages}`));
- const lcAll = String(process.env.LC_ALL);
- ifit(process.platform === 'linux')('current process has a valid LC_ALL env', async () => {
- // The LC_ALL env should not be set to DOM locale string.
- expect(lcAll).to.not.equal(app.getLocale());
- });
- ifit(process.platform === 'linux')('should not change LC_ALL', async () => testLocale('fr', lcAll, true));
- ifit(process.platform === 'linux')('should not change LC_ALL when setting invalid locale', async () => testLocale('asdfkl', lcAll, true));
- ifit(process.platform === 'linux')('should not change LC_ALL when --lang is not set', async () => testLocale('', lcAll, true));
- });
- describe('--remote-debugging-pipe switch', () => {
- it('should expose CDP via pipe', async () => {
- const electronPath = process.execPath;
- appProcess = ChildProcess.spawn(electronPath, ['--remote-debugging-pipe'], {
- stdio: ['inherit', 'inherit', 'inherit', 'pipe', 'pipe']
- }) as ChildProcess.ChildProcessWithoutNullStreams;
- const stdio = appProcess.stdio as unknown as [NodeJS.ReadableStream, NodeJS.WritableStream, NodeJS.WritableStream, NodeJS.WritableStream, NodeJS.ReadableStream];
- const pipe = new PipeTransport(stdio[3], stdio[4]);
- const versionPromise = new Promise(resolve => { pipe.onmessage = resolve; });
- pipe.send({ id: 1, method: 'Browser.getVersion', params: {} });
- const message = (await versionPromise) as any;
- expect(message.id).to.equal(1);
- expect(message.result.product).to.contain('Chrome');
- expect(message.result.userAgent).to.contain('Electron');
- });
- it('should override --remote-debugging-port switch', async () => {
- const electronPath = process.execPath;
- appProcess = ChildProcess.spawn(electronPath, ['--remote-debugging-pipe', '--remote-debugging-port=0'], {
- stdio: ['inherit', 'inherit', 'pipe', 'pipe', 'pipe']
- }) as ChildProcess.ChildProcessWithoutNullStreams;
- let stderr = '';
- appProcess.stderr.on('data', (data: string) => { stderr += data; });
- const stdio = appProcess.stdio as unknown as [NodeJS.ReadableStream, NodeJS.WritableStream, NodeJS.WritableStream, NodeJS.WritableStream, NodeJS.ReadableStream];
- const pipe = new PipeTransport(stdio[3], stdio[4]);
- const versionPromise = new Promise(resolve => { pipe.onmessage = resolve; });
- pipe.send({ id: 1, method: 'Browser.getVersion', params: {} });
- const message = (await versionPromise) as any;
- expect(message.id).to.equal(1);
- expect(stderr).to.not.include('DevTools listening on');
- });
- it('should shut down Electron upon Browser.close CDP command', async () => {
- const electronPath = process.execPath;
- appProcess = ChildProcess.spawn(electronPath, ['--remote-debugging-pipe'], {
- stdio: ['inherit', 'inherit', 'inherit', 'pipe', 'pipe']
- }) as ChildProcess.ChildProcessWithoutNullStreams;
- const stdio = appProcess.stdio as unknown as [NodeJS.ReadableStream, NodeJS.WritableStream, NodeJS.WritableStream, NodeJS.WritableStream, NodeJS.ReadableStream];
- const pipe = new PipeTransport(stdio[3], stdio[4]);
- pipe.send({ id: 1, method: 'Browser.close', params: {} });
- await once(appProcess, 'exit');
- });
- });
- describe('--remote-debugging-port switch', () => {
- it('should display the discovery page', (done) => {
- const electronPath = process.execPath;
- let output = '';
- appProcess = ChildProcess.spawn(electronPath, ['--remote-debugging-port=']);
- appProcess.stdout.on('data', (data) => {
- console.log(data);
- });
- appProcess.stderr.on('data', (data) => {
- console.log(data);
- output += data;
- const m = /DevTools listening on ws:\/\/127.0.0.1:(\d+)\//.exec(output);
- if (m) {
- appProcess!.stderr.removeAllListeners('data');
- const port = m[1];
- http.get(`http://127.0.0.1:${port}`, (res) => {
- try {
- expect(res.statusCode).to.eql(200);
- expect(parseInt(res.headers['content-length']!)).to.be.greaterThan(0);
- done();
- } catch (e) {
- done(e);
- } finally {
- res.destroy();
- }
- });
- }
- });
- });
- });
- });
- describe('chromium features', () => {
- afterEach(closeAllWindows);
- describe('accessing key names also used as Node.js module names', () => {
- it('does not crash', (done) => {
- const w = new BrowserWindow({ show: false });
- w.webContents.once('did-finish-load', () => { done(); });
- w.webContents.once('render-process-gone', () => done(new Error('WebContents crashed.')));
- w.loadFile(path.join(fixturesPath, 'pages', 'external-string.html'));
- });
- });
- describe('first party sets', () => {
- const fps = [
- 'https://fps-member1.glitch.me',
- 'https://fps-member2.glitch.me',
- 'https://fps-member3.glitch.me'
- ];
- it('loads first party sets', async () => {
- const appPath = path.join(fixturesPath, 'api', 'first-party-sets', 'base');
- const fpsProcess = ChildProcess.spawn(process.execPath, [appPath]);
- let output = '';
- fpsProcess.stdout.on('data', data => { output += data; });
- await once(fpsProcess, 'exit');
- expect(output).to.include(fps.join(','));
- });
- it('loads sets from the command line', async () => {
- const appPath = path.join(fixturesPath, 'api', 'first-party-sets', 'command-line');
- const args = [appPath, `--use-first-party-set=${fps}`];
- const fpsProcess = ChildProcess.spawn(process.execPath, args);
- let output = '';
- fpsProcess.stdout.on('data', data => { output += data; });
- await once(fpsProcess, 'exit');
- expect(output).to.include(fps.join(','));
- });
- });
- describe('loading jquery', () => {
- it('does not crash', (done) => {
- const w = new BrowserWindow({ show: false });
- w.webContents.once('did-finish-load', () => { done(); });
- w.webContents.once('render-process-gone', () => done(new Error('WebContents crashed.')));
- w.loadFile(path.join(__dirname, 'fixtures', 'pages', 'jquery.html'));
- });
- });
- describe('navigator.languages', () => {
- it('should return the system locale only', async () => {
- const appLocale = app.getLocale();
- const w = new BrowserWindow({ show: false });
- await w.loadURL('about:blank');
- const languages = await w.webContents.executeJavaScript('navigator.languages');
- expect(languages.length).to.be.greaterThan(0);
- expect(languages).to.contain(appLocale);
- });
- });
- describe('navigator.serviceWorker', () => {
- it('should register for file scheme', (done) => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- partition: 'sw-file-scheme-spec',
- contextIsolation: false
- }
- });
- w.webContents.on('ipc-message', (event, channel, message) => {
- if (channel === 'reload') {
- w.webContents.reload();
- } else if (channel === 'error') {
- done(message);
- } else if (channel === 'response') {
- expect(message).to.equal('Hello from serviceWorker!');
- session.fromPartition('sw-file-scheme-spec').clearStorageData({
- storages: ['serviceworkers']
- }).then(() => done());
- }
- });
- w.webContents.on('render-process-gone', () => done(new Error('WebContents crashed.')));
- w.loadFile(path.join(fixturesPath, 'pages', 'service-worker', 'index.html'));
- });
- it('should register for intercepted file scheme', (done) => {
- const customSession = session.fromPartition('intercept-file');
- customSession.protocol.interceptBufferProtocol('file', (request, callback) => {
- let file = url.parse(request.url).pathname!;
- if (file[0] === '/' && process.platform === 'win32') file = file.slice(1);
- const content = fs.readFileSync(path.normalize(file));
- const ext = path.extname(file);
- let type = 'text/html';
- if (ext === '.js') type = 'application/javascript';
- callback({ data: content, mimeType: type } as any);
- });
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- session: customSession,
- contextIsolation: false
- }
- });
- w.webContents.on('ipc-message', (event, channel, message) => {
- if (channel === 'reload') {
- w.webContents.reload();
- } else if (channel === 'error') {
- done(`unexpected error : ${message}`);
- } else if (channel === 'response') {
- expect(message).to.equal('Hello from serviceWorker!');
- customSession.clearStorageData({
- storages: ['serviceworkers']
- }).then(() => {
- customSession.protocol.uninterceptProtocol('file');
- done();
- });
- }
- });
- w.webContents.on('render-process-gone', () => done(new Error('WebContents crashed.')));
- w.loadFile(path.join(fixturesPath, 'pages', 'service-worker', 'index.html'));
- });
- it('should register for custom scheme', (done) => {
- const customSession = session.fromPartition('custom-scheme');
- customSession.protocol.registerFileProtocol(serviceWorkerScheme, (request, callback) => {
- let file = url.parse(request.url).pathname!;
- if (file[0] === '/' && process.platform === 'win32') file = file.slice(1);
- callback({ path: path.normalize(file) } as any);
- });
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- session: customSession,
- contextIsolation: false
- }
- });
- w.webContents.on('ipc-message', (event, channel, message) => {
- if (channel === 'reload') {
- w.webContents.reload();
- } else if (channel === 'error') {
- done(`unexpected error : ${message}`);
- } else if (channel === 'response') {
- expect(message).to.equal('Hello from serviceWorker!');
- customSession.clearStorageData({
- storages: ['serviceworkers']
- }).then(() => {
- customSession.protocol.uninterceptProtocol(serviceWorkerScheme);
- done();
- });
- }
- });
- w.webContents.on('render-process-gone', () => done(new Error('WebContents crashed.')));
- w.loadFile(path.join(fixturesPath, 'pages', 'service-worker', 'custom-scheme-index.html'));
- });
- it('should not allow nodeIntegrationInWorker', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- nodeIntegrationInWorker: true,
- partition: 'sw-file-scheme-worker-spec',
- contextIsolation: false
- }
- });
- await w.loadURL(`file://${fixturesPath}/pages/service-worker/empty.html`);
- const data = await w.webContents.executeJavaScript(`
- navigator.serviceWorker.register('worker-no-node.js', {
- scope: './'
- }).then(() => navigator.serviceWorker.ready)
- new Promise((resolve) => {
- navigator.serviceWorker.onmessage = event => resolve(event.data);
- });
- `);
- expect(data).to.equal('undefined undefined undefined undefined');
- });
- });
- describe('navigator.geolocation', () => {
- ifit(features.isFakeLocationProviderEnabled())('returns error when permission is denied', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- partition: 'geolocation-spec',
- contextIsolation: false
- }
- });
- const message = once(w.webContents, 'ipc-message');
- w.webContents.session.setPermissionRequestHandler((wc, permission, callback) => {
- if (permission === 'geolocation') {
- callback(false);
- } else {
- callback(true);
- }
- });
- w.loadFile(path.join(fixturesPath, 'pages', 'geolocation', 'index.html'));
- const [, channel] = await message;
- expect(channel).to.equal('success', 'unexpected response from geolocation api');
- });
- ifit(!features.isFakeLocationProviderEnabled())('returns position when permission is granted', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- partition: 'geolocation-spec'
- }
- });
- w.webContents.session.setPermissionRequestHandler((_wc, _permission, callback) => {
- callback(true);
- });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const position = await w.webContents.executeJavaScript(`new Promise((resolve, reject) =>
- navigator.geolocation.getCurrentPosition(
- x => resolve({coords: x.coords, timestamp: x.timestamp}),
- err => reject(new Error(err.message))))`);
- expect(position).to.have.property('coords');
- expect(position).to.have.property('timestamp');
- });
- });
- describe('web workers', () => {
- let appProcess: ChildProcess.ChildProcessWithoutNullStreams | undefined;
- afterEach(() => {
- if (appProcess && !appProcess.killed) {
- appProcess.kill();
- appProcess = undefined;
- }
- });
- it('Worker with nodeIntegrationInWorker has access to self.module.paths', async () => {
- const appPath = path.join(__dirname, 'fixtures', 'apps', 'self-module-paths');
- appProcess = ChildProcess.spawn(process.execPath, [appPath]);
- const [code] = await once(appProcess, 'exit');
- expect(code).to.equal(0);
- });
- it('Worker can work', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const data = await w.webContents.executeJavaScript(`
- const worker = new Worker('../workers/worker.js');
- const message = 'ping';
- const eventPromise = new Promise((resolve) => { worker.onmessage = resolve; });
- worker.postMessage(message);
- eventPromise.then(t => t.data)
- `);
- expect(data).to.equal('ping');
- });
- it('Worker has no node integration by default', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const data = await w.webContents.executeJavaScript(`
- const worker = new Worker('../workers/worker_node.js');
- new Promise((resolve) => { worker.onmessage = e => resolve(e.data); })
- `);
- expect(data).to.equal('undefined undefined undefined undefined');
- });
- it('Worker has node integration with nodeIntegrationInWorker', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, nodeIntegrationInWorker: true, contextIsolation: false } });
- w.loadURL(`file://${fixturesPath}/pages/worker.html`);
- const [, data] = await once(ipcMain, 'worker-result');
- expect(data).to.equal('object function object function');
- });
- describe('SharedWorker', () => {
- it('can work', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const data = await w.webContents.executeJavaScript(`
- const worker = new SharedWorker('../workers/shared_worker.js');
- const message = 'ping';
- const eventPromise = new Promise((resolve) => { worker.port.onmessage = e => resolve(e.data); });
- worker.port.postMessage(message);
- eventPromise
- `);
- expect(data).to.equal('ping');
- });
- it('has no node integration by default', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const data = await w.webContents.executeJavaScript(`
- const worker = new SharedWorker('../workers/shared_worker_node.js');
- new Promise((resolve) => { worker.port.onmessage = e => resolve(e.data); })
- `);
- expect(data).to.equal('undefined undefined undefined undefined');
- });
- it('does not have node integration with nodeIntegrationInWorker', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- nodeIntegrationInWorker: true,
- contextIsolation: false
- }
- });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const data = await w.webContents.executeJavaScript(`
- const worker = new SharedWorker('../workers/shared_worker_node.js');
- new Promise((resolve) => { worker.port.onmessage = e => resolve(e.data); })
- `);
- expect(data).to.equal('undefined undefined undefined undefined');
- });
- });
- });
- describe('form submit', () => {
- let server: http.Server;
- let serverUrl: string;
- before(async () => {
- server = http.createServer((req, res) => {
- let body = '';
- req.on('data', (chunk) => {
- body += chunk;
- });
- res.setHeader('Content-Type', 'application/json');
- req.on('end', () => {
- res.end(`body:${body}`);
- });
- });
- serverUrl = (await listen(server)).url;
- });
- after(async () => {
- server.close();
- await closeAllWindows();
- });
- for (const isSandboxEnabled of [true, false]) {
- describe(`sandbox=${isSandboxEnabled}`, () => {
- it('posts data in the same window', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- sandbox: isSandboxEnabled
- }
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'form-with-data.html'));
- const loadPromise = once(w.webContents, 'did-finish-load');
- w.webContents.executeJavaScript(`
- const form = document.querySelector('form')
- form.action = '${serverUrl}';
- form.submit();
- `);
- await loadPromise;
- const res = await w.webContents.executeJavaScript('document.body.innerText');
- expect(res).to.equal('body:greeting=hello');
- });
- it('posts data to a new window with target=_blank', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- sandbox: isSandboxEnabled
- }
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'form-with-data.html'));
- const windowCreatedPromise = once(app, 'browser-window-created') as Promise<[any, BrowserWindow]>;
- w.webContents.executeJavaScript(`
- const form = document.querySelector('form')
- form.action = '${serverUrl}';
- form.target = '_blank';
- form.submit();
- `);
- const [, newWin] = await windowCreatedPromise;
- const res = await newWin.webContents.executeJavaScript('document.body.innerText');
- expect(res).to.equal('body:greeting=hello');
- });
- });
- }
- });
- describe('window.open', () => {
- for (const show of [true, false]) {
- it(`shows the child regardless of parent visibility when parent {show=${show}}`, async () => {
- const w = new BrowserWindow({ show });
- // toggle visibility
- if (show) {
- w.hide();
- } else {
- w.show();
- }
- defer(() => { w.close(); });
- const promise = once(app, 'browser-window-created') as Promise<[any, BrowserWindow]>;
- w.loadFile(path.join(fixturesPath, 'pages', 'window-open.html'));
- const [, newWindow] = await promise;
- expect(newWindow.isVisible()).to.equal(true);
- });
- }
- // FIXME(zcbenz): This test is making the spec runner hang on exit on Windows.
- ifit(process.platform !== 'win32')('disables node integration when it is disabled on the parent window', async () => {
- const windowUrl = url.pathToFileURL(path.join(fixturesPath, 'pages', 'window-opener-no-node-integration.html'));
- windowUrl.searchParams.set('p', `${fixturesPath}/pages/window-opener-node.html`);
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const { eventData } = await w.webContents.executeJavaScript(`(async () => {
- const message = new Promise(resolve => window.addEventListener('message', resolve, {once: true}));
- const b = window.open(${JSON.stringify(windowUrl)}, '', 'show=false')
- const e = await message
- b.close();
- return {
- eventData: e.data
- }
- })()`);
- expect(eventData.isProcessGlobalUndefined).to.be.true();
- });
- it('disables node integration when it is disabled on the parent window for chrome devtools URLs', async () => {
- // NB. webSecurity is disabled because native window.open() is not
- // allowed to load devtools:// URLs.
- const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, webSecurity: false } });
- w.loadURL('about:blank');
- w.webContents.executeJavaScript(`
- { b = window.open('devtools://devtools/bundled/inspector.html', '', 'nodeIntegration=no,show=no'); null }
- `);
- const [, contents] = await once(app, 'web-contents-created') as [any, WebContents];
- const typeofProcessGlobal = await contents.executeJavaScript('typeof process');
- expect(typeofProcessGlobal).to.equal('undefined');
- });
- it('can disable node integration when it is enabled on the parent window', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true } });
- w.loadURL('about:blank');
- w.webContents.executeJavaScript(`
- { b = window.open('about:blank', '', 'nodeIntegration=no,show=no'); null }
- `);
- const [, contents] = await once(app, 'web-contents-created') as [any, WebContents];
- const typeofProcessGlobal = await contents.executeJavaScript('typeof process');
- expect(typeofProcessGlobal).to.equal('undefined');
- });
- // TODO(jkleinsc) fix this flaky test on WOA
- ifit(process.platform !== 'win32' || process.arch !== 'arm64')('disables JavaScript when it is disabled on the parent window', async () => {
- const w = new BrowserWindow({ show: true, webPreferences: { nodeIntegration: true } });
- w.webContents.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const windowUrl = require('node:url').format({
- pathname: `${fixturesPath}/pages/window-no-javascript.html`,
- protocol: 'file',
- slashes: true
- });
- w.webContents.executeJavaScript(`
- { b = window.open(${JSON.stringify(windowUrl)}, '', 'javascript=no,show=no'); null }
- `);
- const [, contents] = await once(app, 'web-contents-created') as [any, WebContents];
- await once(contents, 'did-finish-load');
- // Click link on page
- contents.sendInputEvent({ type: 'mouseDown', clickCount: 1, x: 1, y: 1 });
- contents.sendInputEvent({ type: 'mouseUp', clickCount: 1, x: 1, y: 1 });
- const [, window] = await once(app, 'browser-window-created') as [any, BrowserWindow];
- const preferences = window.webContents.getLastWebPreferences();
- expect(preferences!.javascript).to.be.false();
- });
- it('defines a window.location getter', async () => {
- let targetURL: string;
- if (process.platform === 'win32') {
- targetURL = `file:///${fixturesPath.replace(/\\/g, '/')}/pages/base-page.html`;
- } else {
- targetURL = `file://${fixturesPath}/pages/base-page.html`;
- }
- const w = new BrowserWindow({ show: false });
- w.webContents.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- w.webContents.executeJavaScript(`{ b = window.open(${JSON.stringify(targetURL)}); null }`);
- const [, window] = await once(app, 'browser-window-created') as [any, BrowserWindow];
- await once(window.webContents, 'did-finish-load');
- expect(await w.webContents.executeJavaScript('b.location.href')).to.equal(targetURL);
- });
- it('defines a window.location setter', async () => {
- const w = new BrowserWindow({ show: false });
- w.webContents.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- w.webContents.executeJavaScript('{ b = window.open("about:blank"); null }');
- const [, { webContents }] = await once(app, 'browser-window-created') as [any, BrowserWindow];
- await once(webContents, 'did-finish-load');
- // When it loads, redirect
- w.webContents.executeJavaScript(`{ b.location = ${JSON.stringify(`file://${fixturesPath}/pages/base-page.html`)}; null }`);
- await once(webContents, 'did-finish-load');
- });
- it('defines a window.location.href setter', async () => {
- const w = new BrowserWindow({ show: false });
- w.webContents.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- w.webContents.executeJavaScript('{ b = window.open("about:blank"); null }');
- const [, { webContents }] = await once(app, 'browser-window-created') as [any, BrowserWindow];
- await once(webContents, 'did-finish-load');
- // When it loads, redirect
- w.webContents.executeJavaScript(`{ b.location.href = ${JSON.stringify(`file://${fixturesPath}/pages/base-page.html`)}; null }`);
- await once(webContents, 'did-finish-load');
- });
- it('open a blank page when no URL is specified', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL('about:blank');
- w.webContents.executeJavaScript('{ b = window.open(); null }');
- const [, { webContents }] = await once(app, 'browser-window-created') as [any, BrowserWindow];
- await once(webContents, 'did-finish-load');
- expect(await w.webContents.executeJavaScript('b.location.href')).to.equal('about:blank');
- });
- it('open a blank page when an empty URL is specified', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL('about:blank');
- w.webContents.executeJavaScript('{ b = window.open(\'\'); null }');
- const [, { webContents }] = await once(app, 'browser-window-created') as [any, BrowserWindow];
- await once(webContents, 'did-finish-load');
- expect(await w.webContents.executeJavaScript('b.location.href')).to.equal('about:blank');
- });
- it('does not throw an exception when the frameName is a built-in object property', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL('about:blank');
- w.webContents.executeJavaScript('{ b = window.open(\'\', \'__proto__\'); null }');
- const frameName = await new Promise((resolve) => {
- w.webContents.setWindowOpenHandler(details => {
- setImmediate(() => resolve(details.frameName));
- return { action: 'allow' };
- });
- });
- expect(frameName).to.equal('__proto__');
- });
- it('works when used in conjunction with the vm module', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- contextIsolation: false
- }
- });
- await w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const { contextObject } = await w.webContents.executeJavaScript(`(async () => {
- const vm = require('node:vm');
- const contextObject = { count: 1, type: 'gecko' };
- window.open('');
- vm.runInNewContext('count += 1; type = "chameleon";', contextObject);
- return { contextObject };
- })()`);
- expect(contextObject).to.deep.equal({ count: 2, type: 'chameleon' });
- });
- // FIXME(nornagon): I'm not sure this ... ever was correct?
- xit('inherit options of parent window', async () => {
- const w = new BrowserWindow({ show: false, width: 123, height: 456 });
- w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const url = `file://${fixturesPath}/pages/window-open-size.html`;
- const { width, height, eventData } = await w.webContents.executeJavaScript(`(async () => {
- const message = new Promise(resolve => window.addEventListener('message', resolve, {once: true}));
- const b = window.open(${JSON.stringify(url)}, '', 'show=false')
- const e = await message
- b.close();
- const width = outerWidth;
- const height = outerHeight;
- return {
- width,
- height,
- eventData: e.data
- }
- })()`);
- expect(eventData).to.equal(`size: ${width} ${height}`);
- expect(eventData).to.equal('size: 123 456');
- });
- it('does not override child options', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const windowUrl = `file://${fixturesPath}/pages/window-open-size.html`;
- const { eventData } = await w.webContents.executeJavaScript(`(async () => {
- const message = new Promise(resolve => window.addEventListener('message', resolve, {once: true}));
- const b = window.open(${JSON.stringify(windowUrl)}, '', 'show=no,width=350,height=450')
- const e = await message
- b.close();
- return { eventData: e.data }
- })()`);
- expect(eventData).to.equal('size: 350 450');
- });
- it('loads preload script after setting opener to null', async () => {
- const w = new BrowserWindow({ show: false });
- w.webContents.setWindowOpenHandler(() => ({
- action: 'allow',
- overrideBrowserWindowOptions: {
- webPreferences: {
- preload: path.join(fixturesPath, 'module', 'preload.js')
- }
- }
- }));
- w.loadURL('about:blank');
- w.webContents.executeJavaScript('window.child = window.open(); child.opener = null');
- const [, { webContents }] = await once(app, 'browser-window-created');
- const [,, message] = await once(webContents, 'console-message');
- expect(message).to.equal('{"require":"function","module":"object","exports":"object","process":"object","Buffer":"function"}');
- });
- it('disables the <webview> tag when it is disabled on the parent window', async () => {
- const windowUrl = url.pathToFileURL(path.join(fixturesPath, 'pages', 'window-opener-no-webview-tag.html'));
- windowUrl.searchParams.set('p', `${fixturesPath}/pages/window-opener-webview.html`);
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const { eventData } = await w.webContents.executeJavaScript(`(async () => {
- const message = new Promise(resolve => window.addEventListener('message', resolve, {once: true}));
- const b = window.open(${JSON.stringify(windowUrl)}, '', 'webviewTag=no,contextIsolation=no,nodeIntegration=yes,show=no')
- const e = await message
- b.close();
- return { eventData: e.data }
- })()`);
- expect(eventData.isWebViewGlobalUndefined).to.be.true();
- });
- it('throws an exception when the arguments cannot be converted to strings', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL('about:blank');
- await expect(
- w.webContents.executeJavaScript('window.open(\'\', { toString: null })')
- ).to.eventually.be.rejected();
- await expect(
- w.webContents.executeJavaScript('window.open(\'\', \'\', { toString: 3 })')
- ).to.eventually.be.rejected();
- });
- it('does not throw an exception when the features include webPreferences', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL('about:blank');
- await expect(
- w.webContents.executeJavaScript('window.open(\'\', \'\', \'show=no,webPreferences=\'); null')
- ).to.eventually.be.fulfilled();
- });
- });
- describe('window.opener', () => {
- it('is null for main window', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- contextIsolation: false
- }
- });
- w.loadFile(path.join(fixturesPath, 'pages', 'window-opener.html'));
- const [, channel, opener] = await once(w.webContents, 'ipc-message');
- expect(channel).to.equal('opener');
- expect(opener).to.equal(null);
- });
- it('is not null for window opened by window.open', async () => {
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- contextIsolation: false
- }
- });
- w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const windowUrl = `file://${fixturesPath}/pages/window-opener.html`;
- const eventData = await w.webContents.executeJavaScript(`
- const b = window.open(${JSON.stringify(windowUrl)}, '', 'show=no');
- new Promise(resolve => window.addEventListener('message', resolve, {once: true})).then(e => e.data);
- `);
- expect(eventData).to.equal('object');
- });
- });
- describe('window.opener.postMessage', () => {
- it('sets source and origin correctly', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const windowUrl = `file://${fixturesPath}/pages/window-opener-postMessage.html`;
- const { sourceIsChild, origin } = await w.webContents.executeJavaScript(`
- const b = window.open(${JSON.stringify(windowUrl)}, '', 'show=no');
- new Promise(resolve => window.addEventListener('message', resolve, {once: true})).then(e => ({
- sourceIsChild: e.source === b,
- origin: e.origin
- }));
- `);
- expect(sourceIsChild).to.be.true();
- expect(origin).to.equal('file://');
- });
- it('supports windows opened from a <webview>', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { webviewTag: true } });
- w.loadURL('about:blank');
- const childWindowUrl = url.pathToFileURL(path.join(fixturesPath, 'pages', 'webview-opener-postMessage.html'));
- childWindowUrl.searchParams.set('p', `${fixturesPath}/pages/window-opener-postMessage.html`);
- const message = await w.webContents.executeJavaScript(`
- const webview = new WebView();
- webview.allowpopups = true;
- webview.setAttribute('webpreferences', 'contextIsolation=no');
- webview.src = ${JSON.stringify(childWindowUrl)}
- const consoleMessage = new Promise(resolve => webview.addEventListener('console-message', resolve, {once: true}));
- document.body.appendChild(webview);
- consoleMessage.then(e => e.message)
- `);
- expect(message).to.equal('message');
- });
- describe('targetOrigin argument', () => {
- let serverURL: string;
- let server: any;
- beforeEach(async () => {
- server = http.createServer((req, res) => {
- res.writeHead(200);
- const filePath = path.join(fixturesPath, 'pages', 'window-opener-targetOrigin.html');
- res.end(fs.readFileSync(filePath, 'utf8'));
- });
- serverURL = (await listen(server)).url;
- });
- afterEach(() => {
- server.close();
- });
- it('delivers messages that match the origin', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
- w.loadFile(path.resolve(__dirname, 'fixtures', 'blank.html'));
- const data = await w.webContents.executeJavaScript(`
- window.open(${JSON.stringify(serverURL)}, '', 'show=no,contextIsolation=no,nodeIntegration=yes');
- new Promise(resolve => window.addEventListener('message', resolve, {once: true})).then(e => e.data)
- `);
- expect(data).to.equal('deliver');
- });
- });
- });
- describe('IdleDetection', () => {
- afterEach(closeAllWindows);
- afterEach(() => {
- session.defaultSession.setPermissionCheckHandler(null);
- session.defaultSession.setPermissionRequestHandler(null);
- });
- it('can grant a permission request', async () => {
- session.defaultSession.setPermissionRequestHandler(
- (_wc, permission, callback) => {
- callback(permission === 'idle-detection');
- }
- );
- const w = new BrowserWindow({ show: false });
- await w.loadFile(path.join(fixturesPath, 'pages', 'button.html'));
- const permission = await w.webContents.executeJavaScript(`
- new Promise((resolve, reject) => {
- const button = document.getElementById('button');
- button.addEventListener("click", async () => {
- const permission = await IdleDetector.requestPermission();
- resolve(permission);
- });
- button.click();
- });
- `, true);
- expect(permission).to.eq('granted');
- });
- it('can deny a permission request', async () => {
- session.defaultSession.setPermissionRequestHandler(
- (_wc, permission, callback) => {
- callback(permission !== 'idle-detection');
- }
- );
- const w = new BrowserWindow({ show: false });
- await w.loadFile(path.join(fixturesPath, 'pages', 'button.html'));
- const permission = await w.webContents.executeJavaScript(`
- new Promise((resolve, reject) => {
- const button = document.getElementById('button');
- button.addEventListener("click", async () => {
- const permission = await IdleDetector.requestPermission();
- resolve(permission);
- });
- button.click();
- });
- `, true);
- expect(permission).to.eq('denied');
- });
- it('can allow the IdleDetector to start', async () => {
- session.defaultSession.setPermissionCheckHandler((wc, permission) => {
- return permission === 'idle-detection';
- });
- const w = new BrowserWindow({ show: false });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const result = await w.webContents.executeJavaScript(`
- const detector = new IdleDetector({ threshold: 60000 });
- detector.start().then(() => {
- return 'success';
- }).catch(e => e.message);
- `, true);
- expect(result).to.eq('success');
- });
- it('can prevent the IdleDetector from starting', async () => {
- session.defaultSession.setPermissionCheckHandler((wc, permission) => {
- return permission !== 'idle-detection';
- });
- const w = new BrowserWindow({ show: false });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const result = await w.webContents.executeJavaScript(`
- const detector = new IdleDetector({ threshold: 60000 });
- detector.start().then(() => {
- console.log('success')
- }).catch(e => e.message);
- `, true);
- expect(result).to.eq('Idle detection permission denied');
- });
- });
- describe('navigator.mediaDevices', () => {
- afterEach(closeAllWindows);
- afterEach(() => {
- session.defaultSession.setPermissionCheckHandler(null);
- session.defaultSession.setPermissionRequestHandler(null);
- });
- it('can return labels of enumerated devices', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const labels = await w.webContents.executeJavaScript('navigator.mediaDevices.enumerateDevices().then(ds => ds.map(d => d.label))');
- expect(labels.some((l: any) => l)).to.be.true();
- });
- it('does not return labels of enumerated devices when permission denied', async () => {
- session.defaultSession.setPermissionCheckHandler(() => false);
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const labels = await w.webContents.executeJavaScript('navigator.mediaDevices.enumerateDevices().then(ds => ds.map(d => d.label))');
- expect(labels.some((l: any) => l)).to.be.false();
- });
- it('returns the same device ids across reloads', async () => {
- const ses = session.fromPartition('persist:media-device-id');
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- session: ses,
- contextIsolation: false
- }
- });
- w.loadFile(path.join(fixturesPath, 'pages', 'media-id-reset.html'));
- const [, firstDeviceIds] = await once(ipcMain, 'deviceIds');
- w.webContents.reload();
- const [, secondDeviceIds] = await once(ipcMain, 'deviceIds');
- expect(firstDeviceIds).to.deep.equal(secondDeviceIds);
- });
- it('can return new device id when cookie storage is cleared', async () => {
- const ses = session.fromPartition('persist:media-device-id');
- const w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- session: ses,
- contextIsolation: false
- }
- });
- w.loadFile(path.join(fixturesPath, 'pages', 'media-id-reset.html'));
- const [, firstDeviceIds] = await once(ipcMain, 'deviceIds');
- await ses.clearStorageData({ storages: ['cookies'] });
- w.webContents.reload();
- const [, secondDeviceIds] = await once(ipcMain, 'deviceIds');
- expect(firstDeviceIds).to.not.deep.equal(secondDeviceIds);
- });
- it('provides a securityOrigin to the request handler', async () => {
- session.defaultSession.setPermissionRequestHandler(
- (wc, permission, callback, details) => {
- if (details.securityOrigin !== undefined) {
- callback(true);
- } else {
- callback(false);
- }
- }
- );
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const labels = await w.webContents.executeJavaScript(`navigator.mediaDevices.getUserMedia({
- video: {
- mandatory: {
- chromeMediaSource: "desktop",
- minWidth: 1280,
- maxWidth: 1280,
- minHeight: 720,
- maxHeight: 720
- }
- }
- }).then((stream) => stream.getVideoTracks())`);
- expect(labels.some((l: any) => l)).to.be.true();
- });
- it('fails with "not supported" for getDisplayMedia', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const { ok, err } = await w.webContents.executeJavaScript('navigator.mediaDevices.getDisplayMedia({video: true}).then(s => ({ok: true}), e => ({ok: false, err: e.message}))', true);
- expect(ok).to.be.false();
- expect(err).to.equal('Not supported');
- });
- });
- describe('window.opener access', () => {
- const scheme = 'app';
- const fileUrl = `file://${fixturesPath}/pages/window-opener-location.html`;
- const httpUrl1 = `${scheme}://origin1`;
- const httpUrl2 = `${scheme}://origin2`;
- const fileBlank = `file://${fixturesPath}/pages/blank.html`;
- const httpBlank = `${scheme}://origin1/blank`;
- const table = [
- { parent: fileBlank, child: httpUrl1, nodeIntegration: false, openerAccessible: false },
- { parent: fileBlank, child: httpUrl1, nodeIntegration: true, openerAccessible: false },
- // {parent: httpBlank, child: fileUrl, nodeIntegration: false, openerAccessible: false}, // can't window.open()
- // {parent: httpBlank, child: fileUrl, nodeIntegration: true, openerAccessible: false}, // can't window.open()
- // NB. this is different from Chrome's behavior, which isolates file: urls from each other
- { parent: fileBlank, child: fileUrl, nodeIntegration: false, openerAccessible: true },
- { parent: fileBlank, child: fileUrl, nodeIntegration: true, openerAccessible: true },
- { parent: httpBlank, child: httpUrl1, nodeIntegration: false, openerAccessible: true },
- { parent: httpBlank, child: httpUrl1, nodeIntegration: true, openerAccessible: true },
- { parent: httpBlank, child: httpUrl2, nodeIntegration: false, openerAccessible: false },
- { parent: httpBlank, child: httpUrl2, nodeIntegration: true, openerAccessible: false }
- ];
- const s = (url: string) => url.startsWith('file') ? 'file://...' : url;
- before(() => {
- protocol.registerFileProtocol(scheme, (request, callback) => {
- if (request.url.includes('blank')) {
- callback(`${fixturesPath}/pages/blank.html`);
- } else {
- callback(`${fixturesPath}/pages/window-opener-location.html`);
- }
- });
- });
- after(() => {
- protocol.unregisterProtocol(scheme);
- });
- afterEach(closeAllWindows);
- describe('when opened from main window', () => {
- for (const { parent, child, nodeIntegration, openerAccessible } of table) {
- for (const sandboxPopup of [false, true]) {
- const description = `when parent=${s(parent)} opens child=${s(child)} with nodeIntegration=${nodeIntegration} sandboxPopup=${sandboxPopup}, child should ${openerAccessible ? '' : 'not '}be able to access opener`;
- it(description, async () => {
- const w = new BrowserWindow({ show: true, webPreferences: { nodeIntegration: true, contextIsolation: false } });
- w.webContents.setWindowOpenHandler(() => ({
- action: 'allow',
- overrideBrowserWindowOptions: {
- webPreferences: {
- sandbox: sandboxPopup
- }
- }
- }));
- await w.loadURL(parent);
- const childOpenerLocation = await w.webContents.executeJavaScript(`new Promise(resolve => {
- window.addEventListener('message', function f(e) {
- resolve(e.data)
- })
- window.open(${JSON.stringify(child)}, "", "show=no,nodeIntegration=${nodeIntegration ? 'yes' : 'no'}")
- })`);
- if (openerAccessible) {
- expect(childOpenerLocation).to.be.a('string');
- } else {
- expect(childOpenerLocation).to.be.null();
- }
- });
- }
- }
- });
- describe('when opened from <webview>', () => {
- for (const { parent, child, nodeIntegration, openerAccessible } of table) {
- const description = `when parent=${s(parent)} opens child=${s(child)} with nodeIntegration=${nodeIntegration}, child should ${openerAccessible ? '' : 'not '}be able to access opener`;
- it(description, async () => {
- // This test involves three contexts:
- // 1. The root BrowserWindow in which the test is run,
- // 2. A <webview> belonging to the root window,
- // 3. A window opened by calling window.open() from within the <webview>.
- // We are testing whether context (3) can access context (2) under various conditions.
- // This is context (1), the base window for the test.
- const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, webviewTag: true, contextIsolation: false } });
- await w.loadURL('about:blank');
- const parentCode = `new Promise((resolve) => {
- // This is context (3), a child window of the WebView.
- const child = window.open(${JSON.stringify(child)}, "", "show=no,contextIsolation=no,nodeIntegration=yes")
- window.addEventListener("message", e => {
- resolve(e.data)
- })
- })`;
- const childOpenerLocation = await w.webContents.executeJavaScript(`new Promise((resolve, reject) => {
- // This is context (2), a WebView which will call window.open()
- const webview = new WebView()
- webview.setAttribute('nodeintegration', '${nodeIntegration ? 'on' : 'off'}')
- webview.setAttribute('webpreferences', 'contextIsolation=no')
- webview.setAttribute('allowpopups', 'on')
- webview.src = ${JSON.stringify(parent + '?p=' + encodeURIComponent(child))}
- webview.addEventListener('dom-ready', async () => {
- webview.executeJavaScript(${JSON.stringify(parentCode)}).then(resolve, reject)
- })
- document.body.appendChild(webview)
- })`);
- if (openerAccessible) {
- expect(childOpenerLocation).to.be.a('string');
- } else {
- expect(childOpenerLocation).to.be.null();
- }
- });
- }
- });
- });
- describe('storage', () => {
- describe('custom non standard schemes', () => {
- const protocolName = 'storage';
- let contents: WebContents;
- before(() => {
- protocol.registerFileProtocol(protocolName, (request, callback) => {
- const parsedUrl = url.parse(request.url);
- let filename;
- switch (parsedUrl.pathname) {
- case '/localStorage' : filename = 'local_storage.html'; break;
- case '/sessionStorage' : filename = 'session_storage.html'; break;
- case '/WebSQL' : filename = 'web_sql.html'; break;
- case '/indexedDB' : filename = 'indexed_db.html'; break;
- case '/cookie' : filename = 'cookie.html'; break;
- default : filename = '';
- }
- callback({ path: `${fixturesPath}/pages/storage/${filename}` });
- });
- });
- after(() => {
- protocol.unregisterProtocol(protocolName);
- });
- beforeEach(() => {
- contents = (webContents as typeof ElectronInternal.WebContents).create({
- nodeIntegration: true,
- contextIsolation: false
- });
- });
- afterEach(() => {
- contents.destroy();
- contents = null as any;
- });
- it('cannot access localStorage', async () => {
- const response = once(ipcMain, 'local-storage-response');
- contents.loadURL(protocolName + '://host/localStorage');
- const [, error] = await response;
- expect(error).to.equal('Failed to read the \'localStorage\' property from \'Window\': Access is denied for this document.');
- });
- it('cannot access sessionStorage', async () => {
- const response = once(ipcMain, 'session-storage-response');
- contents.loadURL(`${protocolName}://host/sessionStorage`);
- const [, error] = await response;
- expect(error).to.equal('Failed to read the \'sessionStorage\' property from \'Window\': Access is denied for this document.');
- });
- it('cannot access WebSQL database', async () => {
- const response = once(ipcMain, 'web-sql-response');
- contents.loadURL(`${protocolName}://host/WebSQL`);
- const [, error] = await response;
- expect(error).to.equal('Failed to execute \'openDatabase\' on \'Window\': Access to the WebDatabase API is denied in this context.');
- });
- it('cannot access indexedDB', async () => {
- const response = once(ipcMain, 'indexed-db-response');
- contents.loadURL(`${protocolName}://host/indexedDB`);
- const [, error] = await response;
- expect(error).to.equal('Failed to execute \'open\' on \'IDBFactory\': access to the Indexed Database API is denied in this context.');
- });
- it('cannot access cookie', async () => {
- const response = once(ipcMain, 'cookie-response');
- contents.loadURL(`${protocolName}://host/cookie`);
- const [, error] = await response;
- expect(error).to.equal('Failed to set the \'cookie\' property on \'Document\': Access is denied for this document.');
- });
- });
- describe('can be accessed', () => {
- let server: http.Server;
- let serverUrl: string;
- let serverCrossSiteUrl: string;
- before(async () => {
- server = http.createServer((req, res) => {
- const respond = () => {
- if (req.url === '/redirect-cross-site') {
- res.setHeader('Location', `${serverCrossSiteUrl}/redirected`);
- res.statusCode = 302;
- res.end();
- } else if (req.url === '/redirected') {
- res.end('<html><script>window.localStorage</script></html>');
- } else {
- res.end();
- }
- };
- setTimeout().then(respond);
- });
- serverUrl = (await listen(server)).url;
- serverCrossSiteUrl = serverUrl.replace('127.0.0.1', 'localhost');
- });
- after(() => {
- server.close();
- server = null as any;
- });
- afterEach(closeAllWindows);
- const testLocalStorageAfterXSiteRedirect = (testTitle: string, extraPreferences = {}) => {
- it(testTitle, async () => {
- const w = new BrowserWindow({
- show: false,
- ...extraPreferences
- });
- let redirected = false;
- w.webContents.on('render-process-gone', () => {
- expect.fail('renderer crashed / was killed');
- });
- w.webContents.on('did-redirect-navigation', (event, url) => {
- expect(url).to.equal(`${serverCrossSiteUrl}/redirected`);
- redirected = true;
- });
- await w.loadURL(`${serverUrl}/redirect-cross-site`);
- expect(redirected).to.be.true('didnt redirect');
- });
- };
- testLocalStorageAfterXSiteRedirect('after a cross-site redirect');
- testLocalStorageAfterXSiteRedirect('after a cross-site redirect in sandbox mode', { sandbox: true });
- });
- describe('enableWebSQL webpreference', () => {
- const origin = `${standardScheme}://fake-host`;
- const filePath = path.join(fixturesPath, 'pages', 'storage', 'web_sql.html');
- const sqlPartition = 'web-sql-preference-test';
- const sqlSession = session.fromPartition(sqlPartition);
- const securityError = 'An attempt was made to break through the security policy of the user agent.';
- let contents: WebContents, w: BrowserWindow;
- before(() => {
- sqlSession.protocol.registerFileProtocol(standardScheme, (request, callback) => {
- callback({ path: filePath });
- });
- });
- after(() => {
- sqlSession.protocol.unregisterProtocol(standardScheme);
- });
- afterEach(async () => {
- if (contents) {
- contents.destroy();
- contents = null as any;
- }
- await closeAllWindows();
- (w as any) = null;
- });
- it('default value allows websql', async () => {
- contents = (webContents as typeof ElectronInternal.WebContents).create({
- session: sqlSession,
- nodeIntegration: true,
- contextIsolation: false
- });
- contents.loadURL(origin);
- const [, error] = await once(ipcMain, 'web-sql-response');
- expect(error).to.be.null();
- });
- it('when set to false can disallow websql', async () => {
- contents = (webContents as typeof ElectronInternal.WebContents).create({
- session: sqlSession,
- nodeIntegration: true,
- enableWebSQL: false,
- contextIsolation: false
- });
- contents.loadURL(origin);
- const [, error] = await once(ipcMain, 'web-sql-response');
- expect(error).to.equal(securityError);
- });
- it('when set to false does not disable indexedDB', async () => {
- contents = (webContents as typeof ElectronInternal.WebContents).create({
- session: sqlSession,
- nodeIntegration: true,
- enableWebSQL: false,
- contextIsolation: false
- });
- contents.loadURL(origin);
- const [, error] = await once(ipcMain, 'web-sql-response');
- expect(error).to.equal(securityError);
- const dbName = 'random';
- const result = await contents.executeJavaScript(`
- new Promise((resolve, reject) => {
- try {
- let req = window.indexedDB.open('${dbName}');
- req.onsuccess = (event) => {
- let db = req.result;
- resolve(db.name);
- }
- req.onerror = (event) => { resolve(event.target.code); }
- } catch (e) {
- resolve(e.message);
- }
- });
- `);
- expect(result).to.equal(dbName);
- });
- it('child webContents can override when the embedder has allowed websql', async () => {
- w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- webviewTag: true,
- session: sqlSession,
- contextIsolation: false
- }
- });
- w.webContents.loadURL(origin);
- const [, error] = await once(ipcMain, 'web-sql-response');
- expect(error).to.be.null();
- const webviewResult = once(ipcMain, 'web-sql-response');
- await w.webContents.executeJavaScript(`
- new Promise((resolve, reject) => {
- const webview = new WebView();
- webview.setAttribute('src', '${origin}');
- webview.setAttribute('webpreferences', 'enableWebSQL=0,contextIsolation=no');
- webview.setAttribute('partition', '${sqlPartition}');
- webview.setAttribute('nodeIntegration', 'on');
- document.body.appendChild(webview);
- webview.addEventListener('dom-ready', () => resolve());
- });
- `);
- const [, childError] = await webviewResult;
- expect(childError).to.equal(securityError);
- });
- it('child webContents cannot override when the embedder has disallowed websql', async () => {
- w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- enableWebSQL: false,
- webviewTag: true,
- session: sqlSession,
- contextIsolation: false
- }
- });
- w.webContents.loadURL('data:text/html,<html></html>');
- const webviewResult = once(ipcMain, 'web-sql-response');
- await w.webContents.executeJavaScript(`
- new Promise((resolve, reject) => {
- const webview = new WebView();
- webview.setAttribute('src', '${origin}');
- webview.setAttribute('webpreferences', 'enableWebSQL=1,contextIsolation=no');
- webview.setAttribute('partition', '${sqlPartition}');
- webview.setAttribute('nodeIntegration', 'on');
- document.body.appendChild(webview);
- webview.addEventListener('dom-ready', () => resolve());
- });
- `);
- const [, childError] = await webviewResult;
- expect(childError).to.equal(securityError);
- });
- it('child webContents can use websql when the embedder has allowed websql', async () => {
- w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- webviewTag: true,
- session: sqlSession,
- contextIsolation: false
- }
- });
- w.webContents.loadURL(origin);
- const [, error] = await once(ipcMain, 'web-sql-response');
- expect(error).to.be.null();
- const webviewResult = once(ipcMain, 'web-sql-response');
- await w.webContents.executeJavaScript(`
- new Promise((resolve, reject) => {
- const webview = new WebView();
- webview.setAttribute('src', '${origin}');
- webview.setAttribute('webpreferences', 'enableWebSQL=1,contextIsolation=no');
- webview.setAttribute('partition', '${sqlPartition}');
- webview.setAttribute('nodeIntegration', 'on');
- document.body.appendChild(webview);
- webview.addEventListener('dom-ready', () => resolve());
- });
- `);
- const [, childError] = await webviewResult;
- expect(childError).to.be.null();
- });
- });
- describe('DOM storage quota increase', () => {
- for (const storageName of ['localStorage', 'sessionStorage']) {
- it(`allows saving at least 40MiB in ${storageName}`, async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- // Although JavaScript strings use UTF-16, the underlying
- // storage provider may encode strings differently, muddling the
- // translation between character and byte counts. However,
- // a string of 40 * 2^20 characters will require at least 40MiB
- // and presumably no more than 80MiB, a size guaranteed to
- // to exceed the original 10MiB quota yet stay within the
- // new 100MiB quota.
- // Note that both the key name and value affect the total size.
- const testKeyName = '_electronDOMStorageQuotaIncreasedTest';
- const length = 40 * Math.pow(2, 20) - testKeyName.length;
- await w.webContents.executeJavaScript(`
- ${storageName}.setItem(${JSON.stringify(testKeyName)}, 'X'.repeat(${length}));
- `);
- // Wait at least one turn of the event loop to help avoid false positives
- // Although not entirely necessary, the previous version of this test case
- // failed to detect a real problem (perhaps related to DOM storage data caching)
- // wherein calling `getItem` immediately after `setItem` would appear to work
- // but then later (e.g. next tick) it would not.
- await setTimeout(1);
- try {
- const storedLength = await w.webContents.executeJavaScript(`${storageName}.getItem(${JSON.stringify(testKeyName)}).length`);
- expect(storedLength).to.equal(length);
- } finally {
- await w.webContents.executeJavaScript(`${storageName}.removeItem(${JSON.stringify(testKeyName)});`);
- }
- });
- it(`throws when attempting to use more than 128MiB in ${storageName}`, async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- await expect((async () => {
- const testKeyName = '_electronDOMStorageQuotaStillEnforcedTest';
- const length = 128 * Math.pow(2, 20) - testKeyName.length;
- try {
- await w.webContents.executeJavaScript(`
- ${storageName}.setItem(${JSON.stringify(testKeyName)}, 'X'.repeat(${length}));
- `);
- } finally {
- await w.webContents.executeJavaScript(`${storageName}.removeItem(${JSON.stringify(testKeyName)});`);
- }
- })()).to.eventually.be.rejected();
- });
- }
- });
- describe('persistent storage', () => {
- it('can be requested', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const grantedBytes = await w.webContents.executeJavaScript(`new Promise(resolve => {
- navigator.webkitPersistentStorage.requestQuota(1024 * 1024, resolve);
- })`);
- expect(grantedBytes).to.equal(1048576);
- });
- });
- });
- ifdescribe(features.isPDFViewerEnabled())('PDF Viewer', () => {
- const pdfSource = url.format({
- pathname: path.join(__dirname, 'fixtures', 'cat.pdf').replace(/\\/g, '/'),
- protocol: 'file',
- slashes: true
- });
- it('successfully loads a PDF file', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL(pdfSource);
- await once(w.webContents, 'did-finish-load');
- });
- it('opens when loading a pdf resource as top level navigation', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL(pdfSource);
- const [, contents] = await once(app, 'web-contents-created') as [any, WebContents];
- await once(contents, 'did-navigate');
- expect(contents.getURL()).to.equal('chrome-extension://mhjfbmdgcfjbbpaeojofohoefgiehjai/index.html');
- });
- it('opens when loading a pdf resource in a iframe', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadFile(path.join(__dirname, 'fixtures', 'pages', 'pdf-in-iframe.html'));
- const [, contents] = await once(app, 'web-contents-created') as [any, WebContents];
- await once(contents, 'did-navigate');
- expect(contents.getURL()).to.equal('chrome-extension://mhjfbmdgcfjbbpaeojofohoefgiehjai/index.html');
- });
- });
- describe('window.history', () => {
- describe('window.history.pushState', () => {
- it('should push state after calling history.pushState() from the same url', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- // History should have current page by now.
- expect((w.webContents as any).length()).to.equal(1);
- const waitCommit = once(w.webContents, 'navigation-entry-committed');
- w.webContents.executeJavaScript('window.history.pushState({}, "")');
- await waitCommit;
- // Initial page + pushed state.
- expect((w.webContents as any).length()).to.equal(2);
- });
- });
- describe('window.history.back', () => {
- it('should not allow sandboxed iframe to modify main frame state', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL('data:text/html,<iframe sandbox="allow-scripts"></iframe>');
- await Promise.all([
- once(w.webContents, 'navigation-entry-committed'),
- once(w.webContents, 'did-frame-navigate'),
- once(w.webContents, 'did-navigate')
- ]);
- w.webContents.executeJavaScript('window.history.pushState(1, "")');
- await Promise.all([
- once(w.webContents, 'navigation-entry-committed'),
- once(w.webContents, 'did-navigate-in-page')
- ]);
- (w.webContents as any).once('navigation-entry-committed', () => {
- expect.fail('Unexpected navigation-entry-committed');
- });
- w.webContents.once('did-navigate-in-page', () => {
- expect.fail('Unexpected did-navigate-in-page');
- });
- await w.webContents.mainFrame.frames[0].executeJavaScript('window.history.back()');
- expect(await w.webContents.executeJavaScript('window.history.state')).to.equal(1);
- expect((w.webContents as any).getActiveIndex()).to.equal(1);
- });
- });
- });
- describe('chrome:// pages', () => {
- const urls = [
- 'chrome://accessibility',
- 'chrome://gpu',
- 'chrome://media-internals',
- 'chrome://tracing',
- 'chrome://webrtc-internals'
- ];
- for (const url of urls) {
- describe(url, () => {
- it('loads the page successfully', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(url);
- const pageExists = await w.webContents.executeJavaScript(
- "window.hasOwnProperty('chrome') && window.chrome.hasOwnProperty('send')"
- );
- expect(pageExists).to.be.true();
- });
- });
- }
- });
- describe('document.hasFocus', () => {
- it('has correct value when multiple windows are opened', async () => {
- const w1 = new BrowserWindow({ show: true });
- const w2 = new BrowserWindow({ show: true });
- const w3 = new BrowserWindow({ show: false });
- await w1.loadFile(path.join(__dirname, 'fixtures', 'blank.html'));
- await w2.loadFile(path.join(__dirname, 'fixtures', 'blank.html'));
- await w3.loadFile(path.join(__dirname, 'fixtures', 'blank.html'));
- expect(webContents.getFocusedWebContents()?.id).to.equal(w2.webContents.id);
- let focus = false;
- focus = await w1.webContents.executeJavaScript(
- 'document.hasFocus()'
- );
- expect(focus).to.be.false();
- focus = await w2.webContents.executeJavaScript(
- 'document.hasFocus()'
- );
- expect(focus).to.be.true();
- focus = await w3.webContents.executeJavaScript(
- 'document.hasFocus()'
- );
- expect(focus).to.be.false();
- });
- });
- // https://developer.mozilla.org/en-US/docs/Web/API/NetworkInformation
- describe('navigator.connection', () => {
- it('returns the correct value', async () => {
- const w = new BrowserWindow({ show: false });
- w.webContents.session.enableNetworkEmulation({
- latency: 500,
- downloadThroughput: 6400,
- uploadThroughput: 6400
- });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const rtt = await w.webContents.executeJavaScript('navigator.connection.rtt');
- expect(rtt).to.be.a('number');
- const downlink = await w.webContents.executeJavaScript('navigator.connection.downlink');
- expect(downlink).to.be.a('number');
- const effectiveTypes = ['slow-2g', '2g', '3g', '4g'];
- const effectiveType = await w.webContents.executeJavaScript('navigator.connection.effectiveType');
- expect(effectiveTypes).to.include(effectiveType);
- });
- });
- describe('navigator.userAgentData', () => {
- // These tests are done on an http server because navigator.userAgentData
- // requires a secure context.
- let server: http.Server;
- let serverUrl: string;
- before(async () => {
- server = http.createServer((req, res) => {
- res.setHeader('Content-Type', 'text/html');
- res.end('');
- });
- serverUrl = (await listen(server)).url;
- });
- after(() => {
- server.close();
- });
- describe('is not empty', () => {
- it('by default', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(serverUrl);
- const platform = await w.webContents.executeJavaScript('navigator.userAgentData.platform');
- expect(platform).not.to.be.empty();
- });
- it('when there is a session-wide UA override', async () => {
- const ses = session.fromPartition(`${Math.random()}`);
- ses.setUserAgent('foobar');
- const w = new BrowserWindow({ show: false, webPreferences: { session: ses } });
- await w.loadURL(serverUrl);
- const platform = await w.webContents.executeJavaScript('navigator.userAgentData.platform');
- expect(platform).not.to.be.empty();
- });
- it('when there is a WebContents-specific UA override', async () => {
- const w = new BrowserWindow({ show: false });
- w.webContents.setUserAgent('foo');
- await w.loadURL(serverUrl);
- const platform = await w.webContents.executeJavaScript('navigator.userAgentData.platform');
- expect(platform).not.to.be.empty();
- });
- it('when there is a WebContents-specific UA override at load time', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(serverUrl, {
- userAgent: 'foo'
- });
- const platform = await w.webContents.executeJavaScript('navigator.userAgentData.platform');
- expect(platform).not.to.be.empty();
- });
- });
- describe('brand list', () => {
- it('contains chromium', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(serverUrl);
- const brands = await w.webContents.executeJavaScript('navigator.userAgentData.brands');
- expect(brands.map((b: any) => b.brand)).to.include('Chromium');
- });
- });
- });
- describe('Badging API', () => {
- it('does not crash', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- await w.webContents.executeJavaScript('navigator.setAppBadge(42)');
- await w.webContents.executeJavaScript('navigator.setAppBadge()');
- await w.webContents.executeJavaScript('navigator.clearAppBadge()');
- });
- });
- describe('navigator.webkitGetUserMedia', () => {
- it('calls its callbacks', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- await w.webContents.executeJavaScript(`new Promise((resolve) => {
- navigator.webkitGetUserMedia({
- audio: true,
- video: false
- }, () => resolve(),
- () => resolve());
- })`);
- });
- });
- describe('navigator.language', () => {
- it('should not be empty', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL('about:blank');
- expect(await w.webContents.executeJavaScript('navigator.language')).to.not.equal('');
- });
- });
- describe('heap snapshot', () => {
- it('does not crash', async () => {
- const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
- w.loadURL('about:blank');
- await w.webContents.executeJavaScript('process._linkedBinding(\'electron_common_v8_util\').takeHeapSnapshot()');
- });
- });
- // This is intentionally disabled on arm macs: https://chromium-review.googlesource.com/c/chromium/src/+/4143761
- ifdescribe(process.platform === 'darwin' && process.arch !== 'arm64')('webgl', () => {
- it('can be gotten as context in canvas', async () => {
- const w = new BrowserWindow({ show: false });
- w.loadURL('about:blank');
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const canWebglContextBeCreated = await w.webContents.executeJavaScript(`
- document.createElement('canvas').getContext('webgl') != null;
- `);
- expect(canWebglContextBeCreated).to.be.true();
- });
- });
- describe('iframe', () => {
- it('does not have node integration', async () => {
- const w = new BrowserWindow({ show: false });
- await w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const result = await w.webContents.executeJavaScript(`
- const iframe = document.createElement('iframe')
- iframe.src = './set-global.html';
- document.body.appendChild(iframe);
- new Promise(resolve => iframe.onload = e => resolve(iframe.contentWindow.test))
- `);
- expect(result).to.equal('undefined undefined undefined');
- });
- });
- describe('websockets', () => {
- it('has user agent', async () => {
- const server = http.createServer();
- const { port } = await listen(server);
- const wss = new ws.Server({ server: server });
- const finished = new Promise<string | undefined>((resolve, reject) => {
- wss.on('error', reject);
- wss.on('connection', (ws, upgradeReq) => {
- resolve(upgradeReq.headers['user-agent']);
- });
- });
- const w = new BrowserWindow({ show: false });
- w.loadURL('about:blank');
- w.webContents.executeJavaScript(`
- new WebSocket('ws://127.0.0.1:${port}');
- `);
- expect(await finished).to.include('Electron');
- });
- });
- describe('fetch', () => {
- it('does not crash', async () => {
- const server = http.createServer((req, res) => {
- res.end('test');
- });
- defer(() => server.close());
- const { port } = await listen(server);
- const w = new BrowserWindow({ show: false });
- w.loadURL(`file://${fixturesPath}/pages/blank.html`);
- const x = await w.webContents.executeJavaScript(`
- fetch('http://127.0.0.1:${port}').then((res) => res.body.getReader())
- .then((reader) => {
- return reader.read().then((r) => {
- reader.cancel();
- return r.value;
- });
- })
- `);
- expect(x).to.deep.equal(new Uint8Array([116, 101, 115, 116]));
- });
- });
- describe('Promise', () => {
- before(() => {
- ipcMain.handle('ping', (e, arg) => arg);
- });
- after(() => {
- ipcMain.removeHandler('ping');
- });
- itremote('resolves correctly in Node.js calls', async () => {
- await new Promise<void>((resolve, reject) => {
- class XElement extends HTMLElement {}
- customElements.define('x-element', XElement);
- setImmediate(() => {
- let called = false;
- Promise.resolve().then(() => {
- if (called) resolve();
- else reject(new Error('wrong sequence'));
- });
- document.createElement('x-element');
- called = true;
- });
- });
- });
- itremote('resolves correctly in Electron calls', async () => {
- await new Promise<void>((resolve, reject) => {
- class YElement extends HTMLElement {}
- customElements.define('y-element', YElement);
- require('electron').ipcRenderer.invoke('ping').then(() => {
- let called = false;
- Promise.resolve().then(() => {
- if (called) resolve();
- else reject(new Error('wrong sequence'));
- });
- document.createElement('y-element');
- called = true;
- });
- });
- });
- });
- describe('synchronous prompts', () => {
- describe('window.alert(message, title)', () => {
- itremote('throws an exception when the arguments cannot be converted to strings', () => {
- expect(() => {
- window.alert({ toString: null });
- }).to.throw('Cannot convert object to primitive value');
- });
- });
- describe('window.confirm(message, title)', () => {
- itremote('throws an exception when the arguments cannot be converted to strings', () => {
- expect(() => {
- (window.confirm as any)({ toString: null }, 'title');
- }).to.throw('Cannot convert object to primitive value');
- });
- });
- });
- describe('window.history', () => {
- describe('window.history.go(offset)', () => {
- itremote('throws an exception when the argument cannot be converted to a string', () => {
- expect(() => {
- (window.history.go as any)({ toString: null });
- }).to.throw('Cannot convert object to primitive value');
- });
- });
- });
- describe('console functions', () => {
- itremote('should exist', () => {
- expect(console.log, 'log').to.be.a('function');
- expect(console.error, 'error').to.be.a('function');
- expect(console.warn, 'warn').to.be.a('function');
- expect(console.info, 'info').to.be.a('function');
- expect(console.debug, 'debug').to.be.a('function');
- expect(console.trace, 'trace').to.be.a('function');
- expect(console.time, 'time').to.be.a('function');
- expect(console.timeEnd, 'timeEnd').to.be.a('function');
- });
- });
- // FIXME(nornagon): this is broken on CI, it triggers:
- // [FATAL:speech_synthesis.mojom-shared.h(237)] The outgoing message will
- // trigger VALIDATION_ERROR_UNEXPECTED_NULL_POINTER at the receiving side
- // (null text in SpeechSynthesisUtterance struct).
- describe('SpeechSynthesis', () => {
- itremote('should emit lifecycle events', async () => {
- const sentence = `long sentence which will take at least a few seconds to
- utter so that it's possible to pause and resume before the end`;
- const utter = new SpeechSynthesisUtterance(sentence);
- // Create a dummy utterance so that speech synthesis state
- // is initialized for later calls.
- speechSynthesis.speak(new SpeechSynthesisUtterance());
- speechSynthesis.cancel();
- speechSynthesis.speak(utter);
- // paused state after speak()
- expect(speechSynthesis.paused).to.be.false();
- await new Promise((resolve) => { utter.onstart = resolve; });
- // paused state after start event
- expect(speechSynthesis.paused).to.be.false();
- speechSynthesis.pause();
- // paused state changes async, right before the pause event
- expect(speechSynthesis.paused).to.be.false();
- await new Promise((resolve) => { utter.onpause = resolve; });
- expect(speechSynthesis.paused).to.be.true();
- speechSynthesis.resume();
- await new Promise((resolve) => { utter.onresume = resolve; });
- // paused state after resume event
- expect(speechSynthesis.paused).to.be.false();
- await new Promise((resolve) => { utter.onend = resolve; });
- });
- });
- });
- describe('font fallback', () => {
- async function getRenderedFonts (html: string) {
- const w = new BrowserWindow({ show: false });
- try {
- await w.loadURL(`data:text/html,${html}`);
- w.webContents.debugger.attach();
- const sendCommand = (method: string, commandParams?: any) => w.webContents.debugger.sendCommand(method, commandParams);
- const { nodeId } = (await sendCommand('DOM.getDocument')).root.children[0];
- await sendCommand('CSS.enable');
- const { fonts } = await sendCommand('CSS.getPlatformFontsForNode', { nodeId });
- return fonts;
- } finally {
- w.close();
- }
- }
- it('should use Helvetica for sans-serif on Mac, and Arial on Windows and Linux', async () => {
- const html = '<body style="font-family: sans-serif">test</body>';
- const fonts = await getRenderedFonts(html);
- expect(fonts).to.be.an('array');
- expect(fonts).to.have.length(1);
- if (process.platform === 'win32') {
- expect(fonts[0].familyName).to.equal('Arial');
- } else if (process.platform === 'darwin') {
- expect(fonts[0].familyName).to.equal('Helvetica');
- } else if (process.platform === 'linux') {
- expect(fonts[0].familyName).to.equal('DejaVu Sans');
- } // I think this depends on the distro? We don't specify a default.
- });
- ifit(process.platform !== 'linux')('should fall back to Japanese font for sans-serif Japanese script', async function () {
- const html = `
- <html lang="ja-JP">
- <head>
- <meta charset="utf-8" />
- </head>
- <body style="font-family: sans-serif">test 智史</body>
- </html>
- `;
- const fonts = await getRenderedFonts(html);
- expect(fonts).to.be.an('array');
- expect(fonts).to.have.length(1);
- if (process.platform === 'win32') { expect(fonts[0].familyName).to.be.oneOf(['Meiryo', 'Yu Gothic']); } else if (process.platform === 'darwin') { expect(fonts[0].familyName).to.equal('Hiragino Kaku Gothic ProN'); }
- });
- });
- describe('iframe using HTML fullscreen API while window is OS-fullscreened', () => {
- const fullscreenChildHtml = promisify(fs.readFile)(
- path.join(fixturesPath, 'pages', 'fullscreen-oopif.html')
- );
- let w: BrowserWindow;
- let server: http.Server;
- let crossSiteUrl: string;
- beforeEach(async () => {
- server = http.createServer(async (_req, res) => {
- res.writeHead(200, { 'Content-Type': 'text/html' });
- res.write(await fullscreenChildHtml);
- res.end();
- });
- const serverUrl = (await listen(server)).url;
- crossSiteUrl = serverUrl.replace('127.0.0.1', 'localhost');
- w = new BrowserWindow({
- show: true,
- fullscreen: true,
- webPreferences: {
- nodeIntegration: true,
- nodeIntegrationInSubFrames: true,
- contextIsolation: false
- }
- });
- });
- afterEach(async () => {
- await closeAllWindows();
- (w as any) = null;
- server.close();
- });
- ifit(process.platform !== 'darwin')('can fullscreen from out-of-process iframes (non-macOS)', async () => {
- const fullscreenChange = once(ipcMain, 'fullscreenChange');
- const html =
- `<iframe style="width: 0" frameborder=0 src="${crossSiteUrl}" allowfullscreen></iframe>`;
- w.loadURL(`data:text/html,${html}`);
- await fullscreenChange;
- const fullscreenWidth = await w.webContents.executeJavaScript(
- "document.querySelector('iframe').offsetWidth"
- );
- expect(fullscreenWidth > 0).to.be.true();
- await w.webContents.executeJavaScript(
- "document.querySelector('iframe').contentWindow.postMessage('exitFullscreen', '*')"
- );
- await setTimeout(500);
- const width = await w.webContents.executeJavaScript(
- "document.querySelector('iframe').offsetWidth"
- );
- expect(width).to.equal(0);
- });
- ifit(process.platform === 'darwin')('can fullscreen from out-of-process iframes (macOS)', async () => {
- await once(w, 'enter-full-screen');
- const fullscreenChange = once(ipcMain, 'fullscreenChange');
- const html =
- `<iframe style="width: 0" frameborder=0 src="${crossSiteUrl}" allowfullscreen></iframe>`;
- w.loadURL(`data:text/html,${html}`);
- await fullscreenChange;
- const fullscreenWidth = await w.webContents.executeJavaScript(
- "document.querySelector('iframe').offsetWidth"
- );
- expect(fullscreenWidth > 0).to.be.true();
- await w.webContents.executeJavaScript(
- "document.querySelector('iframe').contentWindow.postMessage('exitFullscreen', '*')"
- );
- await once(w.webContents, 'leave-html-full-screen');
- const width = await w.webContents.executeJavaScript(
- "document.querySelector('iframe').offsetWidth"
- );
- expect(width).to.equal(0);
- w.setFullScreen(false);
- await once(w, 'leave-full-screen');
- });
- // TODO(jkleinsc) fix this flaky test on WOA
- ifit(process.platform !== 'win32' || process.arch !== 'arm64')('can fullscreen from in-process iframes', async () => {
- if (process.platform === 'darwin') await once(w, 'enter-full-screen');
- const fullscreenChange = once(ipcMain, 'fullscreenChange');
- w.loadFile(path.join(fixturesPath, 'pages', 'fullscreen-ipif.html'));
- await fullscreenChange;
- const fullscreenWidth = await w.webContents.executeJavaScript(
- "document.querySelector('iframe').offsetWidth"
- );
- expect(fullscreenWidth > 0).to.true();
- await w.webContents.executeJavaScript('document.exitFullscreen()');
- const width = await w.webContents.executeJavaScript(
- "document.querySelector('iframe').offsetWidth"
- );
- expect(width).to.equal(0);
- });
- });
- describe('navigator.serial', () => {
- let w: BrowserWindow;
- before(async () => {
- w = new BrowserWindow({
- show: false
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- });
- const getPorts: any = () => {
- return w.webContents.executeJavaScript(`
- navigator.serial.requestPort().then(port => port.toString()).catch(err => err.toString());
- `, true);
- };
- const notFoundError = 'NotFoundError: Failed to execute \'requestPort\' on \'Serial\': No port selected by the user.';
- after(closeAllWindows);
- afterEach(() => {
- session.defaultSession.setPermissionCheckHandler(null);
- session.defaultSession.removeAllListeners('select-serial-port');
- });
- it('does not return a port if select-serial-port event is not defined', async () => {
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const port = await getPorts();
- expect(port).to.equal(notFoundError);
- });
- it('does not return a port when permission denied', async () => {
- w.webContents.session.on('select-serial-port', (event, portList, webContents, callback) => {
- callback(portList[0].portId);
- });
- session.defaultSession.setPermissionCheckHandler(() => false);
- const port = await getPorts();
- expect(port).to.equal(notFoundError);
- });
- it('does not crash when select-serial-port is called with an invalid port', async () => {
- w.webContents.session.on('select-serial-port', (event, portList, webContents, callback) => {
- callback('i-do-not-exist');
- });
- const port = await getPorts();
- expect(port).to.equal(notFoundError);
- });
- it('returns a port when select-serial-port event is defined', async () => {
- let havePorts = false;
- w.webContents.session.on('select-serial-port', (event, portList, webContents, callback) => {
- if (portList.length > 0) {
- havePorts = true;
- callback(portList[0].portId);
- } else {
- callback('');
- }
- });
- const port = await getPorts();
- if (havePorts) {
- expect(port).to.equal('[object SerialPort]');
- } else {
- expect(port).to.equal(notFoundError);
- }
- });
- it('navigator.serial.getPorts() returns values', async () => {
- let havePorts = false;
- w.webContents.session.on('select-serial-port', (event, portList, webContents, callback) => {
- if (portList.length > 0) {
- havePorts = true;
- callback(portList[0].portId);
- } else {
- callback('');
- }
- });
- await getPorts();
- if (havePorts) {
- const grantedPorts = await w.webContents.executeJavaScript('navigator.serial.getPorts()');
- expect(grantedPorts).to.not.be.empty();
- }
- });
- it('supports port.forget()', async () => {
- let forgottenPortFromEvent = {};
- let havePorts = false;
- w.webContents.session.on('select-serial-port', (event, portList, webContents, callback) => {
- if (portList.length > 0) {
- havePorts = true;
- callback(portList[0].portId);
- } else {
- callback('');
- }
- });
- w.webContents.session.on('serial-port-revoked', (event, details) => {
- forgottenPortFromEvent = details.port;
- });
- await getPorts();
- if (havePorts) {
- const grantedPorts = await w.webContents.executeJavaScript('navigator.serial.getPorts()');
- if (grantedPorts.length > 0) {
- const forgottenPort = await w.webContents.executeJavaScript(`
- navigator.serial.getPorts().then(async(ports) => {
- const portInfo = await ports[0].getInfo();
- await ports[0].forget();
- if (portInfo.usbVendorId && portInfo.usbProductId) {
- return {
- vendorId: '' + portInfo.usbVendorId,
- productId: '' + portInfo.usbProductId
- }
- } else {
- return {};
- }
- })
- `);
- const grantedPorts2 = await w.webContents.executeJavaScript('navigator.serial.getPorts()');
- expect(grantedPorts2.length).to.be.lessThan(grantedPorts.length);
- if (forgottenPort.vendorId && forgottenPort.productId) {
- expect(forgottenPortFromEvent).to.include(forgottenPort);
- }
- }
- }
- });
- });
- describe('window.getScreenDetails', () => {
- let w: BrowserWindow;
- before(async () => {
- w = new BrowserWindow({
- show: false
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- });
- after(closeAllWindows);
- afterEach(() => {
- session.defaultSession.setPermissionRequestHandler(null);
- });
- const getScreenDetails: any = () => {
- return w.webContents.executeJavaScript('window.getScreenDetails().then(data => data.screens).catch(err => err.message)', true);
- };
- it('returns screens when a PermissionRequestHandler is not defined', async () => {
- const screens = await getScreenDetails();
- expect(screens).to.not.equal('Read permission denied.');
- });
- it('returns an error when permission denied', async () => {
- session.defaultSession.setPermissionRequestHandler((wc, permission, callback) => {
- if (permission === 'window-management') {
- callback(false);
- } else {
- callback(true);
- }
- });
- const screens = await getScreenDetails();
- expect(screens).to.equal('Permission denied.');
- });
- it('returns screens when permission is granted', async () => {
- session.defaultSession.setPermissionRequestHandler((wc, permission, callback) => {
- if (permission === 'window-management') {
- callback(true);
- } else {
- callback(false);
- }
- });
- const screens = await getScreenDetails();
- expect(screens).to.not.equal('Permission denied.');
- });
- });
- describe('navigator.clipboard.read', () => {
- let w: BrowserWindow;
- before(async () => {
- w = new BrowserWindow();
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- });
- const readClipboard: any = () => {
- return w.webContents.executeJavaScript(`
- navigator.clipboard.read().then(clipboard => clipboard.toString()).catch(err => err.message);
- `, true);
- };
- after(closeAllWindows);
- afterEach(() => {
- session.defaultSession.setPermissionRequestHandler(null);
- });
- it('returns clipboard contents when a PermissionRequestHandler is not defined', async () => {
- const clipboard = await readClipboard();
- expect(clipboard).to.not.equal('Read permission denied.');
- });
- it('returns an error when permission denied', async () => {
- session.defaultSession.setPermissionRequestHandler((wc, permission, callback) => {
- if (permission === 'clipboard-read') {
- callback(false);
- } else {
- callback(true);
- }
- });
- const clipboard = await readClipboard();
- expect(clipboard).to.equal('Read permission denied.');
- });
- it('returns clipboard contents when permission is granted', async () => {
- session.defaultSession.setPermissionRequestHandler((wc, permission, callback) => {
- if (permission === 'clipboard-read') {
- callback(true);
- } else {
- callback(false);
- }
- });
- const clipboard = await readClipboard();
- expect(clipboard).to.not.equal('Read permission denied.');
- });
- });
- describe('navigator.clipboard.write', () => {
- let w: BrowserWindow;
- before(async () => {
- w = new BrowserWindow();
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- });
- const writeClipboard: any = () => {
- return w.webContents.executeJavaScript(`
- navigator.clipboard.writeText('Hello World!').catch(err => err.message);
- `, true);
- };
- after(closeAllWindows);
- afterEach(() => {
- session.defaultSession.setPermissionRequestHandler(null);
- });
- it('returns clipboard contents when a PermissionRequestHandler is not defined', async () => {
- const clipboard = await writeClipboard();
- expect(clipboard).to.not.equal('Write permission denied.');
- });
- it('returns an error when permission denied', async () => {
- session.defaultSession.setPermissionRequestHandler((wc, permission, callback) => {
- if (permission === 'clipboard-sanitized-write') {
- callback(false);
- } else {
- callback(true);
- }
- });
- const clipboard = await writeClipboard();
- expect(clipboard).to.equal('Write permission denied.');
- });
- it('returns clipboard contents when permission is granted', async () => {
- session.defaultSession.setPermissionRequestHandler((wc, permission, callback) => {
- if (permission === 'clipboard-sanitized-write') {
- callback(true);
- } else {
- callback(false);
- }
- });
- const clipboard = await writeClipboard();
- expect(clipboard).to.not.equal('Write permission denied.');
- });
- });
- ifdescribe((process.platform !== 'linux' || app.isUnityRunning()))('navigator.setAppBadge/clearAppBadge', () => {
- let w: BrowserWindow;
- const expectedBadgeCount = 42;
- const fireAppBadgeAction: any = (action: string, value: any) => {
- return w.webContents.executeJavaScript(`
- navigator.${action}AppBadge(${value}).then(() => 'success').catch(err => err.message)`);
- };
- // For some reason on macOS changing the badge count doesn't happen right away, so wait
- // until it changes.
- async function waitForBadgeCount (value: number) {
- let badgeCount = app.getBadgeCount();
- while (badgeCount !== value) {
- await setTimeout(10);
- badgeCount = app.getBadgeCount();
- }
- return badgeCount;
- }
- describe('in the renderer', () => {
- before(async () => {
- w = new BrowserWindow({
- show: false
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- });
- after(() => {
- app.badgeCount = 0;
- closeAllWindows();
- });
- it('setAppBadge can set a numerical value', async () => {
- const result = await fireAppBadgeAction('set', expectedBadgeCount);
- expect(result).to.equal('success');
- expect(waitForBadgeCount(expectedBadgeCount)).to.eventually.equal(expectedBadgeCount);
- });
- it('setAppBadge can set an empty(dot) value', async () => {
- const result = await fireAppBadgeAction('set');
- expect(result).to.equal('success');
- expect(waitForBadgeCount(0)).to.eventually.equal(0);
- });
- it('clearAppBadge can clear a value', async () => {
- let result = await fireAppBadgeAction('set', expectedBadgeCount);
- expect(result).to.equal('success');
- expect(waitForBadgeCount(expectedBadgeCount)).to.eventually.equal(expectedBadgeCount);
- result = await fireAppBadgeAction('clear');
- expect(result).to.equal('success');
- expect(waitForBadgeCount(0)).to.eventually.equal(0);
- });
- });
- describe('in a service worker', () => {
- beforeEach(async () => {
- w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true,
- partition: 'sw-file-scheme-spec',
- contextIsolation: false
- }
- });
- });
- afterEach(() => {
- app.badgeCount = 0;
- closeAllWindows();
- });
- it('setAppBadge can be called in a ServiceWorker', (done) => {
- w.webContents.on('ipc-message', (event, channel, message) => {
- if (channel === 'reload') {
- w.webContents.reload();
- } else if (channel === 'error') {
- done(message);
- } else if (channel === 'response') {
- expect(message).to.equal('SUCCESS setting app badge');
- expect(waitForBadgeCount(expectedBadgeCount)).to.eventually.equal(expectedBadgeCount);
- session.fromPartition('sw-file-scheme-spec').clearStorageData({
- storages: ['serviceworkers']
- }).then(() => done());
- }
- });
- w.webContents.on('render-process-gone', () => done(new Error('WebContents crashed.')));
- w.loadFile(path.join(fixturesPath, 'pages', 'service-worker', 'badge-index.html'), { search: '?setBadge' });
- });
- it('clearAppBadge can be called in a ServiceWorker', (done) => {
- w.webContents.on('ipc-message', (event, channel, message) => {
- if (channel === 'reload') {
- w.webContents.reload();
- } else if (channel === 'setAppBadge') {
- expect(message).to.equal('SUCCESS setting app badge');
- expect(waitForBadgeCount(expectedBadgeCount)).to.eventually.equal(expectedBadgeCount);
- } else if (channel === 'error') {
- done(message);
- } else if (channel === 'response') {
- expect(message).to.equal('SUCCESS clearing app badge');
- expect(waitForBadgeCount(expectedBadgeCount)).to.eventually.equal(expectedBadgeCount);
- session.fromPartition('sw-file-scheme-spec').clearStorageData({
- storages: ['serviceworkers']
- }).then(() => done());
- }
- });
- w.webContents.on('render-process-gone', () => done(new Error('WebContents crashed.')));
- w.loadFile(path.join(fixturesPath, 'pages', 'service-worker', 'badge-index.html'), { search: '?clearBadge' });
- });
- });
- });
- describe('navigator.bluetooth', () => {
- let w: BrowserWindow;
- before(async () => {
- w = new BrowserWindow({
- show: false,
- webPreferences: {
- enableBlinkFeatures: 'WebBluetooth'
- }
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- });
- after(closeAllWindows);
- it('can request bluetooth devices', async () => {
- const bluetooth = await w.webContents.executeJavaScript(`
- navigator.bluetooth.requestDevice({ acceptAllDevices: true}).then(device => "Found a device!").catch(err => err.message);`, true);
- expect(bluetooth).to.be.oneOf(['Found a device!', 'Bluetooth adapter not available.', 'User cancelled the requestDevice() chooser.']);
- });
- });
- describe('navigator.hid', () => {
- let w: BrowserWindow;
- let server: http.Server;
- let serverUrl: string;
- before(async () => {
- w = new BrowserWindow({
- show: false
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- server = http.createServer((req, res) => {
- res.setHeader('Content-Type', 'text/html');
- res.end('<body>');
- });
- serverUrl = (await listen(server)).url;
- });
- const requestDevices: any = () => {
- return w.webContents.executeJavaScript(`
- navigator.hid.requestDevice({filters: []}).then(device => device.toString()).catch(err => err.toString());
- `, true);
- };
- after(() => {
- server.close();
- closeAllWindows();
- });
- afterEach(() => {
- session.defaultSession.setPermissionCheckHandler(null);
- session.defaultSession.setDevicePermissionHandler(null);
- session.defaultSession.removeAllListeners('select-hid-device');
- });
- it('does not return a device if select-hid-device event is not defined', async () => {
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const device = await requestDevices();
- expect(device).to.equal('');
- });
- it('does not return a device when permission denied', async () => {
- let selectFired = false;
- w.webContents.session.on('select-hid-device', (event, details, callback) => {
- selectFired = true;
- callback();
- });
- session.defaultSession.setPermissionCheckHandler(() => false);
- const device = await requestDevices();
- expect(selectFired).to.be.false();
- expect(device).to.equal('');
- });
- it('returns a device when select-hid-device event is defined', async () => {
- let haveDevices = false;
- let selectFired = false;
- w.webContents.session.on('select-hid-device', (event, details, callback) => {
- expect(details.frame).to.have.property('frameTreeNodeId').that.is.a('number');
- selectFired = true;
- if (details.deviceList.length > 0) {
- haveDevices = true;
- callback(details.deviceList[0].deviceId);
- } else {
- callback();
- }
- });
- const device = await requestDevices();
- expect(selectFired).to.be.true();
- if (haveDevices) {
- expect(device).to.contain('[object HIDDevice]');
- } else {
- expect(device).to.equal('');
- }
- if (haveDevices) {
- // Verify that navigation will clear device permissions
- const grantedDevices = await w.webContents.executeJavaScript('navigator.hid.getDevices()');
- expect(grantedDevices).to.not.be.empty();
- w.loadURL(serverUrl);
- const [,,,,, frameProcessId, frameRoutingId] = await once(w.webContents, 'did-frame-navigate');
- const frame = webFrameMain.fromId(frameProcessId, frameRoutingId);
- expect(!!frame).to.be.true();
- if (frame) {
- const grantedDevicesOnNewPage = await frame.executeJavaScript('navigator.hid.getDevices()');
- expect(grantedDevicesOnNewPage).to.be.empty();
- }
- }
- });
- it('returns a device when DevicePermissionHandler is defined', async () => {
- let haveDevices = false;
- let selectFired = false;
- let gotDevicePerms = false;
- w.webContents.session.on('select-hid-device', (event, details, callback) => {
- selectFired = true;
- if (details.deviceList.length > 0) {
- const foundDevice = details.deviceList.find((device) => {
- if (device.name && device.name !== '' && device.serialNumber && device.serialNumber !== '') {
- haveDevices = true;
- return true;
- }
- });
- if (foundDevice) {
- callback(foundDevice.deviceId);
- return;
- }
- }
- callback();
- });
- session.defaultSession.setDevicePermissionHandler(() => {
- gotDevicePerms = true;
- return true;
- });
- await w.webContents.executeJavaScript('navigator.hid.getDevices();', true);
- const device = await requestDevices();
- expect(selectFired).to.be.true();
- if (haveDevices) {
- expect(device).to.contain('[object HIDDevice]');
- expect(gotDevicePerms).to.be.true();
- } else {
- expect(device).to.equal('');
- }
- });
- it('excludes a device when a exclusionFilter is specified', async () => {
- const exclusionFilters = <any>[];
- let haveDevices = false;
- let checkForExcludedDevice = false;
- w.webContents.session.on('select-hid-device', (event, details, callback) => {
- if (details.deviceList.length > 0) {
- details.deviceList.find((device) => {
- if (device.name && device.name !== '' && device.serialNumber && device.serialNumber !== '') {
- if (checkForExcludedDevice) {
- const compareDevice = {
- vendorId: device.vendorId,
- productId: device.productId
- };
- expect(compareDevice).to.not.equal(exclusionFilters[0], 'excluded device should not be returned');
- } else {
- haveDevices = true;
- exclusionFilters.push({
- vendorId: device.vendorId,
- productId: device.productId
- });
- return true;
- }
- }
- });
- }
- callback();
- });
- await requestDevices();
- if (haveDevices) {
- // We have devices to exclude, so check if exclusionFilters work
- checkForExcludedDevice = true;
- await w.webContents.executeJavaScript(`
- navigator.hid.requestDevice({filters: [], exclusionFilters: ${JSON.stringify(exclusionFilters)}}).then(device => device.toString()).catch(err => err.toString());
- `, true);
- }
- });
- it('supports device.forget()', async () => {
- let deletedDeviceFromEvent;
- let haveDevices = false;
- w.webContents.session.on('select-hid-device', (event, details, callback) => {
- if (details.deviceList.length > 0) {
- haveDevices = true;
- callback(details.deviceList[0].deviceId);
- } else {
- callback();
- }
- });
- w.webContents.session.on('hid-device-revoked', (event, details) => {
- deletedDeviceFromEvent = details.device;
- });
- await requestDevices();
- if (haveDevices) {
- const grantedDevices = await w.webContents.executeJavaScript('navigator.hid.getDevices()');
- if (grantedDevices.length > 0) {
- const deletedDevice = await w.webContents.executeJavaScript(`
- navigator.hid.getDevices().then(devices => {
- devices[0].forget();
- return {
- vendorId: devices[0].vendorId,
- productId: devices[0].productId,
- name: devices[0].productName
- }
- })
- `);
- const grantedDevices2 = await w.webContents.executeJavaScript('navigator.hid.getDevices()');
- expect(grantedDevices2.length).to.be.lessThan(grantedDevices.length);
- if (deletedDevice.name !== '' && deletedDevice.productId && deletedDevice.vendorId) {
- expect(deletedDeviceFromEvent).to.include(deletedDevice);
- }
- }
- }
- });
- });
- describe('navigator.usb', () => {
- let w: BrowserWindow;
- let server: http.Server;
- let serverUrl: string;
- before(async () => {
- w = new BrowserWindow({
- show: false
- });
- await w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- server = http.createServer((req, res) => {
- res.setHeader('Content-Type', 'text/html');
- res.end('<body>');
- });
- serverUrl = (await listen(server)).url;
- });
- const requestDevices: any = () => {
- return w.webContents.executeJavaScript(`
- navigator.usb.requestDevice({filters: []}).then(device => device.toString()).catch(err => err.toString());
- `, true);
- };
- const notFoundError = 'NotFoundError: Failed to execute \'requestDevice\' on \'USB\': No device selected.';
- after(() => {
- server.close();
- closeAllWindows();
- });
- afterEach(() => {
- session.defaultSession.setPermissionCheckHandler(null);
- session.defaultSession.setDevicePermissionHandler(null);
- session.defaultSession.removeAllListeners('select-usb-device');
- });
- it('does not return a device if select-usb-device event is not defined', async () => {
- w.loadFile(path.join(fixturesPath, 'pages', 'blank.html'));
- const device = await requestDevices();
- expect(device).to.equal(notFoundError);
- });
- it('does not return a device when permission denied', async () => {
- let selectFired = false;
- w.webContents.session.on('select-usb-device', (event, details, callback) => {
- selectFired = true;
- callback();
- });
- session.defaultSession.setPermissionCheckHandler(() => false);
- const device = await requestDevices();
- expect(selectFired).to.be.false();
- expect(device).to.equal(notFoundError);
- });
- it('returns a device when select-usb-device event is defined', async () => {
- let haveDevices = false;
- let selectFired = false;
- w.webContents.session.on('select-usb-device', (event, details, callback) => {
- expect(details.frame).to.have.property('frameTreeNodeId').that.is.a('number');
- selectFired = true;
- if (details.deviceList.length > 0) {
- haveDevices = true;
- callback(details.deviceList[0].deviceId);
- } else {
- callback();
- }
- });
- const device = await requestDevices();
- expect(selectFired).to.be.true();
- if (haveDevices) {
- expect(device).to.contain('[object USBDevice]');
- } else {
- expect(device).to.equal(notFoundError);
- }
- if (haveDevices) {
- // Verify that navigation will clear device permissions
- const grantedDevices = await w.webContents.executeJavaScript('navigator.usb.getDevices()');
- expect(grantedDevices).to.not.be.empty();
- w.loadURL(serverUrl);
- const [,,,,, frameProcessId, frameRoutingId] = await once(w.webContents, 'did-frame-navigate');
- const frame = webFrameMain.fromId(frameProcessId, frameRoutingId);
- expect(!!frame).to.be.true();
- if (frame) {
- const grantedDevicesOnNewPage = await frame.executeJavaScript('navigator.usb.getDevices()');
- expect(grantedDevicesOnNewPage).to.be.empty();
- }
- }
- });
- it('returns a device when DevicePermissionHandler is defined', async () => {
- let haveDevices = false;
- let selectFired = false;
- let gotDevicePerms = false;
- w.webContents.session.on('select-usb-device', (event, details, callback) => {
- selectFired = true;
- if (details.deviceList.length > 0) {
- const foundDevice = details.deviceList.find((device) => {
- if (device.productName && device.productName !== '' && device.serialNumber && device.serialNumber !== '') {
- haveDevices = true;
- return true;
- }
- });
- if (foundDevice) {
- callback(foundDevice.deviceId);
- return;
- }
- }
- callback();
- });
- session.defaultSession.setDevicePermissionHandler(() => {
- gotDevicePerms = true;
- return true;
- });
- await w.webContents.executeJavaScript('navigator.usb.getDevices();', true);
- const device = await requestDevices();
- expect(selectFired).to.be.true();
- if (haveDevices) {
- expect(device).to.contain('[object USBDevice]');
- expect(gotDevicePerms).to.be.true();
- } else {
- expect(device).to.equal(notFoundError);
- }
- });
- it('supports device.forget()', async () => {
- let deletedDeviceFromEvent;
- let haveDevices = false;
- w.webContents.session.on('select-usb-device', (event, details, callback) => {
- if (details.deviceList.length > 0) {
- haveDevices = true;
- callback(details.deviceList[0].deviceId);
- } else {
- callback();
- }
- });
- w.webContents.session.on('usb-device-revoked', (event, details) => {
- deletedDeviceFromEvent = details.device;
- });
- await requestDevices();
- if (haveDevices) {
- const grantedDevices = await w.webContents.executeJavaScript('navigator.usb.getDevices()');
- if (grantedDevices.length > 0) {
- const deletedDevice: Electron.USBDevice = await w.webContents.executeJavaScript(`
- navigator.usb.getDevices().then(devices => {
- devices[0].forget();
- return {
- vendorId: devices[0].vendorId,
- productId: devices[0].productId,
- productName: devices[0].productName
- }
- })
- `);
- const grantedDevices2 = await w.webContents.executeJavaScript('navigator.usb.getDevices()');
- expect(grantedDevices2.length).to.be.lessThan(grantedDevices.length);
- if (deletedDevice.productName !== '' && deletedDevice.productId && deletedDevice.vendorId) {
- expect(deletedDeviceFromEvent).to.include(deletedDevice);
- }
- }
- }
- });
- });
|