4 |
7 |
8 |
9 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/ping.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/save_page/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
4 |
5 |
6 |
7 |
--------------------------------------------------------------------------------
/spec-main/fixtures/module/echo.js:
--------------------------------------------------------------------------------
1 | process.on('uncaughtException', function (err) {
2 | process.send(err.message);
3 | });
4 |
5 | const echo = require('echo');
6 | process.send(echo('ok'));
7 |
--------------------------------------------------------------------------------
/spec/fixtures/api/localstorage.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/spec/fixtures/module/empty.js:
--------------------------------------------------------------------------------
1 | const { ipcRenderer } = require('electron');
2 |
3 | window.addEventListener('message', (event) => {
4 | ipcRenderer.send('leak-result', event.data);
5 | });
6 |
--------------------------------------------------------------------------------
/spec/fixtures/module/preload-ipc.js:
--------------------------------------------------------------------------------
1 | const { ipcRenderer } = require('electron');
2 | ipcRenderer.on('ping', function (event, message) {
3 | ipcRenderer.sendToHost('pong', message);
4 | });
5 |
--------------------------------------------------------------------------------
/.env.example:
--------------------------------------------------------------------------------
1 | # These env vars are only necessary for creating Electron releases.
2 | # See docs/development/releasing.md
3 |
4 | APPVEYOR_CLOUD_TOKEN=
5 | CIRCLE_TOKEN=
6 | ELECTRON_GITHUB_TOKEN=
7 |
--------------------------------------------------------------------------------
/docs/api/structures/protocol-response-upload-data.md:
--------------------------------------------------------------------------------
1 | # ProtocolResponseUploadData Object
2 |
3 | * `contentType` String - MIME type of the content.
4 | * `data` String | Buffer - Content to be sent.
5 |
--------------------------------------------------------------------------------
/spec-main/fixtures/module/print-crash-parameters.js:
--------------------------------------------------------------------------------
1 | process.crashReporter.addExtraParameter('hello', 'world');
2 | process.stdout.write(JSON.stringify(process.crashReporter.getParameters()) + '\n');
3 |
--------------------------------------------------------------------------------
/spec/fixtures/module/send-later.js:
--------------------------------------------------------------------------------
1 | const { ipcRenderer } = require('electron');
2 | window.onload = function () {
3 | ipcRenderer.send('answer', typeof window.process, typeof window.Buffer);
4 | };
5 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/webview-stripped-preload.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/tsconfig.electron.json:
--------------------------------------------------------------------------------
1 | {
2 | "extends": "./tsconfig.json",
3 | "compilerOptions": {
4 | "rootDir": "lib"
5 | },
6 | "include": [
7 | "lib",
8 | "typings"
9 | ]
10 | }
11 |
--------------------------------------------------------------------------------
/docs/api/structures/scrubber-item.md:
--------------------------------------------------------------------------------
1 | # ScrubberItem Object
2 |
3 | * `label` String (optional) - The text to appear in this item.
4 | * `icon` NativeImage (optional) - The image to appear in this item.
5 |
--------------------------------------------------------------------------------
/spec-main/fixtures/extensions/load-error/manifest.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "load-error",
3 | "version": "1.0",
4 | "icons": {
5 | "16": "/images/error.png"
6 | },
7 | "manifest_version": 2
8 | }
9 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/e.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/spec-main/fixtures/extensions/devtools-extension/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 | a custom devtools extension
4 |
5 |
6 |
--------------------------------------------------------------------------------
/spec-main/fixtures/native-addon/echo/binding.gyp:
--------------------------------------------------------------------------------
1 | {
2 | "targets": [
3 | {
4 | "target_name": "echo",
5 | "sources": [
6 | "binding.cc"
7 | ]
8 | }
9 | ]
10 | }
11 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/partition/one.html:
--------------------------------------------------------------------------------
1 |
7 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/window-opener-postMessage.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/tsconfig.spec.json:
--------------------------------------------------------------------------------
1 | {
2 | "extends": "./tsconfig.json",
3 | "compilerOptions": {
4 | "rootDir": "spec-main"
5 | },
6 | "include": [
7 | "spec-main",
8 | "typings"
9 | ]
10 | }
11 |
--------------------------------------------------------------------------------
/docs/api/structures/file-path-with-headers.md:
--------------------------------------------------------------------------------
1 | # FilePathWithHeaders Object
2 |
3 | * `path` String - The path to the file to send.
4 | * `headers` RecordHello World!
Close this Window' 7 | ipcRenderer.send('create-frameless-window', { url }) 8 | }) 9 | -------------------------------------------------------------------------------- /lib/browser/api/exports/electron.ts: -------------------------------------------------------------------------------- 1 | import { defineProperties } from '@electron/internal/common/define-properties'; 2 | import { commonModuleList } from '@electron/internal/common/api/module-list'; 3 | import { browserModuleList } from '@electron/internal/browser/api/module-list'; 4 | 5 | module.exports = {}; 6 | 7 | defineProperties(module.exports, commonModuleList); 8 | defineProperties(module.exports, browserModuleList); 9 | -------------------------------------------------------------------------------- /lib/common/api/module-list.ts: -------------------------------------------------------------------------------- 1 | // Common modules, please sort alphabetically 2 | export const commonModuleList: ElectronInternal.ModuleEntry[] = [ 3 | { name: 'clipboard', loader: () => require('./clipboard') }, 4 | { name: 'shell', loader: () => require('./shell') }, 5 | // The internal modules, invisible unless you know their names. 6 | { name: 'deprecate', loader: () => require('./deprecate'), private: true } 7 | ]; 8 | -------------------------------------------------------------------------------- /spec/fixtures/pages/a.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 10 | 11 | 12 | -------------------------------------------------------------------------------- /lib/renderer/api/exports/electron.ts: -------------------------------------------------------------------------------- 1 | import { defineProperties } from '@electron/internal/common/define-properties'; 2 | import { commonModuleList } from '@electron/internal/common/api/module-list'; 3 | import { rendererModuleList } from '@electron/internal/renderer/api/module-list'; 4 | 5 | module.exports = {}; 6 | 7 | defineProperties(module.exports, commonModuleList); 8 | defineProperties(module.exports, rendererModuleList); 9 | -------------------------------------------------------------------------------- /script/generate-zip-manifest.py: -------------------------------------------------------------------------------- 1 | #!/usr/bin/env python 2 | 3 | import zipfile 4 | import sys 5 | 6 | def main(zip_path, manifest_out): 7 | with open(manifest_out, 'w') as manifest, \ 8 | zipfile.ZipFile(zip_path, 'r', allowZip64=True) as z: 9 | for name in sorted(z.namelist()): 10 | manifest.write(name + '\n') 11 | return 0 12 | 13 | if __name__ == '__main__': 14 | sys.exit(main(*sys.argv[1:])) 15 | -------------------------------------------------------------------------------- /spec-main/fixtures/extensions/lazy-background-page/runtime-get-background-page.js: -------------------------------------------------------------------------------- 1 | /* global chrome */ 2 | window.completionPromise = new Promise((resolve) => { 3 | window.completionPromiseResolve = resolve; 4 | }); 5 | chrome.runtime.sendMessage({ some: 'message' }, (response) => { 6 | chrome.runtime.getBackgroundPage((bgPage) => { 7 | window.completionPromiseResolve(bgPage.receivedMessage); 8 | }); 9 | }); 10 | -------------------------------------------------------------------------------- /spec-main/fixtures/sub-frames/frame-with-frame.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |Hello World!
Close this Window' 7 | ipcRenderer.send('create-frameless-window', { url }) 8 | }) 9 | -------------------------------------------------------------------------------- /spec-main/fixtures/auto-update/initial/index.js: -------------------------------------------------------------------------------- 1 | process.on('uncaughtException', (err) => { 2 | console.error(err); 3 | process.exit(1); 4 | }); 5 | 6 | const { autoUpdater } = require('electron'); 7 | 8 | const feedUrl = process.argv[1]; 9 | 10 | console.log('Setting Feed URL'); 11 | 12 | autoUpdater.setFeedURL({ 13 | url: feedUrl 14 | }); 15 | 16 | console.log('Feed URL Set:', feedUrl); 17 | 18 | process.exit(0); 19 | -------------------------------------------------------------------------------- /script/lib/npm.py: -------------------------------------------------------------------------------- 1 | import subprocess 2 | import sys 3 | 4 | 5 | def npm(*npm_args): 6 | call_args = [__get_executable_name()] + list(npm_args) 7 | subprocess.check_call(call_args) 8 | 9 | 10 | def __get_executable_name(): 11 | executable = 'npm' 12 | if sys.platform == 'win32': 13 | executable += '.cmd' 14 | return executable 15 | 16 | 17 | if __name__ == '__main__': 18 | npm(*sys.argv[1:]) 19 | -------------------------------------------------------------------------------- /spec-main/fixtures/crash-cases/transparent-window-get-background-color/index.js: -------------------------------------------------------------------------------- 1 | const { app, BrowserWindow } = require('electron'); 2 | 3 | function createWindow () { 4 | // Create the browser window. 5 | const mainWindow = new BrowserWindow({ 6 | transparent: true 7 | }); 8 | mainWindow.getBackgroundColor(); 9 | } 10 | 11 | app.on('ready', () => { 12 | createWindow(); 13 | setTimeout(() => app.quit()); 14 | }); 15 | -------------------------------------------------------------------------------- /spec-main/fixtures/pages/webview-devtools.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |Hello World!
11 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /spec/fixtures/pages/webview-did-attach-event.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |Hello World!
10 |11 | We are using Node.js , 12 | Chromium , 13 | and Electron . 14 |
15 | 16 | 17 | -------------------------------------------------------------------------------- /spec-main/fixtures/native-addon/uv-dlopen/index.js: -------------------------------------------------------------------------------- 1 | const testLoadLibrary = require('./build/Release/test_module'); 2 | 3 | const lib = (() => { 4 | switch (process.platform) { 5 | case 'linux': 6 | return `${__dirname}/build/Release/foo.so`; 7 | case 'darwin': 8 | return `${__dirname}/build/Release/foo.dylib`; 9 | case 'win32': 10 | return `${__dirname}/build/Release/libfoo.dll`; 11 | default: 12 | throw new Error('unsupported os'); 13 | } 14 | })(); 15 | 16 | testLoadLibrary(lib); 17 | -------------------------------------------------------------------------------- /spec-main/fixtures/sub-frames/frame-with-frame-container-webview.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |Hello World!
9 |10 | We are using node , 11 | Chrome , 12 | and Electron . 13 |
14 | 15 | 16 | -------------------------------------------------------------------------------- /shell/browser/ui/inspectable_web_contents_view_delegate.cc: -------------------------------------------------------------------------------- 1 | // Copyright (c) 2012 The Chromium Authors. All rights reserved. 2 | // Copyright (c) 2013 Adam RobenHello World!
10 | We are using node , 11 | Chrome , 12 | and Electron . 13 | 14 | 15 | -------------------------------------------------------------------------------- /docs/fiddles/features/online-detection/renderer/main.js: -------------------------------------------------------------------------------- 1 | const { app, BrowserWindow } = require('electron') 2 | 3 | let onlineStatusWindow 4 | 5 | app.whenReady().then(() => { 6 | onlineStatusWindow = new BrowserWindow({ width: 0, height: 0, show: false }) 7 | onlineStatusWindow.loadURL(`file://${__dirname}/index.html`) 8 | }) 9 | 10 | app.on('window-all-closed', () => { 11 | if (process.platform !== 'darwin') { 12 | app.quit() 13 | } 14 | }) 15 | 16 | app.on('activate', () => { 17 | if (BrowserWindow.getAllWindows().length === 0) { 18 | createWindow() 19 | } 20 | }) 21 | -------------------------------------------------------------------------------- /docs/fiddles/system/clipboard/copy/main.js: -------------------------------------------------------------------------------- 1 | const { app, BrowserWindow } = require('electron') 2 | 3 | let mainWindow = null 4 | 5 | function createWindow () { 6 | const windowOptions = { 7 | width: 600, 8 | height: 400, 9 | title: 'Clipboard copy', 10 | webPreferences: { 11 | nodeIntegration: true 12 | } 13 | } 14 | 15 | mainWindow = new BrowserWindow(windowOptions) 16 | mainWindow.loadFile('index.html') 17 | 18 | mainWindow.on('closed', () => { 19 | mainWindow = null 20 | }) 21 | } 22 | 23 | app.whenReady().then(() => { 24 | createWindow() 25 | }) 26 | -------------------------------------------------------------------------------- /spec/fixtures/api/window-all-closed/main.js: -------------------------------------------------------------------------------- 1 | const { app, BrowserWindow } = require('electron'); 2 | 3 | let handled = false; 4 | 5 | if (app.commandLine.hasSwitch('handle-event')) { 6 | app.on('window-all-closed', () => { 7 | handled = true; 8 | app.quit(); 9 | }); 10 | } 11 | 12 | app.on('quit', () => { 13 | process.stdout.write(JSON.stringify(handled)); 14 | process.stdout.end(); 15 | }); 16 | 17 | app.whenReady().then(() => { 18 | const win = new BrowserWindow({ 19 | webPreferences: { 20 | contextIsolation: true 21 | } 22 | }); 23 | win.close(); 24 | }); 25 | -------------------------------------------------------------------------------- /docs/fiddles/features/macos-dock-menu/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |Hello World!
10 |11 | We are using node , 12 | Chrome , 13 | and Electron . 14 |
15 | 16 | 17 | -------------------------------------------------------------------------------- /docs/fiddles/features/progress-bar/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |Hello World!
10 |11 | We are using node , 12 | Chrome , 13 | and Electron . 14 |
15 | 16 | 17 | -------------------------------------------------------------------------------- /docs/fiddles/system/clipboard/paste/main.js: -------------------------------------------------------------------------------- 1 | const { app, BrowserWindow } = require('electron') 2 | 3 | let mainWindow = null 4 | 5 | function createWindow () { 6 | const windowOptions = { 7 | width: 600, 8 | height: 400, 9 | title: 'Clipboard paste', 10 | webPreferences: { 11 | nodeIntegration: true 12 | } 13 | } 14 | 15 | mainWindow = new BrowserWindow(windowOptions) 16 | mainWindow.loadFile('index.html') 17 | 18 | mainWindow.on('closed', () => { 19 | mainWindow = null 20 | }) 21 | } 22 | 23 | app.whenReady().then(() => { 24 | createWindow() 25 | }) 26 | -------------------------------------------------------------------------------- /shell/browser/font_defaults.h: -------------------------------------------------------------------------------- 1 | // Copyright (c) 2018 Slack Technologies, Inc. 2 | // Use of this source code is governed by the MIT license that can be 3 | // found in the LICENSE file. 4 | 5 | #ifndef SHELL_BROWSER_FONT_DEFAULTS_H_ 6 | #define SHELL_BROWSER_FONT_DEFAULTS_H_ 7 | 8 | namespace blink { 9 | namespace web_pref { 10 | struct WebPreferences; 11 | } // namespace web_pref 12 | } // namespace blink 13 | 14 | namespace electron { 15 | 16 | void SetFontDefaults(blink::web_pref::WebPreferences* prefs); 17 | 18 | } // namespace electron 19 | 20 | #endif // SHELL_BROWSER_FONT_DEFAULTS_H_ 21 | -------------------------------------------------------------------------------- /docs/fiddles/features/notifications/main/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |Hello World!
10 |11 | We are using node , 12 | Chrome , 13 | and Electron . 14 |
15 | 16 | 17 | -------------------------------------------------------------------------------- /docs/fiddles/features/recent-documents/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |Hello World!
10 |11 | We are using node , 12 | Chrome , 13 | and Electron . 14 |
15 | 16 | 17 | -------------------------------------------------------------------------------- /docs/fiddles/features/represented-file/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |Hello World!
10 |11 | We are using node , 12 | Chrome , 13 | and Electron . 14 |
15 | 16 | 17 | -------------------------------------------------------------------------------- /docs/fiddles/native-ui/dialogs/error-dialog/renderer.js: -------------------------------------------------------------------------------- 1 | const { ipcRenderer, shell } = require('electron') 2 | 3 | const links = document.querySelectorAll('a[href]') 4 | const errorBtn = document.getElementById('error-dialog') 5 | 6 | errorBtn.addEventListener('click', event => { 7 | ipcRenderer.send('open-error-dialog') 8 | }) 9 | 10 | Array.prototype.forEach.call(links, (link) => { 11 | const url = link.getAttribute('href') 12 | if (url.indexOf('http') === 0) { 13 | link.addEventListener('click', (e) => { 14 | e.preventDefault() 15 | shell.openExternal(url) 16 | }) 17 | } 18 | }) -------------------------------------------------------------------------------- /script/start-goma.ps1: -------------------------------------------------------------------------------- 1 | param([string]$gomaDir=$PWD) 2 | $cmdPath = Join-Path -Path $gomaDir -ChildPath "goma_ctl.py" 3 | Start-Process -FilePath cmd -ArgumentList "/C", "python", "$cmdPath", "ensure_start" 4 | $timedOut = $false; $waitTime = 0; $waitIncrement = 5; $timeout=120; 5 | Do { sleep $waitIncrement; $timedOut = (($waitTime+=$waitIncrement) -gt $timeout); iex "$gomaDir\gomacc.exe port 2" > $null; } Until(($LASTEXITCODE -eq 0) -or $timedOut) 6 | if ($timedOut) { 7 | write-error 'Timed out waiting for goma to start'; exit 1; 8 | } else { 9 | Write-Output "Successfully started goma!" 10 | } 11 | -------------------------------------------------------------------------------- /spec-main/api-power-save-blocker-spec.ts: -------------------------------------------------------------------------------- 1 | import { expect } from 'chai'; 2 | import { powerSaveBlocker } from 'electron/main'; 3 | 4 | describe('powerSaveBlocker module', () => { 5 | it('can be started and stopped', () => { 6 | expect(powerSaveBlocker.isStarted(-1)).to.be.false('is started'); 7 | const id = powerSaveBlocker.start('prevent-app-suspension'); 8 | expect(id).to.to.be.a('number'); 9 | expect(powerSaveBlocker.isStarted(id)).to.be.true('is started'); 10 | powerSaveBlocker.stop(id); 11 | expect(powerSaveBlocker.isStarted(id)).to.be.false('is started'); 12 | }); 13 | }); 14 | --------------------------------------------------------------------------------