2020-03-20 14:28:31 -06:00
|
|
|
import { expect } from 'chai';
|
2023-06-15 08:42:27 -06:00
|
|
|
import * as path from 'node:path';
|
|
|
|
import * as fs from 'node:fs';
|
2020-04-06 18:04:09 -06:00
|
|
|
import { BrowserWindow } from 'electron/main';
|
2023-01-25 14:01:25 -07:00
|
|
|
import { ifdescribe, ifit } from './lib/spec-helpers';
|
|
|
|
import { closeAllWindows } from './lib/window-helpers';
|
2023-06-15 08:42:27 -06:00
|
|
|
import * as childProcess from 'node:child_process';
|
|
|
|
import { once } from 'node:events';
|
2019-05-20 11:04:18 -06:00
|
|
|
|
2023-09-06 16:04:25 -06:00
|
|
|
const Module = require('node:module') as NodeJS.ModuleInternal;
|
2019-05-20 11:04:18 -06:00
|
|
|
|
2020-03-20 14:28:31 -06:00
|
|
|
const nativeModulesEnabled = !process.env.ELECTRON_SKIP_NATIVE_MODULE_TESTS;
|
2017-05-25 17:40:15 -06:00
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('modules support', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
const fixtures = path.join(__dirname, 'fixtures');
|
2016-02-16 18:09:41 -07:00
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('third-party module', () => {
|
2019-10-09 17:33:15 -06:00
|
|
|
ifdescribe(nativeModulesEnabled)('echo', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
afterEach(closeAllWindows);
|
2019-10-09 17:33:15 -06:00
|
|
|
it('can be required in renderer', async () => {
|
2021-03-01 14:52:29 -07:00
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
2020-03-20 14:28:31 -06:00
|
|
|
w.loadURL('about:blank');
|
2022-05-02 11:09:23 -06:00
|
|
|
await expect(
|
|
|
|
w.webContents.executeJavaScript(
|
|
|
|
"{ require('@electron-ci/echo'); null }"
|
|
|
|
)
|
|
|
|
).to.be.fulfilled();
|
2020-03-20 14:28:31 -06:00
|
|
|
});
|
2016-02-16 18:09:41 -07:00
|
|
|
|
2023-06-08 14:40:08 -06:00
|
|
|
it('can be required in node binary', async function () {
|
2020-03-20 14:28:31 -06:00
|
|
|
const child = childProcess.fork(path.join(fixtures, 'module', 'echo.js'));
|
2023-02-23 16:53:53 -07:00
|
|
|
const [msg] = await once(child, 'message');
|
2020-06-30 16:10:36 -06:00
|
|
|
expect(msg).to.equal('ok');
|
2020-03-20 14:28:31 -06:00
|
|
|
});
|
2018-10-15 18:26:34 -06:00
|
|
|
|
2019-10-09 17:33:15 -06:00
|
|
|
ifit(process.platform === 'win32')('can be required if electron.exe is renamed', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
const testExecPath = path.join(path.dirname(process.execPath), 'test.exe');
|
|
|
|
fs.copyFileSync(process.execPath, testExecPath);
|
2019-10-09 17:33:15 -06:00
|
|
|
try {
|
2020-03-20 14:28:31 -06:00
|
|
|
const fixture = path.join(fixtures, 'module', 'echo-renamed.js');
|
|
|
|
expect(fs.existsSync(fixture)).to.be.true();
|
|
|
|
const child = childProcess.spawnSync(testExecPath, [fixture]);
|
|
|
|
expect(child.status).to.equal(0);
|
2019-10-09 17:33:15 -06:00
|
|
|
} finally {
|
2020-03-20 14:28:31 -06:00
|
|
|
fs.unlinkSync(testExecPath);
|
2019-10-09 17:33:15 -06:00
|
|
|
}
|
2020-03-20 14:28:31 -06:00
|
|
|
});
|
|
|
|
});
|
2016-02-16 18:09:41 -07:00
|
|
|
|
2020-08-11 04:17:18 -06:00
|
|
|
const enablePlatforms: NodeJS.Platform[] = [
|
|
|
|
'linux',
|
|
|
|
'darwin',
|
|
|
|
'win32'
|
|
|
|
];
|
|
|
|
ifdescribe(nativeModulesEnabled && enablePlatforms.includes(process.platform))('module that use uv_dlopen', () => {
|
|
|
|
it('can be required in renderer', async () => {
|
2021-03-01 14:52:29 -07:00
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
2020-08-11 04:17:18 -06:00
|
|
|
w.loadURL('about:blank');
|
2022-05-02 11:09:23 -06:00
|
|
|
await expect(w.webContents.executeJavaScript('{ require(\'@electron-ci/uv-dlopen\'); null }')).to.be.fulfilled();
|
2020-08-11 04:17:18 -06:00
|
|
|
});
|
|
|
|
|
2023-06-08 14:40:08 -06:00
|
|
|
it('can be required in node binary', async function () {
|
2020-08-11 04:17:18 -06:00
|
|
|
const child = childProcess.fork(path.join(fixtures, 'module', 'uv-dlopen.js'));
|
2023-02-23 16:53:53 -07:00
|
|
|
const [exitCode] = await once(child, 'exit');
|
2023-02-17 02:14:00 -07:00
|
|
|
expect(exitCode).to.equal(0);
|
2020-08-11 04:17:18 -06:00
|
|
|
});
|
|
|
|
});
|
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('q', () => {
|
|
|
|
describe('Q.when', () => {
|
|
|
|
it('emits the fullfil callback', (done) => {
|
2020-03-20 14:28:31 -06:00
|
|
|
const Q = require('q');
|
2019-10-09 17:33:15 -06:00
|
|
|
Q(true).then((val: boolean) => {
|
2020-03-20 14:28:31 -06:00
|
|
|
expect(val).to.be.true();
|
|
|
|
done();
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
2017-01-10 20:29:22 -07:00
|
|
|
|
2022-10-11 00:59:23 -06:00
|
|
|
describe('require(\'electron/...\')', () => {
|
|
|
|
it('require(\'electron/lol\') should throw in the main process', () => {
|
|
|
|
expect(() => {
|
|
|
|
require('electron/lol');
|
|
|
|
}).to.throw(/Cannot find module 'electron\/lol'/);
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron/lol\') should throw in the renderer process', async () => {
|
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
|
|
|
w.loadURL('about:blank');
|
|
|
|
await expect(w.webContents.executeJavaScript('{ require(\'electron/lol\'); null }')).to.eventually.be.rejected();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron\') should not throw in the main process', () => {
|
|
|
|
expect(() => {
|
|
|
|
require('electron');
|
|
|
|
}).to.not.throw();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron\') should not throw in the renderer process', async () => {
|
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
|
|
|
w.loadURL('about:blank');
|
|
|
|
await expect(w.webContents.executeJavaScript('{ require(\'electron\'); null }')).to.be.fulfilled();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron/main\') should not throw in the main process', () => {
|
|
|
|
expect(() => {
|
|
|
|
require('electron/main');
|
|
|
|
}).to.not.throw();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron/main\') should not throw in the renderer process', async () => {
|
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
|
|
|
w.loadURL('about:blank');
|
|
|
|
await expect(w.webContents.executeJavaScript('{ require(\'electron/main\'); null }')).to.be.fulfilled();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron/renderer\') should not throw in the main process', () => {
|
|
|
|
expect(() => {
|
|
|
|
require('electron/renderer');
|
|
|
|
}).to.not.throw();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron/renderer\') should not throw in the renderer process', async () => {
|
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
|
|
|
w.loadURL('about:blank');
|
|
|
|
await expect(w.webContents.executeJavaScript('{ require(\'electron/renderer\'); null }')).to.be.fulfilled();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron/common\') should not throw in the main process', () => {
|
|
|
|
expect(() => {
|
|
|
|
require('electron/common');
|
|
|
|
}).to.not.throw();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('require(\'electron/common\') should not throw in the renderer process', async () => {
|
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
|
|
|
w.loadURL('about:blank');
|
|
|
|
await expect(w.webContents.executeJavaScript('{ require(\'electron/common\'); null }')).to.be.fulfilled();
|
|
|
|
});
|
|
|
|
});
|
|
|
|
|
2019-04-20 11:20:37 -06:00
|
|
|
describe('coffeescript', () => {
|
2017-10-27 14:45:58 -06:00
|
|
|
it('can be registered and used to require .coffee files', () => {
|
2019-05-20 11:04:18 -06:00
|
|
|
expect(() => {
|
2020-03-20 14:28:31 -06:00
|
|
|
require('coffeescript').register();
|
|
|
|
}).to.not.throw();
|
|
|
|
expect(require('./fixtures/module/test.coffee')).to.be.true();
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
2017-02-07 09:48:01 -07:00
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('global variables', () => {
|
|
|
|
describe('process', () => {
|
|
|
|
it('can be declared in a module', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
expect(require('./fixtures/module/declare-process')).to.equal('declared process');
|
|
|
|
});
|
|
|
|
});
|
2017-01-10 20:29:22 -07:00
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('global', () => {
|
|
|
|
it('can be declared in a module', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
expect(require('./fixtures/module/declare-global')).to.equal('declared global');
|
|
|
|
});
|
|
|
|
});
|
2017-02-06 16:08:08 -07:00
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('Buffer', () => {
|
|
|
|
it('can be declared in a module', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
expect(require('./fixtures/module/declare-buffer')).to.equal('declared Buffer');
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
2016-06-23 16:20:04 -06:00
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('Module._nodeModulePaths', () => {
|
|
|
|
describe('when the path is inside the resources path', () => {
|
|
|
|
it('does not include paths outside of the resources path', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
let modulePath = process.resourcesPath;
|
2019-05-20 11:04:18 -06:00
|
|
|
expect(Module._nodeModulePaths(modulePath)).to.deep.equal([
|
2017-04-20 11:48:17 -06:00
|
|
|
path.join(process.resourcesPath, 'node_modules')
|
2020-03-20 14:28:31 -06:00
|
|
|
]);
|
2017-04-20 11:48:17 -06:00
|
|
|
|
2020-03-20 14:28:31 -06:00
|
|
|
modulePath = process.resourcesPath + '-foo';
|
|
|
|
const nodeModulePaths = Module._nodeModulePaths(modulePath);
|
|
|
|
expect(nodeModulePaths).to.include(path.join(modulePath, 'node_modules'));
|
|
|
|
expect(nodeModulePaths).to.include(path.join(modulePath, '..', 'node_modules'));
|
2017-04-20 11:48:17 -06:00
|
|
|
|
2020-03-20 14:28:31 -06:00
|
|
|
modulePath = path.join(process.resourcesPath, 'foo');
|
2019-05-20 11:04:18 -06:00
|
|
|
expect(Module._nodeModulePaths(modulePath)).to.deep.equal([
|
2017-04-20 11:48:17 -06:00
|
|
|
path.join(process.resourcesPath, 'foo', 'node_modules'),
|
|
|
|
path.join(process.resourcesPath, 'node_modules')
|
2020-03-20 14:28:31 -06:00
|
|
|
]);
|
2017-04-20 11:48:17 -06:00
|
|
|
|
2020-03-20 14:28:31 -06:00
|
|
|
modulePath = path.join(process.resourcesPath, 'node_modules', 'foo');
|
2019-05-20 11:04:18 -06:00
|
|
|
expect(Module._nodeModulePaths(modulePath)).to.deep.equal([
|
2017-04-20 11:48:17 -06:00
|
|
|
path.join(process.resourcesPath, 'node_modules', 'foo', 'node_modules'),
|
|
|
|
path.join(process.resourcesPath, 'node_modules')
|
2020-03-20 14:28:31 -06:00
|
|
|
]);
|
2017-04-20 11:48:17 -06:00
|
|
|
|
2020-03-20 14:28:31 -06:00
|
|
|
modulePath = path.join(process.resourcesPath, 'node_modules', 'foo', 'bar');
|
2019-05-20 11:04:18 -06:00
|
|
|
expect(Module._nodeModulePaths(modulePath)).to.deep.equal([
|
2017-04-20 11:48:17 -06:00
|
|
|
path.join(process.resourcesPath, 'node_modules', 'foo', 'bar', 'node_modules'),
|
|
|
|
path.join(process.resourcesPath, 'node_modules', 'foo', 'node_modules'),
|
|
|
|
path.join(process.resourcesPath, 'node_modules')
|
2020-03-20 14:28:31 -06:00
|
|
|
]);
|
2017-04-20 11:48:17 -06:00
|
|
|
|
2020-03-20 14:28:31 -06:00
|
|
|
modulePath = path.join(process.resourcesPath, 'node_modules', 'foo', 'node_modules', 'bar');
|
2019-05-20 11:04:18 -06:00
|
|
|
expect(Module._nodeModulePaths(modulePath)).to.deep.equal([
|
2017-04-20 11:48:17 -06:00
|
|
|
path.join(process.resourcesPath, 'node_modules', 'foo', 'node_modules', 'bar', 'node_modules'),
|
|
|
|
path.join(process.resourcesPath, 'node_modules', 'foo', 'node_modules'),
|
|
|
|
path.join(process.resourcesPath, 'node_modules')
|
2020-03-20 14:28:31 -06:00
|
|
|
]);
|
|
|
|
});
|
|
|
|
});
|
2016-06-23 16:20:04 -06:00
|
|
|
|
2017-10-27 14:45:58 -06:00
|
|
|
describe('when the path is outside the resources path', () => {
|
|
|
|
it('includes paths outside of the resources path', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
const modulePath = path.resolve('/foo');
|
2019-05-20 11:04:18 -06:00
|
|
|
expect(Module._nodeModulePaths(modulePath)).to.deep.equal([
|
2017-04-20 11:48:17 -06:00
|
|
|
path.join(modulePath, 'node_modules'),
|
|
|
|
path.resolve('/node_modules')
|
2020-03-20 14:28:31 -06:00
|
|
|
]);
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
2017-04-03 04:46:24 -06:00
|
|
|
|
2017-04-20 11:48:17 -06:00
|
|
|
describe('require', () => {
|
|
|
|
describe('when loaded URL is not file: protocol', () => {
|
2020-03-20 14:28:31 -06:00
|
|
|
afterEach(closeAllWindows);
|
2017-04-20 11:48:17 -06:00
|
|
|
it('searches for module under app directory', async () => {
|
2021-03-01 14:52:29 -07:00
|
|
|
const w = new BrowserWindow({ show: false, webPreferences: { nodeIntegration: true, contextIsolation: false } });
|
2020-03-20 14:28:31 -06:00
|
|
|
w.loadURL('about:blank');
|
|
|
|
const result = await w.webContents.executeJavaScript('typeof require("q").when');
|
|
|
|
expect(result).to.equal('function');
|
|
|
|
});
|
|
|
|
});
|
|
|
|
});
|
2022-10-10 04:02:30 -06:00
|
|
|
|
|
|
|
describe('esm', () => {
|
|
|
|
it('can load the built-in "electron" module via ESM import', async () => {
|
|
|
|
await expect(import('electron')).to.eventually.be.ok();
|
|
|
|
});
|
|
|
|
|
|
|
|
it('the built-in "electron" module loaded via ESM import has the same exports as the CJS module', async () => {
|
|
|
|
const esmElectron = await import('electron');
|
|
|
|
const cjsElectron = require('electron');
|
|
|
|
expect(Object.keys(esmElectron)).to.deep.equal(Object.keys(cjsElectron));
|
|
|
|
});
|
|
|
|
});
|
2020-03-20 14:28:31 -06:00
|
|
|
});
|