electron/lib/renderer/init.ts

196 lines
7.1 KiB
TypeScript
Raw Normal View History

2020-03-20 20:28:31 +00:00
import * as path from 'path';
2016-01-13 03:55:49 +00:00
2020-03-20 20:28:31 +00:00
const Module = require('module');
2016-01-12 02:40:23 +00:00
// Make sure globals like "process" and "global" are always available in preload
// scripts even after they are deleted in "loaded" script.
//
// Note 1: We rely on a Node patch to actually pass "process" and "global" and
// other arguments to the wrapper.
//
// Note 2: Node introduced a new code path to use native code to wrap module
// code, which does not work with this hack. However by modifying the
// "Module.wrapper" we can force Node to use the old code path to wrap module
// code with JavaScript.
2019-06-02 20:03:03 +00:00
//
2019-06-20 15:11:38 +00:00
// Note 3: We provide the equivalent extra variables internally through the
2019-06-02 20:03:03 +00:00
// webpack ProvidePlugin in webpack.config.base.js. If you add any extra
// variables to this wrapper please ensure to update that plugin as well.
Module.wrapper = [
'(function (exports, require, module, __filename, __dirname, process, global, Buffer) { ' +
// By running the code in a new closure, it would be possible for the module
// code to override "process" and "Buffer" with local variables.
'return function (exports, require, module, __filename, __dirname) { ',
'\n}.call(this, exports, require, module, __filename, __dirname); });'
2020-03-20 20:28:31 +00:00
];
2016-01-14 19:10:12 +00:00
// We modified the original process.argv to let node.js load the
// init.js, we need to restore it here.
2020-03-20 20:28:31 +00:00
process.argv.splice(1, 1);
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Clear search paths.
2020-03-20 20:28:31 +00:00
require('../common/reset-search-paths');
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Import common settings.
2020-03-20 20:28:31 +00:00
require('@electron/internal/common/init');
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// The global variable will be used by ipc for event dispatching
const v8Util = process._linkedBinding('electron_common_v8_util');
2016-01-12 02:40:23 +00:00
2020-06-02 09:33:06 +00:00
const { ipcRendererInternal } = require('@electron/internal/renderer/ipc-renderer-internal');
const ipcRenderer = require('@electron/internal/renderer/api/ipc-renderer').default;
refactor: use mojo for electron internal IPC (#17406) * refactor: use mojo for electron internal IPC * add sender_id, drop MessageSync * remove usages of AtomFrameMsg_Message * iwyu * first draft of renderer->browser direction * refactor to reuse a single ipc interface * implement TakeHeapSnapshot through mojo * the rest of the owl^WtakeHeapSnapshot mojofication * remove no-op overrides in AtomRendererClient * delete renderer-side ElectronApiServiceImpl when its pipe is destroyed * looks like we don't need to overlay the renderer manifest after all * don't try to send 2 replies to a sync rpc * undo changes to manifests.cc * unify sandboxed + unsandboxed ipc events * lint * register ElectronBrowser mojo service on devtools WebContents * fix takeHeapSnapshopt failure paths * {electron_api => atom}::mojom * add send_to_all to ElectronRenderer::Message * keep interface alive until callback is called * review comments * use GetContext from RendererClientBase * robustify a test that uses window.open * MessageSync posts a task to put sync messages in the same queue as async ones * add v8::MicrotasksScope and node::CallbackScope * iwyu * use weakptr to api::WebContents instead of Unretained * make MessageSync an asynchronous message & use non-associated interface * iwyu + comments * remove unused WeakPtrFactory * inline OnRendererMessage[Sync] * cleanups & comments * use helper methods instead of inline lambdas * remove unneeded async in test * add mojo to manifests deps * add gn check for //electron/manifests and mojo * don't register renderer side service until preload has been run * update gn check targets list * move interface registration back to RenderFrameCreated
2019-04-02 22:38:16 +00:00
v8Util.setHiddenValue(global, 'ipcNative', {
onMessage (internal: boolean, channel: string, ports: any[], args: any[], senderId: number) {
2020-06-02 09:33:06 +00:00
const sender = internal ? ipcRendererInternal : ipcRenderer;
2020-03-20 20:28:31 +00:00
sender.emit(channel, { sender, senderId, ports }, ...args);
refactor: use mojo for electron internal IPC (#17406) * refactor: use mojo for electron internal IPC * add sender_id, drop MessageSync * remove usages of AtomFrameMsg_Message * iwyu * first draft of renderer->browser direction * refactor to reuse a single ipc interface * implement TakeHeapSnapshot through mojo * the rest of the owl^WtakeHeapSnapshot mojofication * remove no-op overrides in AtomRendererClient * delete renderer-side ElectronApiServiceImpl when its pipe is destroyed * looks like we don't need to overlay the renderer manifest after all * don't try to send 2 replies to a sync rpc * undo changes to manifests.cc * unify sandboxed + unsandboxed ipc events * lint * register ElectronBrowser mojo service on devtools WebContents * fix takeHeapSnapshopt failure paths * {electron_api => atom}::mojom * add send_to_all to ElectronRenderer::Message * keep interface alive until callback is called * review comments * use GetContext from RendererClientBase * robustify a test that uses window.open * MessageSync posts a task to put sync messages in the same queue as async ones * add v8::MicrotasksScope and node::CallbackScope * iwyu * use weakptr to api::WebContents instead of Unretained * make MessageSync an asynchronous message & use non-associated interface * iwyu + comments * remove unused WeakPtrFactory * inline OnRendererMessage[Sync] * cleanups & comments * use helper methods instead of inline lambdas * remove unneeded async in test * add mojo to manifests deps * add gn check for //electron/manifests and mojo * don't register renderer side service until preload has been run * update gn check targets list * move interface registration back to RenderFrameCreated
2019-04-02 22:38:16 +00:00
}
2020-03-20 20:28:31 +00:00
});
2016-01-12 02:40:23 +00:00
2016-01-13 03:55:49 +00:00
// Use electron module after everything is ready.
2020-03-20 20:28:31 +00:00
const { webFrameInit } = require('@electron/internal/renderer/web-frame-init');
webFrameInit();
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Process command line arguments.
const { hasSwitch, getSwitchValue } = process._linkedBinding('electron_common_command_line');
const parseOption = function<T> (
name: string, defaultValue: T, converter?: (value: string) => T
) {
return hasSwitch(name)
? (
converter
? converter(getSwitchValue(name))
: getSwitchValue(name)
)
2020-03-20 20:28:31 +00:00
: defaultValue;
};
const contextIsolation = hasSwitch('context-isolation');
const nodeIntegration = hasSwitch('node-integration');
const webviewTag = hasSwitch('webview-tag');
const isHiddenPage = hasSwitch('hidden-page');
const usesNativeWindowOpen = hasSwitch('native-window-open');
const rendererProcessReuseEnabled = hasSwitch('disable-electron-site-instance-overrides');
const preloadScript = parseOption('preload', null);
const preloadScripts = parseOption('preload-scripts', [], value => value.split(path.delimiter)) as string[];
const appPath = parseOption('app-path', null);
const guestInstanceId = parseOption('guest-instance-id', null, value => parseInt(value));
const openerId = parseOption('opener-id', null, value => parseInt(value));
2018-12-12 21:31:16 +00:00
// The webContents preload script is loaded after the session preload scripts.
if (preloadScript) {
2020-03-20 20:28:31 +00:00
preloadScripts.push(preloadScript);
}
switch (window.location.protocol) {
case 'devtools:': {
// Override some inspector APIs.
2020-03-20 20:28:31 +00:00
require('@electron/internal/renderer/inspector');
break;
}
case 'chrome-extension:': {
2020-03-20 20:28:31 +00:00
break;
}
case 'chrome:':
2020-03-20 20:28:31 +00:00
break;
default: {
// Override default web functions.
2020-03-20 20:28:31 +00:00
const { windowSetup } = require('@electron/internal/renderer/window-setup');
windowSetup(guestInstanceId, openerId, isHiddenPage, usesNativeWindowOpen, rendererProcessReuseEnabled);
2016-01-12 02:40:23 +00:00
}
}
// Load webview tag implementation.
if (process.isMainFrame) {
2020-03-20 20:28:31 +00:00
const { webViewInit } = require('@electron/internal/renderer/web-view/web-view-init');
webViewInit(contextIsolation, webviewTag, guestInstanceId);
}
if (nodeIntegration) {
2016-01-14 18:35:29 +00:00
// Export node bindings to global.
const { makeRequireFunction } = __non_webpack_require__('internal/modules/cjs/helpers') // eslint-disable-line
2020-03-20 20:28:31 +00:00
global.module = new Module('electron/js2c/renderer_init');
global.require = makeRequireFunction(global.module);
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Set the __filename to the path of html file if it is file: protocol.
2016-01-12 02:40:23 +00:00
if (window.location.protocol === 'file:') {
2020-03-20 20:28:31 +00:00
const location = window.location;
let pathname = location.pathname;
if (process.platform === 'win32') {
2020-03-20 20:28:31 +00:00
if (pathname[0] === '/') pathname = pathname.substr(1);
2020-03-20 20:28:31 +00:00
const isWindowsNetworkSharePath = location.hostname.length > 0 && process.resourcesPath.startsWith('\\');
if (isWindowsNetworkSharePath) {
2020-03-20 20:28:31 +00:00
pathname = `//${location.host}/${pathname}`;
}
}
2020-03-20 20:28:31 +00:00
global.__filename = path.normalize(decodeURIComponent(pathname));
global.__dirname = path.dirname(global.__filename);
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Set module's filename so relative require can work as expected.
2020-03-20 20:28:31 +00:00
global.module.filename = global.__filename;
2016-01-12 02:40:23 +00:00
2016-01-14 18:35:29 +00:00
// Also search for module under the html file.
2020-03-20 20:28:31 +00:00
global.module.paths = Module._nodeModulePaths(global.__dirname);
2016-01-12 02:40:23 +00:00
} else {
// For backwards compatibility we fake these two paths here
2020-03-20 20:28:31 +00:00
global.__filename = path.join(process.resourcesPath, 'electron.asar', 'renderer', 'init.js');
global.__dirname = path.join(process.resourcesPath, 'electron.asar', 'renderer');
2017-04-04 00:36:01 +00:00
if (appPath) {
2017-04-03 13:11:29 +00:00
// Search for module under the app directory
2020-03-20 20:28:31 +00:00
global.module.paths = Module._nodeModulePaths(appPath);
2017-04-03 13:11:29 +00:00
}
2016-01-12 02:40:23 +00:00
}
2016-01-14 18:35:29 +00:00
// Redirect window.onerror to uncaughtException.
window.onerror = function (_message, _filename, _lineno, _colno, error) {
if (global.process.listenerCount('uncaughtException') > 0) {
// We do not want to add `uncaughtException` to our definitions
// because we don't want anyone else (anywhere) to throw that kind
// of error.
2020-03-20 20:28:31 +00:00
global.process.emit('uncaughtException' as any, error as any);
return true;
2016-01-12 02:40:23 +00:00
} else {
2020-03-20 20:28:31 +00:00
return false;
2016-01-12 02:40:23 +00:00
}
2020-03-20 20:28:31 +00:00
};
2016-01-12 02:40:23 +00:00
} else {
// Delete Node's symbols after the Environment has been loaded in a
// non context-isolated environment
if (!contextIsolation) {
process.once('loaded', function () {
2020-08-24 18:23:25 +00:00
delete (global as any).process;
delete (global as any).Buffer;
delete (global as any).setImmediate;
delete (global as any).clearImmediate;
delete (global as any).global;
delete (global as any).root;
delete (global as any).GLOBAL;
2020-03-20 20:28:31 +00:00
});
}
2016-01-12 02:40:23 +00:00
}
// Load the preload scripts.
for (const preloadScript of preloadScripts) {
2016-01-12 02:40:23 +00:00
try {
2020-03-20 20:28:31 +00:00
Module._load(preloadScript);
2016-01-14 22:20:06 +00:00
} catch (error) {
2020-03-20 20:28:31 +00:00
console.error(`Unable to load preload script: ${preloadScript}`);
console.error(error);
2020-03-20 20:28:31 +00:00
ipcRendererInternal.send('ELECTRON_BROWSER_PRELOAD_ERROR', preloadScript, error);
2016-01-12 02:40:23 +00:00
}
}
// Warn about security issues
if (process.isMainFrame) {
2020-03-20 20:28:31 +00:00
const { securityWarnings } = require('@electron/internal/renderer/security-warnings');
securityWarnings(nodeIntegration);
}