electron/spec-main/api-remote-spec.ts
2020-06-12 14:19:20 -07:00

1034 lines
39 KiB
TypeScript

import * as path from 'path';
import { expect } from 'chai';
import { closeAllWindows } from './window-helpers';
import { ifdescribe } from './spec-helpers';
import { ipcMain, BrowserWindow } from 'electron/main';
import { emittedOnce } from './events-helpers';
import { NativeImage } from 'electron/common';
import { serialize, deserialize } from '../lib/common/type-utils';
import { nativeImage } from 'electron';
const features = process.electronBinding('features');
const expectPathsEqual = (path1: string, path2: string) => {
if (process.platform === 'win32') {
path1 = path1.toLowerCase();
path2 = path2.toLowerCase();
}
expect(path1).to.equal(path2);
};
function makeRemotely (windowGetter: () => BrowserWindow) {
async function remotely (script: Function, ...args: any[]) {
// executeJavaScript obfuscates the error if the script throws, so catch any
// errors manually.
const assembledScript = `(async function() {
try {
return { result: await Promise.resolve((${script})(...${JSON.stringify(args)})) }
} catch (e) {
return { error: e.message, stack: e.stack }
}
})()`;
const { result, error, stack } = await windowGetter().webContents.executeJavaScript(assembledScript);
if (error) {
const e = new Error(error);
e.stack = stack;
throw e;
}
return result;
}
remotely.it = (...vars: any[]) => (name: string, fn: Function) => {
it(name, async () => {
await remotely(fn, ...vars);
});
};
return remotely;
}
function makeWindow () {
let w: BrowserWindow;
before(async () => {
w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, enableRemoteModule: true } });
await w.loadURL('about:blank');
await w.webContents.executeJavaScript(`{
const chai_1 = window.chai_1 = require('chai')
chai_1.use(require('chai-as-promised'))
chai_1.use(require('dirty-chai'))
null
}`);
});
after(closeAllWindows);
return () => w;
}
function makeEachWindow () {
let w: BrowserWindow;
beforeEach(async () => {
w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, enableRemoteModule: true } });
await w.loadURL('about:blank');
await w.webContents.executeJavaScript(`{
const chai_1 = window.chai_1 = require('chai')
chai_1.use(require('chai-as-promised'))
chai_1.use(require('dirty-chai'))
null
}`);
});
afterEach(closeAllWindows);
return () => w;
}
describe('typeUtils serialization/deserialization', () => {
it('serializes and deserializes an empty NativeImage', () => {
const image = nativeImage.createEmpty();
const serializedImage = serialize(image);
const empty = deserialize(serializedImage);
expect(empty.isEmpty()).to.be.true();
expect(empty.getAspectRatio()).to.equal(1);
expect(empty.toDataURL()).to.equal('data:image/png;base64,');
expect(empty.toDataURL({ scaleFactor: 2.0 })).to.equal('data:image/png;base64,');
expect(empty.getSize()).to.deep.equal({ width: 0, height: 0 });
expect(empty.getBitmap()).to.be.empty();
expect(empty.getBitmap({ scaleFactor: 2.0 })).to.be.empty();
expect(empty.toBitmap()).to.be.empty();
expect(empty.toBitmap({ scaleFactor: 2.0 })).to.be.empty();
expect(empty.toJPEG(100)).to.be.empty();
expect(empty.toPNG()).to.be.empty();
expect(empty.toPNG({ scaleFactor: 2.0 })).to.be.empty();
});
it('serializes and deserializes a non-empty NativeImage', () => {
const dataURL = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVQYlWP8//8/AwMDEwMDAwMDAwAkBgMBBMzldwAAAABJRU5ErkJggg==';
const image = nativeImage.createFromDataURL(dataURL);
const serializedImage = serialize(image);
const nonEmpty = deserialize(serializedImage);
expect(nonEmpty.isEmpty()).to.be.false();
expect(nonEmpty.getAspectRatio()).to.equal(1);
expect(nonEmpty.toDataURL()).to.not.be.empty();
expect(nonEmpty.toDataURL({ scaleFactor: 1.0 })).to.equal(dataURL);
expect(nonEmpty.getSize()).to.deep.equal({ width: 2, height: 2 });
expect(nonEmpty.getBitmap()).to.not.be.empty();
expect(nonEmpty.toPNG()).to.not.be.empty();
});
it('serializes and deserializes a non-empty NativeImage with multiple representations', () => {
const image = nativeImage.createEmpty();
const dataURL1 = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAAC0lEQVQYlWNgAAIAAAUAAdafFs0AAAAASUVORK5CYII=';
image.addRepresentation({ scaleFactor: 1.0, dataURL: dataURL1 });
const dataURL2 = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVQYlWP8//8/AwMDEwMDAwMDAwAkBgMBBMzldwAAAABJRU5ErkJggg==';
image.addRepresentation({ scaleFactor: 2.0, dataURL: dataURL2 });
const serializedImage = serialize(image);
const nonEmpty = deserialize(serializedImage);
expect(nonEmpty.isEmpty()).to.be.false();
expect(nonEmpty.getAspectRatio()).to.equal(1);
expect(nonEmpty.getSize()).to.deep.equal({ width: 1, height: 1 });
expect(nonEmpty.getBitmap()).to.not.be.empty();
expect(nonEmpty.getBitmap({ scaleFactor: 1.0 })).to.not.be.empty();
expect(nonEmpty.getBitmap({ scaleFactor: 2.0 })).to.not.be.empty();
expect(nonEmpty.toBitmap()).to.not.be.empty();
expect(nonEmpty.toBitmap({ scaleFactor: 1.0 })).to.not.be.empty();
expect(nonEmpty.toBitmap({ scaleFactor: 2.0 })).to.not.be.empty();
expect(nonEmpty.toPNG()).to.not.be.empty();
expect(nonEmpty.toPNG({ scaleFactor: 1.0 })).to.not.be.empty();
expect(nonEmpty.toPNG({ scaleFactor: 2.0 })).to.not.be.empty();
expect(nonEmpty.toDataURL()).to.not.be.empty();
expect(nonEmpty.toDataURL({ scaleFactor: 1.0 })).to.equal(dataURL1);
expect(nonEmpty.toDataURL({ scaleFactor: 2.0 })).to.equal(dataURL2);
});
it('serializes and deserializes an Array', () => {
const array = [1, 2, 3, 4, 5];
const serialized = serialize(array);
const deserialized = deserialize(serialized);
expect(deserialized).to.deep.equal(array);
});
it('serializes and deserializes a Buffer', () => {
const buffer = Buffer.from('hello world!', 'utf-8');
const serialized = serialize(buffer);
const deserialized = deserialize(serialized);
expect(deserialized).to.deep.equal(buffer);
});
it('serializes and deserializes a Boolean', () => {
const bool = true;
const serialized = serialize(bool);
const deserialized = deserialize(serialized);
expect(deserialized).to.equal(bool);
});
it('serializes and deserializes a Date', () => {
const date = new Date();
const serialized = serialize(date);
const deserialized = deserialize(serialized);
expect(deserialized).to.equal(date);
});
it('serializes and deserializes a Number', () => {
const number = 42;
const serialized = serialize(number);
const deserialized = deserialize(serialized);
expect(deserialized).to.equal(number);
});
it('serializes and deserializes a Regexp', () => {
const regex = new RegExp('ab+c');
const serialized = serialize(regex);
const deserialized = deserialize(serialized);
expect(deserialized).to.equal(regex);
});
it('serializes and deserializes a String', () => {
const str = 'hello world';
const serialized = serialize(str);
const deserialized = deserialize(serialized);
expect(deserialized).to.equal(str);
});
it('serializes and deserializes an Error', () => {
const err = new Error('oh crap');
const serialized = serialize(err);
const deserialized = deserialize(serialized);
expect(deserialized).to.equal(err);
});
it('serializes and deserializes a simple Object', () => {
const obj = { hello: 'world', 'answer-to-everything': 42 };
const serialized = serialize(obj);
const deserialized = deserialize(serialized);
expect(deserialized).to.deep.equal(obj);
});
});
ifdescribe(features.isRemoteModuleEnabled())('remote module', () => {
const fixtures = path.join(__dirname, 'fixtures');
describe('', () => {
const w = makeWindow();
const remotely = makeRemotely(w);
describe('remote.getGlobal filtering', () => {
it('can return custom values', async () => {
w().webContents.once('remote-get-global', (event, name) => {
event.returnValue = name;
});
expect(await remotely(() => require('electron').remote.getGlobal('test'))).to.equal('test');
});
it('throws when no returnValue set', async () => {
w().webContents.once('remote-get-global', (event) => {
event.preventDefault();
});
await expect(remotely(() => require('electron').remote.getGlobal('test'))).to.eventually.be.rejected('Blocked remote.getGlobal(\'test\')');
});
});
describe('remote.getBuiltin filtering', () => {
it('can return custom values', async () => {
w().webContents.once('remote-get-builtin', (event, name) => {
event.returnValue = name;
});
expect(await remotely(() => (require('electron').remote as any).getBuiltin('test'))).to.equal('test');
});
it('throws when no returnValue set', async () => {
w().webContents.once('remote-get-builtin', (event) => {
event.preventDefault();
});
await expect(remotely(() => (require('electron').remote as any).getBuiltin('test'))).to.eventually.be.rejected('Blocked remote.getGlobal(\'test\')');
});
});
describe('remote.require filtering', () => {
it('can return custom values', async () => {
w().webContents.once('remote-require', (event, name) => {
event.returnValue = name;
});
expect(await remotely(() => require('electron').remote.require('test'))).to.equal('test');
});
it('throws when no returnValue set', async () => {
w().webContents.once('remote-require', (event) => {
event.preventDefault();
});
await expect(remotely(() => require('electron').remote.require('test'))).to.eventually.be.rejected('Blocked remote.require(\'test\')');
});
});
describe('remote.getCurrentWindow filtering', () => {
it('can return custom value', async () => {
w().webContents.once('remote-get-current-window', (e) => {
e.returnValue = 'some window';
});
expect(await remotely(() => require('electron').remote.getCurrentWindow())).to.equal('some window');
});
it('throws when no returnValue set', async () => {
w().webContents.once('remote-get-current-window', (event) => {
event.preventDefault();
});
await expect(remotely(() => require('electron').remote.getCurrentWindow())).to.eventually.be.rejected('Blocked remote.getCurrentWindow()');
});
});
describe('remote.getCurrentWebContents filtering', () => {
it('can return custom value', async () => {
w().webContents.once('remote-get-current-web-contents', (event) => {
event.returnValue = 'some web contents';
});
expect(await remotely(() => require('electron').remote.getCurrentWebContents())).to.equal('some web contents');
});
it('throws when no returnValue set', async () => {
w().webContents.once('remote-get-current-web-contents', (event) => {
event.preventDefault();
});
await expect(remotely(() => require('electron').remote.getCurrentWebContents())).to.eventually.be.rejected('Blocked remote.getCurrentWebContents()');
});
});
});
describe('remote references', () => {
const w = makeEachWindow();
it('render-view-deleted is sent when page is destroyed', (done) => {
w().webContents.once('render-view-deleted' as any, () => {
done();
});
w().destroy();
});
// The ELECTRON_BROWSER_CONTEXT_RELEASE message relies on this to work.
it('message can be sent on exit when page is being navigated', async () => {
after(() => { ipcMain.removeAllListeners('SENT_ON_EXIT'); });
w().webContents.once('did-finish-load', () => {
w().webContents.loadURL('about:blank');
});
w().loadFile(path.join(fixtures, 'api', 'send-on-exit.html'));
await emittedOnce(ipcMain, 'SENT_ON_EXIT');
});
});
describe('remote function in renderer', () => {
afterEach(() => {
ipcMain.removeAllListeners('done');
});
afterEach(closeAllWindows);
it('works when created in preload script', async () => {
const preload = path.join(fixtures, 'module', 'preload-remote-function.js');
const w = new BrowserWindow({
show: false,
webPreferences: {
preload,
enableRemoteModule: true
}
});
w.loadURL('about:blank');
await emittedOnce(ipcMain, 'done');
});
});
describe('remote objects registry', () => {
it('does not dereference until the render view is deleted (regression)', (done) => {
const w = new BrowserWindow({
show: false,
webPreferences: {
nodeIntegration: true,
enableRemoteModule: true
}
});
ipcMain.once('error-message', (event, message) => {
expect(message).to.match(/^Cannot call method 'getURL' on missing remote object/);
done();
});
w.loadFile(path.join(fixtures, 'api', 'render-view-deleted.html'));
});
});
describe('nativeImage serialization', () => {
const w = makeWindow();
const remotely = makeRemotely(w);
it('can serialize an empty nativeImage from renderer to main', async () => {
const getImageEmpty = (img: NativeImage) => img.isEmpty();
w().webContents.once('remote-get-global', (event) => {
event.returnValue = getImageEmpty;
});
await expect(remotely(() => {
const emptyImage = require('electron').nativeImage.createEmpty();
return require('electron').remote.getGlobal('someFunction')(emptyImage);
})).to.eventually.be.true();
});
it('can serialize an empty nativeImage from main to renderer', async () => {
w().webContents.once('remote-get-global', (event) => {
const emptyImage = require('electron').nativeImage.createEmpty();
event.returnValue = emptyImage;
});
await expect(remotely(() => {
const image = require('electron').remote.getGlobal('someFunction');
return image.isEmpty();
})).to.eventually.be.true();
});
it('can serialize a non-empty nativeImage from renderer to main', async () => {
const getImageSize = (img: NativeImage) => img.getSize();
w().webContents.once('remote-get-global', (event) => {
event.returnValue = getImageSize;
});
await expect(remotely(() => {
const { nativeImage } = require('electron');
const nonEmptyImage = nativeImage.createFromDataURL('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVQYlWP8//8/AwMDEwMDAwMDAwAkBgMBBMzldwAAAABJRU5ErkJggg==');
return require('electron').remote.getGlobal('someFunction')(nonEmptyImage);
})).to.eventually.deep.equal({ width: 2, height: 2 });
});
it('can serialize a non-empty nativeImage from main to renderer', async () => {
w().webContents.once('remote-get-global', (event) => {
const nonEmptyImage = nativeImage.createFromDataURL('data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAIAAAACCAIAAAD91JpzAAAAFklEQVQYlWP8//8/AwMDEwMDAwMDAwAkBgMBBMzldwAAAABJRU5ErkJggg==');
event.returnValue = nonEmptyImage;
});
await expect(remotely(() => {
const image = require('electron').remote.getGlobal('someFunction');
return image.getSize();
})).to.eventually.deep.equal({ width: 2, height: 2 });
});
it('can properly create a menu with an nativeImage icon in the renderer', async () => {
await expect(remotely(() => {
const { remote, nativeImage } = require('electron');
remote.Menu.buildFromTemplate([
{
label: 'hello',
icon: nativeImage.createEmpty()
}
]);
})).to.be.fulfilled();
});
});
describe('remote listeners', () => {
afterEach(closeAllWindows);
it('detaches listeners subscribed to destroyed renderers, and shows a warning', async () => {
const w = new BrowserWindow({
show: false,
webPreferences: {
nodeIntegration: true,
enableRemoteModule: true
}
});
await w.loadFile(path.join(fixtures, 'api', 'remote-event-handler.html'));
w.webContents.reload();
await emittedOnce(w.webContents, 'did-finish-load');
const expectedMessage = [
'Attempting to call a function in a renderer window that has been closed or released.',
'Function provided here: remote-event-handler.html:11:33',
'Remote event names: remote-handler, other-remote-handler'
].join('\n');
expect(w.webContents.listenerCount('remote-handler')).to.equal(2);
let warnMessage: string | null = null;
const originalWarn = console.warn;
let warned: Function;
const warnPromise = new Promise(resolve => {
warned = resolve;
});
try {
console.warn = (message: string) => {
warnMessage = message;
warned();
};
w.webContents.emit('remote-handler', { sender: w.webContents });
await warnPromise;
} finally {
console.warn = originalWarn;
}
expect(w.webContents.listenerCount('remote-handler')).to.equal(1);
expect(warnMessage).to.equal(expectedMessage);
});
});
describe('remote.require', () => {
const w = makeWindow();
const remotely = makeRemotely(w);
remotely.it()('should returns same object for the same module', () => {
const { remote } = require('electron');
const a = remote.require('electron');
const b = remote.require('electron');
expect(a).to.equal(b);
});
remotely.it(path.join(fixtures, 'module', 'id.js'))('should work when object contains id property', (module: string) => {
const { id } = require('electron').remote.require(module);
expect(id).to.equal(1127);
});
remotely.it(path.join(fixtures, 'module', 'no-prototype.js'))('should work when object has no prototype', (module: string) => {
const a = require('electron').remote.require(module);
expect(a.foo.bar).to.equal('baz');
expect(a.foo.baz).to.equal(false);
expect(a.bar).to.equal(1234);
expect(a.getConstructorName(Object.create(null))).to.equal('');
expect(a.getConstructorName(new (class {})())).to.equal('');
});
it('should search module from the user app', async () => {
expectPathsEqual(
path.normalize(await remotely(() => require('electron').remote.process.mainModule!.filename)),
path.resolve(__dirname, 'index.js')
);
expectPathsEqual(
path.normalize(await remotely(() => require('electron').remote.process.mainModule!.paths[0])),
path.resolve(__dirname, 'node_modules')
);
});
remotely.it(fixtures)('should work with function properties', (fixtures: string) => {
const path = require('path');
{
const a = require('electron').remote.require(path.join(fixtures, 'module', 'export-function-with-properties.js'));
expect(typeof a).to.equal('function');
expect(a.bar).to.equal('baz');
}
{
const a = require('electron').remote.require(path.join(fixtures, 'module', 'function-with-properties.js'));
expect(typeof a).to.equal('object');
expect(a.foo()).to.equal('hello');
expect(a.foo.bar).to.equal('baz');
expect(a.foo.nested.prop).to.equal('yes');
expect(a.foo.method1()).to.equal('world');
expect(a.foo.method1.prop1()).to.equal(123);
}
{
const a = require('electron').remote.require(path.join(fixtures, 'module', 'function-with-missing-properties.js')).setup();
expect(a.bar()).to.equal(true);
expect(a.bar.baz).to.be.undefined();
}
});
remotely.it(fixtures)('should work with static class members', (fixtures: string) => {
const path = require('path');
const a = require('electron').remote.require(path.join(fixtures, 'module', 'remote-static.js'));
expect(typeof a.Foo).to.equal('function');
expect(a.Foo.foo()).to.equal(3);
expect(a.Foo.bar).to.equal('baz');
expect(new a.Foo().baz()).to.equal(123);
});
remotely.it(fixtures)('includes the length of functions specified as arguments', (fixtures: string) => {
const path = require('path');
const a = require('electron').remote.require(path.join(fixtures, 'module', 'function-with-args.js'));
/* eslint-disable @typescript-eslint/no-unused-vars */
expect(a((a: any, b: any, c: any) => {})).to.equal(3);
expect(a((a: any) => {})).to.equal(1);
expect(a((...args: any[]) => {})).to.equal(0);
/* eslint-enable @typescript-eslint/no-unused-vars */
});
remotely.it(fixtures)('handles circular references in arrays and objects', (fixtures: string) => {
const path = require('path');
const a = require('electron').remote.require(path.join(fixtures, 'module', 'circular.js'));
let arrayA: any[] = ['foo'];
const arrayB = [arrayA, 'bar'];
arrayA.push(arrayB);
expect(a.returnArgs(arrayA, arrayB)).to.deep.equal([
['foo', [null, 'bar']],
[['foo', null], 'bar']
]);
let objectA: any = { foo: 'bar' };
const objectB = { baz: objectA };
objectA.objectB = objectB;
expect(a.returnArgs(objectA, objectB)).to.deep.equal([
{ foo: 'bar', objectB: { baz: null } },
{ baz: { foo: 'bar', objectB: null } }
]);
arrayA = [1, 2, 3];
expect(a.returnArgs({ foo: arrayA }, { bar: arrayA })).to.deep.equal([
{ foo: [1, 2, 3] },
{ bar: [1, 2, 3] }
]);
objectA = { foo: 'bar' };
expect(a.returnArgs({ foo: objectA }, { bar: objectA })).to.deep.equal([
{ foo: { foo: 'bar' } },
{ bar: { foo: 'bar' } }
]);
arrayA = [];
arrayA.push(arrayA);
expect(a.returnArgs(arrayA)).to.deep.equal([
[null]
]);
objectA = {};
objectA.foo = objectA;
objectA.bar = 'baz';
expect(a.returnArgs(objectA)).to.deep.equal([
{ foo: null, bar: 'baz' }
]);
objectA = {};
objectA.foo = { bar: objectA };
objectA.bar = 'baz';
expect(a.returnArgs(objectA)).to.deep.equal([
{ foo: { bar: null }, bar: 'baz' }
]);
});
});
describe('remote.createFunctionWithReturnValue', () => {
const remotely = makeRemotely(makeWindow());
remotely.it(fixtures)('should be called in browser synchronously', async (fixtures: string) => {
const { remote } = require('electron');
const path = require('path');
const buf = Buffer.from('test');
const call = remote.require(path.join(fixtures, 'module', 'call.js'));
const result = call.call((remote as any).createFunctionWithReturnValue(buf));
expect(result).to.be.an.instanceOf(Uint8Array);
});
});
describe('remote modules', () => {
const remotely = makeRemotely(makeWindow());
const mainModules = Object.keys(require('electron'));
remotely.it(mainModules)('includes browser process modules as properties', (mainModules: string[]) => {
const { remote } = require('electron');
const remoteModules = mainModules.filter(name => (remote as any)[name]);
expect(remoteModules).to.be.deep.equal(mainModules);
});
remotely.it(fixtures)('returns toString() of original function via toString()', (fixtures: string) => {
const path = require('path');
const { readText } = require('electron').remote.clipboard;
expect(readText.toString().startsWith('function')).to.be.true();
const { functionWithToStringProperty } = require('electron').remote.require(path.join(fixtures, 'module', 'to-string-non-function.js'));
expect(functionWithToStringProperty.toString).to.equal('hello');
});
});
describe('remote object in renderer', () => {
const win = makeWindow();
const remotely = makeRemotely(win);
remotely.it(fixtures)('can change its properties', (fixtures: string) => {
const module = require('path').join(fixtures, 'module', 'property.js');
const property = require('electron').remote.require(module);
expect(property.property).to.equal(1127);
property.property = null;
expect(property.property).to.equal(null);
property.property = undefined;
expect(property.property).to.equal(undefined);
property.property = 1007;
expect(property.property).to.equal(1007);
expect(property.getFunctionProperty()).to.equal('foo-browser');
property.func.property = 'bar';
expect(property.getFunctionProperty()).to.equal('bar-browser');
property.func.property = 'foo'; // revert back
const property2 = require('electron').remote.require(module);
expect(property2.property).to.equal(1007);
property.property = 1127; // revert back
});
remotely.it(fixtures)('rethrows errors getting/setting properties', (fixtures: string) => {
const foo = require('electron').remote.require(require('path').join(fixtures, 'module', 'error-properties.js'));
expect(() => {
// eslint-disable-next-line
foo.bar
}).to.throw('getting error');
expect(() => {
foo.bar = 'test';
}).to.throw('setting error');
});
remotely.it(fixtures)('can set a remote property with a remote object', (fixtures: string) => {
const { remote } = require('electron');
const foo = remote.require(require('path').join(fixtures, 'module', 'remote-object-set.js'));
foo.bar = remote.getCurrentWindow();
});
remotely.it(fixtures)('can construct an object from its member', (fixtures: string) => {
const call = require('electron').remote.require(require('path').join(fixtures, 'module', 'call.js'));
const obj = new call.constructor();
expect(obj.test).to.equal('test');
});
remotely.it(fixtures)('can reassign and delete its member functions', (fixtures: string) => {
const remoteFunctions = require('electron').remote.require(require('path').join(fixtures, 'module', 'function.js'));
expect(remoteFunctions.aFunction()).to.equal(1127);
remoteFunctions.aFunction = () => { return 1234; };
expect(remoteFunctions.aFunction()).to.equal(1234);
expect(delete remoteFunctions.aFunction).to.equal(true);
});
remotely.it('is referenced by its members', () => {
const stringify = require('electron').remote.getGlobal('JSON').stringify;
global.gc();
stringify({});
});
it('can handle objects without constructors', async () => {
win().webContents.once('remote-get-global', (event) => {
class Foo { bar () { return 'bar'; } }
Foo.prototype.constructor = undefined as any;
event.returnValue = new Foo();
});
expect(await remotely(() => require('electron').remote.getGlobal('test').bar())).to.equal('bar');
});
});
describe('remote value in browser', () => {
const remotely = makeRemotely(makeWindow());
const print = path.join(fixtures, 'module', 'print_name.js');
remotely.it(print)('preserves NaN', (print: string) => {
const printName = require('electron').remote.require(print);
expect(printName.getNaN()).to.be.NaN();
expect(printName.echo(NaN)).to.be.NaN();
});
remotely.it(print)('preserves Infinity', (print: string) => {
const printName = require('electron').remote.require(print);
expect(printName.getInfinity()).to.equal(Infinity);
expect(printName.echo(Infinity)).to.equal(Infinity);
});
remotely.it(print)('keeps its constructor name for objects', (print: string) => {
const printName = require('electron').remote.require(print);
const buf = Buffer.from('test');
expect(printName.print(buf)).to.equal('Buffer');
});
remotely.it(print)('supports instanceof Boolean', (print: string) => {
const printName = require('electron').remote.require(print);
const obj = Boolean(true);
expect(printName.print(obj)).to.equal('Boolean');
expect(printName.echo(obj)).to.deep.equal(obj);
});
remotely.it(print)('supports instanceof Number', (print: string) => {
const printName = require('electron').remote.require(print);
const obj = Number(42);
expect(printName.print(obj)).to.equal('Number');
expect(printName.echo(obj)).to.deep.equal(obj);
});
remotely.it(print)('supports instanceof String', (print: string) => {
const printName = require('electron').remote.require(print);
const obj = String('Hello World!');
expect(printName.print(obj)).to.equal('String');
expect(printName.echo(obj)).to.deep.equal(obj);
});
remotely.it(print)('supports instanceof Date', (print: string) => {
const printName = require('electron').remote.require(print);
const now = new Date();
expect(printName.print(now)).to.equal('Date');
expect(printName.echo(now)).to.deep.equal(now);
});
remotely.it(print)('supports instanceof RegExp', (print: string) => {
const printName = require('electron').remote.require(print);
const regexp = RegExp('.*');
expect(printName.print(regexp)).to.equal('RegExp');
expect(printName.echo(regexp)).to.deep.equal(regexp);
});
remotely.it(print)('supports instanceof Buffer', (print: string) => {
const printName = require('electron').remote.require(print);
const buffer = Buffer.from('test');
expect(buffer.equals(printName.echo(buffer))).to.be.true();
const objectWithBuffer = { a: 'foo', b: Buffer.from('bar') };
expect(objectWithBuffer.b.equals(printName.echo(objectWithBuffer).b)).to.be.true();
const arrayWithBuffer = [1, 2, Buffer.from('baz')];
expect((arrayWithBuffer[2] as Buffer).equals(printName.echo(arrayWithBuffer)[2])).to.be.true();
});
remotely.it(print)('supports instanceof ArrayBuffer', (print: string) => {
const printName = require('electron').remote.require(print);
const buffer = new ArrayBuffer(8);
const view = new DataView(buffer);
view.setFloat64(0, Math.PI);
expect(printName.echo(buffer)).to.deep.equal(buffer);
expect(printName.print(buffer)).to.equal('ArrayBuffer');
});
const arrayTests: [string, number[]][] = [
['Int8Array', [1, 2, 3, 4]],
['Uint8Array', [1, 2, 3, 4]],
['Uint8ClampedArray', [1, 2, 3, 4]],
['Int16Array', [0x1234, 0x2345, 0x3456, 0x4567]],
['Uint16Array', [0x1234, 0x2345, 0x3456, 0x4567]],
['Int32Array', [0x12345678, 0x23456789]],
['Uint32Array', [0x12345678, 0x23456789]],
['Float32Array', [0.5, 1.0, 1.5]],
['Float64Array', [0.5, 1.0, 1.5]]
];
arrayTests.forEach(([arrayType, values]) => {
remotely.it(print, arrayType, values)(`supports instanceof ${arrayType}`, (print: string, arrayType: string, values: number[]) => {
const printName = require('electron').remote.require(print);
expect([...printName.typedArray(arrayType, values)]).to.deep.equal(values);
const int8values = new ((window as any)[arrayType])(values);
expect(printName.typedArray(arrayType, int8values)).to.deep.equal(int8values);
expect(printName.print(int8values)).to.equal(arrayType);
});
});
describe('constructing a Uint8Array', () => {
remotely.it()('does not crash', () => {
const RUint8Array = require('electron').remote.getGlobal('Uint8Array');
new RUint8Array() // eslint-disable-line
});
});
});
describe('remote promise', () => {
const remotely = makeRemotely(makeWindow());
remotely.it(fixtures)('can be used as promise in each side', async (fixtures: string) => {
const promise = require('electron').remote.require(require('path').join(fixtures, 'module', 'promise.js'));
const value = await promise.twicePromise(Promise.resolve(1234));
expect(value).to.equal(2468);
});
remotely.it(fixtures)('handles rejections via catch(onRejected)', async (fixtures: string) => {
const promise = require('electron').remote.require(require('path').join(fixtures, 'module', 'rejected-promise.js'));
const error = await new Promise<Error>(resolve => {
promise.reject(Promise.resolve(1234)).catch(resolve);
});
expect(error.message).to.equal('rejected');
});
remotely.it(fixtures)('handles rejections via then(onFulfilled, onRejected)', async (fixtures: string) => {
const promise = require('electron').remote.require(require('path').join(fixtures, 'module', 'rejected-promise.js'));
const error = await new Promise<Error>(resolve => {
promise.reject(Promise.resolve(1234)).then(() => {}, resolve);
});
expect(error.message).to.equal('rejected');
});
it('does not emit unhandled rejection events in the main process', (done) => {
function onUnhandledRejection () {
done(new Error('Unexpected unhandledRejection event'));
}
process.once('unhandledRejection', onUnhandledRejection);
remotely(async (fixtures: string) => {
const promise = require('electron').remote.require(require('path').join(fixtures, 'module', 'unhandled-rejection.js'));
return new Promise((resolve, reject) => {
promise.reject().then(() => {
reject(new Error('Promise was not rejected'));
}).catch((error: Error) => {
resolve(error);
});
});
}, fixtures).then(error => {
try {
expect(error.message).to.equal('rejected');
done();
} catch (e) {
done(e);
} finally {
process.off('unhandledRejection', onUnhandledRejection);
}
});
});
it('emits unhandled rejection events in the renderer process', (done) => {
remotely((module: string) => new Promise((resolve, reject) => {
const promise = require('electron').remote.require(module);
window.addEventListener('unhandledrejection', function handler (event) {
event.preventDefault();
window.removeEventListener('unhandledrejection', handler);
resolve(event.reason.message);
});
promise.reject().then(() => {
reject(new Error('Promise was not rejected'));
});
}), path.join(fixtures, 'module', 'unhandled-rejection.js')).then(
(message) => {
try {
expect(message).to.equal('rejected');
done();
} catch (e) {
done(e);
}
},
done
);
});
before(() => {
(global as any).returnAPromise = (value: any) => new Promise((resolve) => setTimeout(() => resolve(value), 100));
});
after(() => {
delete (global as any).returnAPromise;
});
remotely.it()('using a promise based method resolves correctly when global Promise is overridden', async () => {
const { remote } = require('electron');
const original = global.Promise;
try {
expect(await remote.getGlobal('returnAPromise')(123)).to.equal(123);
global.Promise = { resolve: () => ({}) } as any;
expect(await remote.getGlobal('returnAPromise')(456)).to.equal(456);
} finally {
global.Promise = original;
}
});
});
describe('remote webContents', () => {
const remotely = makeRemotely(makeWindow());
it('can return same object with different getters', async () => {
const equal = await remotely(() => {
const { remote } = require('electron');
const contents1 = remote.getCurrentWindow().webContents;
const contents2 = remote.getCurrentWebContents();
return contents1 === contents2;
});
expect(equal).to.be.true();
});
});
describe('remote class', () => {
const remotely = makeRemotely(makeWindow());
remotely.it(fixtures)('can get methods', (fixtures: string) => {
const { base } = require('electron').remote.require(require('path').join(fixtures, 'module', 'class.js'));
expect(base.method()).to.equal('method');
});
remotely.it(fixtures)('can get properties', (fixtures: string) => {
const { base } = require('electron').remote.require(require('path').join(fixtures, 'module', 'class.js'));
expect(base.readonly).to.equal('readonly');
});
remotely.it(fixtures)('can change properties', (fixtures: string) => {
const { base } = require('electron').remote.require(require('path').join(fixtures, 'module', 'class.js'));
expect(base.value).to.equal('old');
base.value = 'new';
expect(base.value).to.equal('new');
base.value = 'old';
});
remotely.it(fixtures)('has unenumerable methods', (fixtures: string) => {
const { base } = require('electron').remote.require(require('path').join(fixtures, 'module', 'class.js'));
expect(base).to.not.have.ownProperty('method');
expect(Object.getPrototypeOf(base)).to.have.ownProperty('method');
});
remotely.it(fixtures)('keeps prototype chain in derived class', (fixtures: string) => {
const { derived } = require('electron').remote.require(require('path').join(fixtures, 'module', 'class.js'));
expect(derived.method()).to.equal('method');
expect(derived.readonly).to.equal('readonly');
expect(derived).to.not.have.ownProperty('method');
const proto = Object.getPrototypeOf(derived);
expect(proto).to.not.have.ownProperty('method');
expect(Object.getPrototypeOf(proto)).to.have.ownProperty('method');
});
remotely.it(fixtures)('is referenced by methods in prototype chain', (fixtures: string) => {
let { derived } = require('electron').remote.require(require('path').join(fixtures, 'module', 'class.js'));
const method = derived.method;
derived = null;
global.gc();
expect(method()).to.equal('method');
});
});
describe('remote exception', () => {
const remotely = makeRemotely(makeWindow());
remotely.it(fixtures)('throws errors from the main process', (fixtures: string) => {
const throwFunction = require('electron').remote.require(require('path').join(fixtures, 'module', 'exception.js'));
expect(() => {
throwFunction();
}).to.throw(/undefined/);
});
remotely.it(fixtures)('tracks error cause', (fixtures: string) => {
const throwFunction = require('electron').remote.require(require('path').join(fixtures, 'module', 'exception.js'));
try {
throwFunction(new Error('error from main'));
expect.fail();
} catch (e) {
expect(e.message).to.match(/Could not call remote function/);
expect(e.cause.message).to.equal('error from main');
}
});
});
describe('gc behavior', () => {
const win = makeWindow();
const remotely = makeRemotely(win);
it('is resilient to gc happening between request and response', async () => {
const obj = { x: 'y' };
win().webContents.on('remote-get-global', (event) => {
event.returnValue = obj;
});
await remotely(() => {
const { ipc } = process.electronBinding('ipc');
const originalSendSync = ipc.sendSync.bind(ipc) as any;
ipc.sendSync = (...args: any[]): any => {
const ret = originalSendSync(...args);
(window as any).gc();
return ret;
};
for (let i = 0; i < 100; i++) {
// eslint-disable-next-line
require('electron').remote.getGlobal('test').x;
}
});
});
});
});