electron/spec-main/api-remote-spec.ts

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._linkedBinding('electron_common_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', 'remote');

  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, '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, '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)', async () => {
      const w = new BrowserWindow({
        show: false,
        webPreferences: {
          nodeIntegration: true,
          enableRemoteModule: true
        }
      });

      const message = emittedOnce(ipcMain, 'error-message');
      w.loadFile(path.join(fixtures, 'render-view-deleted.html'));
      const [, msg] = await message;
      expect(msg).to.match(/^Cannot call method 'getURL' on missing remote object/);
    });
  });

  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, '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, '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, '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(() => {
          const { remote } = require('electron');
          return (remote as any).process.mainModule.filename;
        })),
        path.resolve(__dirname, 'index.js')
      );
      expectPathsEqual(
        path.normalize(await remotely(() => {
          const { remote } = require('electron');
          return (remote as any).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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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, '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._linkedBinding('electron_renderer_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;
        }
      });
    });
  });
});