1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309 |
- const assert = require('assert')
- const http = require('http')
- const path = require('path')
- const qs = require('querystring')
- const { closeWindow } = require('./window-helpers')
- const { remote } = require('electron')
- const { BrowserWindow, ipcMain, protocol, session, webContents } = remote
- // The RPC API doesn't seem to support calling methods on remote objects very
- // well. In order to test stream protocol, we must work around this limitation
- // and use Stream instances created in the browser process.
- const stream = remote.require('stream')
- /* The whole protocol API doesn't use standard callbacks */
- /* eslint-disable standard/no-callback-literal */
- describe('protocol module', () => {
- const protocolName = 'sp'
- const text = 'valar morghulis'
- const postData = {
- name: 'post test',
- type: 'string'
- }
- function delay (ms) {
- return new Promise((resolve) => {
- setTimeout(resolve, ms)
- })
- }
- function getStream (chunkSize = text.length, data = text) {
- const body = stream.PassThrough()
- async function sendChunks () {
- let buf = Buffer.from(data)
- for (;;) {
- body.push(buf.slice(0, chunkSize))
- buf = buf.slice(chunkSize)
- if (!buf.length) {
- break
- }
- // emulate network delay
- await delay(50)
- }
- body.push(null)
- }
- sendChunks()
- return body
- }
- afterEach((done) => {
- protocol.unregisterProtocol(protocolName, () => {
- protocol.uninterceptProtocol('http', () => done())
- })
- })
- describe('protocol.register(Any)Protocol', () => {
- const emptyHandler = (request, callback) => callback()
- it('throws error when scheme is already registered', (done) => {
- protocol.registerStringProtocol(protocolName, emptyHandler, (error) => {
- assert.strictEqual(error, null)
- protocol.registerBufferProtocol(protocolName, emptyHandler, (error) => {
- assert.notStrictEqual(error, null)
- done()
- })
- })
- })
- it('does not crash when handler is called twice', (done) => {
- const doubleHandler = (request, callback) => {
- try {
- callback(text)
- callback()
- } catch (error) {
- // Ignore error
- }
- }
- protocol.registerStringProtocol(protocolName, doubleHandler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sends error when callback is called with nothing', (done) => {
- protocol.registerBufferProtocol(protocolName, emptyHandler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- return done()
- }
- })
- })
- })
- it('does not crash when callback is called in next tick', (done) => {
- const handler = (request, callback) => {
- setImmediate(() => callback(text))
- }
- protocol.registerStringProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- })
- describe('protocol.unregisterProtocol', () => {
- it('returns error when scheme does not exist', (done) => {
- protocol.unregisterProtocol('not-exist', (error) => {
- assert.notStrictEqual(error, null)
- done()
- })
- })
- })
- describe('protocol.registerStringProtocol', () => {
- it('sends string as response', (done) => {
- const handler = (request, callback) => callback(text)
- protocol.registerStringProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sets Access-Control-Allow-Origin', (done) => {
- const handler = (request, callback) => callback(text)
- protocol.registerStringProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, status, request) => {
- assert.strictEqual(data, text)
- assert.strictEqual(request.getResponseHeader('Access-Control-Allow-Origin'), '*')
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sends object as response', (done) => {
- const handler = (request, callback) => {
- callback({
- data: text,
- mimeType: 'text/html'
- })
- }
- protocol.registerStringProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('fails when sending object other than string', (done) => {
- const handler = (request, callback) => callback(new Date())
- protocol.registerBufferProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- done()
- }
- })
- })
- })
- })
- describe('protocol.registerBufferProtocol', () => {
- const buffer = Buffer.from(text)
- it('sends Buffer as response', (done) => {
- const handler = (request, callback) => callback(buffer)
- protocol.registerBufferProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sets Access-Control-Allow-Origin', (done) => {
- const handler = (request, callback) => callback(buffer)
- protocol.registerBufferProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, status, request) => {
- assert.strictEqual(data, text)
- assert.strictEqual(request.getResponseHeader('Access-Control-Allow-Origin'), '*')
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sends object as response', (done) => {
- const handler = (request, callback) => {
- callback({
- data: buffer,
- mimeType: 'text/html'
- })
- }
- protocol.registerBufferProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('fails when sending string', (done) => {
- const handler = (request, callback) => callback(text)
- protocol.registerBufferProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- done()
- }
- })
- })
- })
- })
- describe('protocol.registerFileProtocol', () => {
- const filePath = path.join(__dirname, 'fixtures', 'test.asar', 'a.asar', 'file1')
- const fileContent = require('fs').readFileSync(filePath)
- const normalPath = path.join(__dirname, 'fixtures', 'pages', 'a.html')
- const normalContent = require('fs').readFileSync(normalPath)
- it('sends file path as response', (done) => {
- const handler = (request, callback) => callback(filePath)
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, String(fileContent))
- return done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sets Access-Control-Allow-Origin', (done) => {
- const handler = (request, callback) => callback(filePath)
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, status, request) => {
- assert.strictEqual(data, String(fileContent))
- assert.strictEqual(request.getResponseHeader('Access-Control-Allow-Origin'), '*')
- done()
- },
- error: (xhr, errorType, error) => {
- done(error)
- }
- })
- })
- })
- it('sets custom headers', (done) => {
- const handler = (request, callback) => callback({
- path: filePath,
- headers: { 'X-Great-Header': 'sogreat' }
- })
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, status, request) => {
- assert.strictEqual(data, String(fileContent))
- assert.strictEqual(request.getResponseHeader('X-Great-Header'), 'sogreat')
- done()
- },
- error: (xhr, errorType, error) => {
- done(error)
- }
- })
- })
- })
- it('throws an error when custom headers are invalid', (done) => {
- const handler = (request, callback) => {
- assert.throws(() => callback({
- path: filePath,
- headers: { 'X-Great-Header': 42 }
- }), /Value of 'X-Great-Header' header has to be a string/)
- done()
- }
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sends object as response', (done) => {
- const handler = (request, callback) => callback({ path: filePath })
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, String(fileContent))
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('can send normal file', (done) => {
- const handler = (request, callback) => callback(normalPath)
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, String(normalContent))
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('fails when sending unexist-file', (done) => {
- const fakeFilePath = path.join(__dirname, 'fixtures', 'test.asar', 'a.asar', 'not-exist')
- const handler = (request, callback) => callback(fakeFilePath)
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- done()
- }
- })
- })
- })
- it('fails when sending unsupported content', (done) => {
- const handler = (request, callback) => callback(new Date())
- protocol.registerFileProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- done()
- }
- })
- })
- })
- })
- describe('protocol.registerHttpProtocol', () => {
- it('sends url as response', (done) => {
- const server = http.createServer((req, res) => {
- assert.notStrictEqual(req.headers.accept, '')
- res.end(text)
- server.close()
- })
- server.listen(0, '127.0.0.1', () => {
- const port = server.address().port
- const url = 'http://127.0.0.1:' + port
- const handler = (request, callback) => callback({ url })
- protocol.registerHttpProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- })
- it('fails when sending invalid url', (done) => {
- const handler = (request, callback) => callback({ url: 'url' })
- protocol.registerHttpProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- done()
- }
- })
- })
- })
- it('fails when sending unsupported content', (done) => {
- const handler = (request, callback) => callback(new Date())
- protocol.registerHttpProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: () => {
- done('request succeeded but it should not')
- },
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- done()
- }
- })
- })
- })
- it('works when target URL redirects', (done) => {
- let contents = null
- const server = http.createServer((req, res) => {
- if (req.url === '/serverRedirect') {
- res.statusCode = 301
- res.setHeader('Location', `http://${req.rawHeaders[1]}`)
- res.end()
- } else {
- res.end(text)
- }
- })
- server.listen(0, '127.0.0.1', () => {
- const port = server.address().port
- const url = `${protocolName}://fake-host`
- const redirectURL = `http://127.0.0.1:${port}/serverRedirect`
- const handler = (request, callback) => callback({ url: redirectURL })
- protocol.registerHttpProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- contents = webContents.create({})
- contents.on('did-finish-load', () => {
- assert.strictEqual(contents.getURL(), url)
- server.close()
- contents.destroy()
- done()
- })
- contents.loadURL(url)
- })
- })
- })
- it('can access request headers', (done) => {
- const handler = (request) => {
- assert.ok('headers' in request)
- done()
- }
- protocol.registerHttpProtocol(protocolName, handler, () => {
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false
- })
- })
- })
- })
- describe('protocol.registerStreamProtocol', () => {
- it('sends Stream as response', (done) => {
- const handler = (request, callback) => callback(getStream())
- protocol.registerStreamProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('sends object as response', (done) => {
- const handler = (request, callback) => callback({ data: getStream() })
- protocol.registerStreamProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, _, request) => {
- assert.strictEqual(request.status, 200)
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('sends custom response headers', (done) => {
- const handler = (request, callback) => callback({
- data: getStream(3),
- headers: {
- 'x-electron': ['a', 'b']
- }
- })
- protocol.registerStreamProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, _, request) => {
- assert.strictEqual(request.status, 200)
- assert.strictEqual(request.getResponseHeader('x-electron'), 'a, b')
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('sends custom status code', (done) => {
- const handler = (request, callback) => callback({
- statusCode: 204,
- data: null
- })
- protocol.registerStreamProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, _, request) => {
- assert.strictEqual(request.status, 204)
- assert.strictEqual(data, undefined)
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('receives request headers', (done) => {
- const handler = (request, callback) => {
- callback({
- headers: {
- 'content-type': 'application/json'
- },
- data: getStream(5, JSON.stringify(Object.assign({}, request.headers)))
- })
- }
- protocol.registerStreamProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- headers: {
- 'x-return-headers': 'yes'
- },
- cache: false,
- success: (data) => {
- assert.strictEqual(data['x-return-headers'], 'yes')
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('returns response multiple response headers with the same name', (done) => {
- const handler = (request, callback) => {
- callback({
- headers: {
- 'header1': ['value1', 'value2'],
- 'header2': 'value3'
- },
- data: getStream()
- })
- }
- protocol.registerStreamProtocol(protocolName, handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: (data, status, request) => {
- // SUBTLE: when the response headers have multiple values it
- // separates values by ", ". When the response headers are incorrectly
- // converting an array to a string it separates values by ",".
- assert.strictEqual(request.getAllResponseHeaders(), 'header1: value1, value2\r\nheader2: value3\r\n')
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('can handle large responses', async () => {
- const data = Buffer.alloc(128 * 1024)
- const handler = (request, callback) => {
- callback(getStream(data.length, data))
- }
- await new Promise((resolve, reject) => {
- protocol.registerStreamProtocol(protocolName, handler, err => {
- if (err) return reject(err)
- resolve()
- })
- })
- const r = await new Promise((resolve, reject) => {
- $.ajax({
- url: protocolName + '://fake-host',
- cache: false,
- success: resolve,
- error: (xhr, errorType, error) => {
- reject(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- assert.strictEqual(r.length, data.length)
- })
- })
- describe('protocol.isProtocolHandled', () => {
- it('returns true for about:', async () => {
- const result = await protocol.isProtocolHandled('about')
- assert.strictEqual(result, true)
- })
- // TODO(codebytere): remove when promisification is complete
- it('returns true for about: (callback)', (done) => {
- protocol.isProtocolHandled('about', (result) => {
- assert.strictEqual(result, true)
- done()
- })
- })
- it('returns true for file:', async () => {
- const result = await protocol.isProtocolHandled('file')
- assert.strictEqual(result, true)
- })
- // TODO(codebytere): remove when promisification is complete
- it('returns true for file: (callback)', (done) => {
- protocol.isProtocolHandled('file', (result) => {
- assert.strictEqual(result, true)
- done()
- })
- })
- it('returns true for http:', async () => {
- const result = await protocol.isProtocolHandled('http')
- assert.strictEqual(result, true)
- })
- it('returns true for https:', async () => {
- const result = await protocol.isProtocolHandled('https')
- assert.strictEqual(result, true)
- })
- it('returns false when scheme is not registered', async () => {
- const result = await protocol.isProtocolHandled('no-exist')
- assert.strictEqual(result, false)
- })
- it('returns true for custom protocol', (done) => {
- const emptyHandler = (request, callback) => callback()
- protocol.registerStringProtocol(protocolName, emptyHandler, async (error) => {
- assert.strictEqual(error, null)
- const result = await protocol.isProtocolHandled(protocolName)
- assert.strictEqual(result, true)
- done()
- })
- })
- // TODO(codebytere): remove when promisification is complete
- it('returns true for custom protocol (callback)', (done) => {
- const emptyHandler = (request, callback) => callback()
- protocol.registerStringProtocol(protocolName, emptyHandler, (error) => {
- assert.strictEqual(error, null)
- protocol.isProtocolHandled(protocolName, (result) => {
- assert.strictEqual(result, true)
- done()
- })
- })
- })
- it('returns true for intercepted protocol', (done) => {
- const emptyHandler = (request, callback) => callback()
- protocol.interceptStringProtocol('http', emptyHandler, async (error) => {
- assert.strictEqual(error, null)
- const result = await protocol.isProtocolHandled('http')
- assert.strictEqual(result, true)
- done()
- })
- })
- // TODO(codebytere): remove when promisification is complete
- it('returns true for intercepted protocol (callback)', (done) => {
- const emptyHandler = (request, callback) => callback()
- protocol.interceptStringProtocol('http', emptyHandler, (error) => {
- assert.strictEqual(error, null)
- protocol.isProtocolHandled('http', (result) => {
- assert.strictEqual(result, true)
- done()
- })
- })
- })
- })
- describe('protocol.intercept(Any)Protocol', () => {
- const emptyHandler = (request, callback) => callback()
- it('throws error when scheme is already intercepted', (done) => {
- protocol.interceptStringProtocol('http', emptyHandler, (error) => {
- assert.strictEqual(error, null)
- protocol.interceptBufferProtocol('http', emptyHandler, (error) => {
- assert.notStrictEqual(error, null)
- done()
- })
- })
- })
- it('does not crash when handler is called twice', (done) => {
- const doubleHandler = (request, callback) => {
- try {
- callback(text)
- callback()
- } catch (error) {
- // Ignore error
- }
- }
- protocol.interceptStringProtocol('http', doubleHandler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('sends error when callback is called with nothing', function (done) {
- protocol.interceptBufferProtocol('http', emptyHandler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- success: () => done('request succeeded but it should not'),
- error: (xhr, errorType) => {
- assert.strictEqual(errorType, 'error')
- done()
- }
- })
- })
- })
- })
- describe('protocol.interceptStringProtocol', () => {
- it('can intercept http protocol', (done) => {
- const handler = (request, callback) => callback(text)
- protocol.interceptStringProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('can set content-type', (done) => {
- const handler = (request, callback) => {
- callback({
- mimeType: 'application/json',
- data: '{"value": 1}'
- })
- }
- protocol.interceptStringProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(typeof data, 'object')
- assert.strictEqual(data.value, 1)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('can receive post data', (done) => {
- const handler = (request, callback) => {
- const uploadData = request.uploadData[0].bytes.toString()
- callback({ data: uploadData })
- }
- protocol.interceptStringProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- type: 'POST',
- data: postData,
- success: (data) => {
- assert.deepStrictEqual({ ...qs.parse(data) }, postData)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- })
- describe('protocol.interceptBufferProtocol', () => {
- it('can intercept http protocol', (done) => {
- const handler = (request, callback) => callback(Buffer.from(text))
- protocol.interceptBufferProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- it('can receive post data', (done) => {
- const handler = (request, callback) => {
- const uploadData = request.uploadData[0].bytes
- callback(uploadData)
- }
- protocol.interceptBufferProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- type: 'POST',
- data: postData,
- success: (data) => {
- assert.strictEqual(data, $.param(postData))
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- })
- describe('protocol.interceptHttpProtocol', () => {
- it('can send POST request', (done) => {
- const server = http.createServer((req, res) => {
- let body = ''
- req.on('data', (chunk) => {
- body += chunk
- })
- req.on('end', () => {
- res.end(body)
- })
- server.close()
- })
- server.listen(0, '127.0.0.1', () => {
- const port = server.address().port
- const url = `http://127.0.0.1:${port}`
- const handler = (request, callback) => {
- const data = {
- url: url,
- method: 'POST',
- uploadData: {
- contentType: 'application/x-www-form-urlencoded',
- data: request.uploadData[0].bytes.toString()
- },
- session: null
- }
- callback(data)
- }
- protocol.interceptHttpProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- type: 'POST',
- data: postData,
- success: (data) => {
- assert.deepStrictEqual({ ...qs.parse(data) }, postData)
- done()
- },
- error: (xhr, errorType, error) => done(error)
- })
- })
- })
- })
- it('can use custom session', (done) => {
- const customSession = session.fromPartition('custom-ses', { cache: false })
- customSession.webRequest.onBeforeRequest((details, callback) => {
- assert.strictEqual(details.url, 'http://fake-host/')
- callback({ cancel: true })
- })
- const handler = (request, callback) => {
- callback({
- url: request.url,
- session: customSession
- })
- }
- protocol.interceptHttpProtocol('http', handler, (error) => {
- if (error) return done(error)
- fetch('http://fake-host').then(() => {
- done('request succeeded but it should not')
- }).catch(() => {
- customSession.webRequest.onBeforeRequest(null)
- done()
- })
- })
- })
- it('can access request headers', (done) => {
- const handler = (request) => {
- assert.ok('headers' in request)
- done()
- }
- protocol.interceptHttpProtocol('http', handler, () => {
- fetch('http://fake-host')
- })
- })
- })
- describe('protocol.interceptStreamProtocol', () => {
- it('can intercept http protocol', (done) => {
- const handler = (request, callback) => callback(getStream())
- protocol.interceptStreamProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, text)
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('can receive post data', (done) => {
- const handler = (request, callback) => {
- callback(getStream(3, request.uploadData[0].bytes.toString()))
- }
- protocol.interceptStreamProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- type: 'POST',
- data: postData,
- success: (data) => {
- assert.deepStrictEqual({ ...qs.parse(data) }, postData)
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- it('can execute redirects', (done) => {
- const handler = (request, callback) => {
- if (request.url.indexOf('http://fake-host') === 0) {
- setTimeout(() => {
- callback({
- data: null,
- statusCode: 302,
- headers: {
- Location: 'http://fake-redirect'
- }
- })
- }, 300)
- } else {
- assert.strictEqual(request.url.indexOf('http://fake-redirect'), 0)
- callback(getStream(1, 'redirect'))
- }
- }
- protocol.interceptStreamProtocol('http', handler, (error) => {
- if (error) return done(error)
- $.ajax({
- url: 'http://fake-host',
- cache: false,
- success: (data) => {
- assert.strictEqual(data, 'redirect')
- done()
- },
- error: (xhr, errorType, error) => {
- done(error || new Error(`Request failed: ${xhr.status}`))
- }
- })
- })
- })
- })
- describe('protocol.uninterceptProtocol', () => {
- it('returns error when scheme does not exist', (done) => {
- protocol.uninterceptProtocol('not-exist', (error) => {
- assert.notStrictEqual(error, null)
- done()
- })
- })
- it('returns error when scheme is not intercepted', (done) => {
- protocol.uninterceptProtocol('http', (error) => {
- assert.notStrictEqual(error, null)
- done()
- })
- })
- })
- describe('protocol.registerSchemesAsPrivileged standard', () => {
- const standardScheme = remote.getGlobal('standardScheme')
- const origin = `${standardScheme}://fake-host`
- const imageURL = `${origin}/test.png`
- const filePath = path.join(__dirname, 'fixtures', 'pages', 'b.html')
- const fileContent = '<img src="/test.png" />'
- let w = null
- let success = null
- beforeEach(() => {
- w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true
- }
- })
- success = false
- })
- afterEach((done) => {
- protocol.unregisterProtocol(standardScheme, () => {
- closeWindow(w).then(() => {
- w = null
- done()
- })
- })
- })
- it('resolves relative resources', (done) => {
- const handler = (request, callback) => {
- if (request.url === imageURL) {
- success = true
- callback()
- } else {
- callback(filePath)
- }
- }
- protocol.registerFileProtocol(standardScheme, handler, (error) => {
- if (error) return done(error)
- w.webContents.on('did-finish-load', () => {
- assert(success)
- done()
- })
- w.loadURL(origin)
- })
- })
- it('resolves absolute resources', (done) => {
- const handler = (request, callback) => {
- if (request.url === imageURL) {
- success = true
- callback()
- } else {
- callback({
- data: fileContent,
- mimeType: 'text/html'
- })
- }
- }
- protocol.registerStringProtocol(standardScheme, handler, (error) => {
- if (error) return done(error)
- w.webContents.on('did-finish-load', () => {
- assert(success)
- done()
- })
- w.loadURL(origin)
- })
- })
- it('can have fetch working in it', (done) => {
- const content = '<html><script>fetch("http://github.com")</script></html>'
- const handler = (request, callback) => callback({ data: content, mimeType: 'text/html' })
- protocol.registerStringProtocol(standardScheme, handler, (error) => {
- if (error) return done(error)
- w.webContents.on('crashed', () => done('WebContents crashed'))
- w.webContents.on('did-finish-load', () => done())
- w.loadURL(origin)
- })
- })
- it('can access files through the FileSystem API', (done) => {
- const filePath = path.join(__dirname, 'fixtures', 'pages', 'filesystem.html')
- const handler = (request, callback) => callback({ path: filePath })
- protocol.registerFileProtocol(standardScheme, handler, (error) => {
- if (error) return done(error)
- w.loadURL(origin)
- })
- ipcMain.once('file-system-error', (event, err) => done(err))
- ipcMain.once('file-system-write-end', () => done())
- })
- it('registers secure, when {secure: true}', (done) => {
- const filePath = path.join(__dirname, 'fixtures', 'pages', 'cache-storage.html')
- const handler = (request, callback) => callback({ path: filePath })
- ipcMain.once('success', () => done())
- ipcMain.once('failure', (event, err) => done(err))
- protocol.registerFileProtocol(standardScheme, handler, (error) => {
- if (error) return done(error)
- w.loadURL(origin)
- })
- })
- })
- describe('protocol.registerSchemesAsPrivileged cors-fetch', function () {
- const standardScheme = remote.getGlobal('standardScheme')
- const fixtures = path.resolve(__dirname, 'fixtures')
- let w = null
- beforeEach((done) => {
- protocol.unregisterProtocol(standardScheme, () => done())
- })
- afterEach((done) => {
- closeWindow(w).then(() => {
- w = null
- done()
- })
- })
- it('supports fetch api by default', (done) => {
- const url = 'file://' + fixtures + '/assets/logo.png'
- window.fetch(url)
- .then(function (response) {
- assert(response.ok)
- done()
- })
- .catch(function (err) {
- done('unexpected error : ' + err)
- })
- })
- it('allows CORS requests by default', (done) => {
- allowsCORSRequests('cors', 200, `<html>
- <script>
- const {ipcRenderer} = require('electron')
- fetch('cors://myhost').then(function (response) {
- ipcRenderer.send('response', response.status)
- }).catch(function (response) {
- ipcRenderer.send('response', 'failed')
- })
- </script>
- </html>`, done)
- })
- it('disallows CORS, but allows fetch requests, when specified', (done) => {
- allowsCORSRequests('no-cors', 'failed', `<html>
- <script>
- const {ipcRenderer} = require('electron')
- fetch('no-cors://myhost').then(function (response) {
- ipcRenderer.send('response', response.status)
- }).catch(function (response) {
- ipcRenderer.send('response', 'failed')
- })
- </script>
- </html>`, done)
- })
- it('allows CORS, but disallows fetch requests, when specified', (done) => {
- allowsCORSRequests('no-fetch', 'failed', `<html>
- <script>
- const {ipcRenderer} = require('electron')
- fetch('no-fetch://myhost').then(function
- (response) {
- ipcRenderer.send('response', response.status)
- }).catch(function (response) {
- ipcRenderer.send('response', 'failed')
- })
- </script>
- </html>`, done)
- })
- function allowsCORSRequests (corsScheme, expected, content, done) {
- const url = standardScheme + '://fake-host'
- w = new BrowserWindow({
- show: false,
- webPreferences: {
- nodeIntegration: true
- }
- })
- const handler = (request, callback) => {
- callback({ data: content, mimeType: 'text/html' })
- }
- protocol.registerStringProtocol(standardScheme, handler, (error) => {
- if (error) { return done(error) }
- })
- protocol.registerStringProtocol(corsScheme,
- (request, callback) => {
- callback('')
- }, (error) => {
- if (error) { return done(error) }
- ipcMain.once('response', function (event, status) {
- assert.strictEqual(status, expected)
- protocol.unregisterProtocol(corsScheme, () => done())
- })
- w.loadURL(url)
- })
- }
- })
- })
|