Hello World!
5 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /spec/fixtures/module/preload-sandboxæø åü.js: -------------------------------------------------------------------------------- 1 | (function () { 2 | window.require = require; 3 | if (location.protocol === 'file:') { 4 | window.test = 'preload'; 5 | } 6 | })(); 7 | -------------------------------------------------------------------------------- /spec/fixtures/pages/b.html: -------------------------------------------------------------------------------- 1 | 2 | 3 |
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/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 |
--------------------------------------------------------------------------------
/spec/fixtures/module/print-crash-parameters.js:
--------------------------------------------------------------------------------
1 | process.crashReporter.addExtraParameter('hello', 'world');
2 | process.stdout.write(JSON.stringify(process.crashReporter.getParameters()) + '\n');
3 |
--------------------------------------------------------------------------------
/.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 |
--------------------------------------------------------------------------------
/lib/browser/ipc-main-internal.ts:
--------------------------------------------------------------------------------
1 | import { IpcMainImpl } from '@electron/internal/browser/ipc-main-impl';
2 |
3 | export const ipcMainInternal = new IpcMainImpl() as ElectronInternal.IpcMainInternal;
4 |
--------------------------------------------------------------------------------
/spec/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/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/fixtures/extensions/devtools-extension/index.html:
--------------------------------------------------------------------------------
1 |
2 |
3 | a custom devtools extension
4 |
5 |
6 |
--------------------------------------------------------------------------------
/spec/fixtures/module/echo.js:
--------------------------------------------------------------------------------
1 | process.on('uncaughtException', function (err) {
2 | process.send(err.message);
3 | });
4 |
5 | const echo = require('@electron-ci/echo');
6 | process.send(echo('ok'));
7 |
--------------------------------------------------------------------------------
/spec/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/e.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/partition/one.html:
--------------------------------------------------------------------------------
1 |
7 |
--------------------------------------------------------------------------------
/spec/fixtures/pages/window-opener-postMessage.html:
--------------------------------------------------------------------------------
1 |
2 |
3 |
6 |
7 |
8 |
--------------------------------------------------------------------------------
/.git-blame-ignore-revs:
--------------------------------------------------------------------------------
1 | # Atom --> Electron rename
2 | d9321f4df751fa32813fab1b6387bbd61bd681d0
3 | 34c4c8d5088fa183f56baea28809de6f2a427e02
4 | # Enable JS Semicolons
5 | 5d657dece4102e5e5304d42e8004b6ad64c0fcda
6 |
--------------------------------------------------------------------------------
/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!
10 |Right click the dock icon to see the custom menu options.
11 | 12 | 13 | -------------------------------------------------------------------------------- /npm/package.json: -------------------------------------------------------------------------------- 1 | { 2 | "main": "index.js", 3 | "types": "electron.d.ts", 4 | "bin": { 5 | "electron": "cli.js" 6 | }, 7 | "scripts": { 8 | "postinstall": "node install.js" 9 | }, 10 | "dependencies": { 11 | "@electron/get": "^2.0.0", 12 | "@types/node": "^18.11.18", 13 | "extract-zip": "^2.0.1" 14 | }, 15 | "engines": { 16 | "node": ">= 12.20.55" 17 | } 18 | } 19 | -------------------------------------------------------------------------------- /spec/fixtures/apps/open-new-window-from-link/new-window-page.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 |Connection status:
10 | 11 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /docs/fiddles/system/protocol-handler/launch-app-from-URL-in-another-app/renderer.js: -------------------------------------------------------------------------------- 1 | // This file is required by the index.html file and will 2 | // be executed in the renderer process for that window. 3 | // All APIs exposed by the context bridge are available here. 4 | 5 | // Binds the buttons to the context bridge API. 6 | document.getElementById('open-in-browser').addEventListener('click', () => { 7 | shell.open(); 8 | }); -------------------------------------------------------------------------------- /docs/fiddles/windows/manage-windows/frameless-window/renderer.js: -------------------------------------------------------------------------------- 1 | const { ipcRenderer } = require('electron') 2 | 3 | const newWindowBtn = document.getElementById('frameless-window') 4 | 5 | newWindowBtn.addEventListener('click', () => { 6 | const url = 'data:text/html,Hello 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 | -------------------------------------------------------------------------------- /patches/squirrel.mac/.patches: -------------------------------------------------------------------------------- 1 | build_add_gn_config.patch 2 | fix_ensure_that_self_is_retained_until_the_racsignal_is_complete.patch 3 | fix_use_kseccschecknestedcode_kseccsstrictvalidate_in_the_sec.patch 4 | feat_add_new_squirrel_mac_bundle_installation_method_behind_flag.patch 5 | refactor_use_posix_spawn_instead_of_nstask_so_we_can_disclaim_the.patch 6 | fix_abort_installation_attempt_at_the_final_mile_if_the_app_is.patch 7 | -------------------------------------------------------------------------------- /spec/fixtures/api/utility-process/inherit-stderr/main.js: -------------------------------------------------------------------------------- 1 | const { app, utilityProcess } = require('electron'); 2 | const path = require('path'); 3 | 4 | app.whenReady().then(() => { 5 | const payload = app.commandLine.getSwitchValue('payload'); 6 | const child = utilityProcess.fork(path.join(__dirname, 'test.js'), [`--payload=${payload}`]); 7 | child.on('exit', () => { 8 | app.quit(); 9 | }); 10 | }); 11 | -------------------------------------------------------------------------------- /spec/fixtures/api/utility-process/inherit-stdout/main.js: -------------------------------------------------------------------------------- 1 | const { app, utilityProcess } = require('electron'); 2 | const path = require('path'); 3 | 4 | app.whenReady().then(() => { 5 | const payload = app.commandLine.getSwitchValue('payload'); 6 | const child = utilityProcess.fork(path.join(__dirname, 'test.js'), [`--payload=${payload}`]); 7 | child.on('exit', () => { 8 | app.quit(); 9 | }); 10 | }); 11 | -------------------------------------------------------------------------------- /spec/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/fixtures/sub-frames/frame-container.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |Hello World!
10 |After launching this application, you should see the system notification.
11 | 12 | 13 | -------------------------------------------------------------------------------- /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 | -------------------------------------------------------------------------------- /spec/fixtures/api/native-window-open-file.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 11 | 12 | 13 | -------------------------------------------------------------------------------- /spec/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 | -------------------------------------------------------------------------------- /spec/fixtures/crash-cases/fs-promises-renderer-crash/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 16 | 17 | 18 | -------------------------------------------------------------------------------- /spec/fixtures/pages/webview-opener-no-node-integration.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 10 | 11 | 12 | -------------------------------------------------------------------------------- /docs/api/structures/service-worker-info.md: -------------------------------------------------------------------------------- 1 | # ServiceWorkerInfo Object 2 | 3 | * `scriptUrl` string - The full URL to the script that this service worker runs 4 | * `scope` string - The base URL that this service worker is active for. 5 | * `renderProcessId` number - The virtual ID of the process that this service worker is running in. This is not an OS level PID. This aligns with the ID set used for `webContents.getProcessId()`. 6 | -------------------------------------------------------------------------------- /docs/fiddles/features/keyboard-shortcuts/interception-from-main/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |Hello World!
10 |Hit Ctrl+I to see a message printed to the console.
11 | 12 | 13 | -------------------------------------------------------------------------------- /docs/fiddles/windows/manage-windows/create-frameless-window/renderer.js: -------------------------------------------------------------------------------- 1 | const { ipcRenderer } = require('electron') 2 | 3 | const newWindowBtn = document.getElementById('frameless-window') 4 | 5 | newWindowBtn.addEventListener('click', () => { 6 | const url = 'data:text/html,Hello World!
Close this Window' 7 | ipcRenderer.send('create-frameless-window', { url }) 8 | }) 9 | -------------------------------------------------------------------------------- /shell/app/node_main.h: -------------------------------------------------------------------------------- 1 | // Copyright (c) 2015 GitHub, 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 ELECTRON_SHELL_APP_NODE_MAIN_H_ 6 | #define ELECTRON_SHELL_APP_NODE_MAIN_H_ 7 | 8 | namespace electron { 9 | 10 | int NodeMain(int argc, char* argv[]); 11 | 12 | } // namespace electron 13 | 14 | #endif // ELECTRON_SHELL_APP_NODE_MAIN_H_ 15 | -------------------------------------------------------------------------------- /spec/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/fixtures/pages/webview-devtools.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |
3 | WebView
4 |
5 |
6 |
13 |
14 |
--------------------------------------------------------------------------------
/docs/api/structures/hid-device.md:
--------------------------------------------------------------------------------
1 | # HIDDevice Object
2 |
3 | * `deviceId` string - Unique identifier for the device.
4 | * `name` string - Name of the device.
5 | * `vendorId` Integer - The USB vendor ID.
6 | * `productId` Integer - The USB product ID.
7 | * `serialNumber` string (optional) - The USB device serial number.
8 | * `guid` string (optional) - Unique identifier for the HID interface. A device may have multiple HID interfaces.
9 |
--------------------------------------------------------------------------------
/lib/isolated_renderer/init.ts:
--------------------------------------------------------------------------------
1 | /* global isolatedApi */
2 |
3 | import type * as webViewElementModule from '@electron/internal/renderer/web-view/web-view-element';
4 |
5 | if (isolatedApi.guestViewInternal) {
6 | // Must setup the WebView element in main world.
7 | const { setupWebView } = require('@electron/internal/renderer/web-view/web-view-element') as typeof webViewElementModule;
8 | setupWebView(isolatedApi);
9 | }
10 |
--------------------------------------------------------------------------------
/script/generate-zip-manifest.py:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python3
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], sys.argv[2]))
15 |
--------------------------------------------------------------------------------
/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/fixtures/api/first-party-sets/command-line/main.js:
--------------------------------------------------------------------------------
1 | const { app } = require('electron');
2 |
3 | app.whenReady().then(function () {
4 | const hasSwitch = app.commandLine.hasSwitch('use-first-party-set');
5 | const value = app.commandLine.getSwitchValue('use-first-party-set');
6 | if (hasSwitch) {
7 | process.stdout.write(JSON.stringify(value));
8 | process.stdout.end();
9 | }
10 |
11 | app.quit();
12 | });
13 |
--------------------------------------------------------------------------------
/spec/fixtures/apps/crash/sandbox-preload.js:
--------------------------------------------------------------------------------
1 | const { crashReporter } = require('electron');
2 |
3 | const params = new URLSearchParams(location.search);
4 | if (params.get('set_extra') === '1') {
5 | crashReporter.addExtraParameter('rendererSpecific', 'rs');
6 | crashReporter.addExtraParameter('addedThenRemoved', 'to-be-removed');
7 | crashReporter.removeExtraParameter('addedThenRemoved');
8 | }
9 |
10 | process.crash();
11 |
--------------------------------------------------------------------------------
/spec/fixtures/extensions/lazy-background-page/manifest.json:
--------------------------------------------------------------------------------
1 | {
2 | "name": "lazy-background-page",
3 | "version": "1.0",
4 | "background": {
5 | "scripts": ["background.js"],
6 | "persistent": false
7 | },
8 | "content_scripts": [
9 | {
10 | "matches": ["Hello World!
10 |Hit Alt+Ctrl+I on Windows or Opt+Cmd+I on Mac to see a message printed to the console.
11 | 12 | 13 | -------------------------------------------------------------------------------- /lib/renderer/api/module-list.ts: -------------------------------------------------------------------------------- 1 | // Renderer side modules, please sort alphabetically. 2 | export const rendererModuleList: ElectronInternal.ModuleEntry[] = [ 3 | { name: 'contextBridge', loader: () => require('./context-bridge') }, 4 | { name: 'crashReporter', loader: () => require('./crash-reporter') }, 5 | { name: 'ipcRenderer', loader: () => require('./ipc-renderer') }, 6 | { name: 'webFrame', loader: () => require('./web-frame') } 7 | ]; 8 | -------------------------------------------------------------------------------- /script/codesign/codesign.cnf: -------------------------------------------------------------------------------- 1 | [req] 2 | default_bits = 4096 3 | encrypt_key = no 4 | default_md = sha512 5 | distinguished_name = req_distinguished_name 6 | prompt = no 7 | 8 | [req_distinguished_name] 9 | C = CA 10 | ST = BC 11 | L = Vancouver 12 | O = ElectronJS 13 | OU = BuildAutomation 14 | CN = codesign.electronjs.org 15 | 16 | [extended] 17 | keyUsage = critical,digitalSignature 18 | extendedKeyUsage = critical,codeSigning 19 | -------------------------------------------------------------------------------- /docs/fiddles/features/keyboard-shortcuts/local/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 |Hello World!
10 |Hit Alt+Shift+I on Windows, or Opt+Cmd+I on mac to see a message printed to the console.
11 | 12 | 13 | -------------------------------------------------------------------------------- /spec/fixtures/api/native-window-open-blank.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 10 | 11 | 12 | -------------------------------------------------------------------------------- /spec/fixtures/pages/fetch.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 14 | 15 | 16 | -------------------------------------------------------------------------------- /spec/fixtures/pages/webframe-spell-check.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 12 | 13 | 14 | 15 | -------------------------------------------------------------------------------- /spec/fixtures/pages/window-open-postMessage-driver.html: -------------------------------------------------------------------------------- 1 | 11 | -------------------------------------------------------------------------------- /spec/fixtures/preload-expose-ipc.js: -------------------------------------------------------------------------------- 1 | const { contextBridge, ipcRenderer } = require('electron'); 2 | 3 | // NOTE: Never do this in an actual app! Very insecure! 4 | contextBridge.exposeInMainWorld('ipc', { 5 | send (...args) { 6 | return ipcRenderer.send(...args); 7 | }, 8 | sendSync (...args) { 9 | return ipcRenderer.sendSync(...args); 10 | }, 11 | invoke (...args) { 12 | return ipcRenderer.invoke(...args); 13 | } 14 | }); 15 | -------------------------------------------------------------------------------- /spec/fixtures/workers/load_shared_worker.html: -------------------------------------------------------------------------------- 1 | 15 | 16 | -------------------------------------------------------------------------------- /shell/browser/extensions/electron_display_info_provider.cc: -------------------------------------------------------------------------------- 1 | // Copyright 2014 The Chromium Authors. All rights reserved. 2 | // Use of this source code is governed by a BSD-style license that can be 3 | // found in the LICENSE file. 4 | 5 | #include "shell/browser/extensions/electron_display_info_provider.h" 6 | 7 | namespace extensions { 8 | 9 | ElectronDisplayInfoProvider::ElectronDisplayInfoProvider() = default; 10 | 11 | } // namespace extensions 12 | -------------------------------------------------------------------------------- /shell/browser/resources/win/resource.h: -------------------------------------------------------------------------------- 1 | //{{NO_DEPENDENCIES}} 2 | // Microsoft Visual C++ generated include file. 3 | 4 | #define IDR_MAINFRAME 1 5 | 6 | // Next default values for new objects 7 | // 8 | #ifdef APSTUDIO_INVOKED 9 | #ifndef APSTUDIO_READONLY_SYMBOLS 10 | #define _APS_NEXT_RESOURCE_VALUE 101 11 | #define _APS_NEXT_COMMAND_VALUE 40001 12 | #define _APS_NEXT_CONTROL_VALUE 1001 13 | #define _APS_NEXT_SYMED_VALUE 101 14 | #endif 15 | #endif 16 | -------------------------------------------------------------------------------- /spec/fixtures/extensions/chrome-api/manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "chrome-api", 3 | "version": "1.0", 4 | "content_scripts": [ 5 | { 6 | "matches": ["Hello World
7 |
11 |
12 |
13 |
--------------------------------------------------------------------------------
/docs/api/structures/process-memory-info.md:
--------------------------------------------------------------------------------
1 | # ProcessMemoryInfo Object
2 |
3 | * `residentSet` Integer _Linux_ _Windows_ - The amount of memory
4 | currently pinned to actual physical RAM in Kilobytes.
5 | * `private` Integer - The amount of memory not shared by other processes, such as JS heap or HTML content in Kilobytes.
6 | * `shared` Integer - The amount of memory shared between processes, typically
7 | memory consumed by the Electron code itself in Kilobytes.
8 |
--------------------------------------------------------------------------------
/docs/api/touch-bar-group.md:
--------------------------------------------------------------------------------
1 | ## Class: TouchBarGroup
2 |
3 | > Create a group in the touch bar for native macOS applications
4 |
5 | Process: [Main](../glossary.md#main-process)6 | _This class is not exported from the `'electron'` module. It is only available as a return value of other methods in the Electron API._ 7 | 8 | ### `new TouchBarGroup(options)` 9 | 10 | * `options` Object 11 | * `items` [TouchBar](touch-bar.md) - Items to display as a group. 12 | -------------------------------------------------------------------------------- /lib/browser/api/session.ts: -------------------------------------------------------------------------------- 1 | import { fetchWithSession } from '@electron/internal/browser/api/net-fetch'; 2 | const { fromPartition, Session } = process._linkedBinding('electron_browser_session'); 3 | 4 | Session.prototype.fetch = function (input: RequestInfo, init?: RequestInit) { 5 | return fetchWithSession(input, init, this); 6 | }; 7 | 8 | export default { 9 | fromPartition, 10 | get defaultSession () { 11 | return fromPartition(''); 12 | } 13 | }; 14 | -------------------------------------------------------------------------------- /shell/browser/feature_list.h: -------------------------------------------------------------------------------- 1 | // Copyright (c) 2019 GitHub, 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 ELECTRON_SHELL_BROWSER_FEATURE_LIST_H_ 6 | #define ELECTRON_SHELL_BROWSER_FEATURE_LIST_H_ 7 | 8 | namespace electron { 9 | void InitializeFeatureList(); 10 | void InitializeFieldTrials(); 11 | } // namespace electron 12 | 13 | #endif // ELECTRON_SHELL_BROWSER_FEATURE_LIST_H_ 14 | -------------------------------------------------------------------------------- /spec/api-view-spec.ts: -------------------------------------------------------------------------------- 1 | import { closeWindow } from './lib/window-helpers'; 2 | import { BaseWindow, View } from 'electron/main'; 3 | 4 | describe('View', () => { 5 | let w: BaseWindow; 6 | afterEach(async () => { 7 | await closeWindow(w as any); 8 | w = null as unknown as BaseWindow; 9 | }); 10 | 11 | it('can be used as content view', () => { 12 | w = new BaseWindow({ show: false }); 13 | w.setContentView(new View()); 14 | }); 15 | }); 16 | -------------------------------------------------------------------------------- /spec/fixtures/api/singleton/main.js: -------------------------------------------------------------------------------- 1 | const { app } = require('electron'); 2 | 3 | app.whenReady().then(() => { 4 | console.log('started'); // ping parent 5 | }); 6 | 7 | const gotTheLock = app.requestSingleInstanceLock(); 8 | 9 | app.on('second-instance', (event, args, workingDirectory) => { 10 | setImmediate(() => { 11 | console.log(JSON.stringify(args)); 12 | app.exit(0); 13 | }); 14 | }); 15 | 16 | if (!gotTheLock) { 17 | app.exit(1); 18 | } 19 | -------------------------------------------------------------------------------- /spec/fixtures/pages/key-events.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 11 | 12 | 13 | -------------------------------------------------------------------------------- /docs/api/structures/referrer.md: -------------------------------------------------------------------------------- 1 | # Referrer Object 2 | 3 | * `url` string - HTTP Referrer URL. 4 | * `policy` string - Can be `default`, `unsafe-url`, 5 | `no-referrer-when-downgrade`, `no-referrer`, `origin`, 6 | `strict-origin-when-cross-origin`, `same-origin` or `strict-origin`. 7 | See the [Referrer-Policy spec][1] for more details on the 8 | meaning of these values. 9 | 10 | [1]: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy 11 | -------------------------------------------------------------------------------- /docs/fiddles/ipc/pattern-3/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |
Hello World!
11 | 12 | 13 | 14 | -------------------------------------------------------------------------------- /spec/fixtures/module/access-blink-apis.js: -------------------------------------------------------------------------------- 1 | window.delayed = true; 2 | 3 | global.getGlobalNames = () => { 4 | return Object.getOwnPropertyNames(global) 5 | .filter(key => typeof global[key] === 'function') 6 | .filter(key => key !== 'WebView') 7 | .sort(); 8 | }; 9 | 10 | const atPreload = global.getGlobalNames(); 11 | 12 | window.addEventListener('load', () => { 13 | window.test = { 14 | atPreload, 15 | atLoad: global.getGlobalNames() 16 | }; 17 | }); 18 | -------------------------------------------------------------------------------- /spec/fixtures/module/fork_ping.js: -------------------------------------------------------------------------------- 1 | const path = require('path'); 2 | 3 | process.on('uncaughtException', function (error) { 4 | process.send(error.stack); 5 | }); 6 | 7 | const child = require('child_process').fork(path.join(__dirname, '/ping.js')); 8 | process.on('message', function (msg) { 9 | child.send(msg); 10 | }); 11 | child.on('message', function (msg) { 12 | process.send(msg); 13 | }); 14 | child.on('exit', function (code) { 15 | process.exit(code); 16 | }); 17 | -------------------------------------------------------------------------------- /spec/fixtures/apps/self-module-paths/renderer.js: -------------------------------------------------------------------------------- 1 | const { ipcRenderer } = require('electron'); 2 | 3 | const worker = new Worker('worker.js'); 4 | 5 | worker.onmessage = (event) => { 6 | const workerPaths = event.data.sort().toString(); 7 | const rendererPaths = self.module.paths.sort().toString(); 8 | const validModulePaths = workerPaths === rendererPaths && workerPaths !== 0; 9 | 10 | ipcRenderer.invoke('module-paths', validModulePaths); 11 | worker.terminate(); 12 | }; 13 | -------------------------------------------------------------------------------- /spec/fixtures/pages/webview-did-attach-event.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 |Recent Documents
10 |11 | Right click on the app icon to see recent documents. 12 | You should see `recently-used.md` added to the list of recent files 13 |
14 | 15 | 16 | -------------------------------------------------------------------------------- /spec/fixtures/crash-cases/setimmediate-window-open-crash/index.js: -------------------------------------------------------------------------------- 1 | const { app, BrowserWindow } = require('electron'); 2 | 3 | function createWindow () { 4 | const mainWindow = new BrowserWindow({ 5 | webPreferences: { 6 | nodeIntegration: true, 7 | contextIsolation: false 8 | } 9 | }); 10 | 11 | mainWindow.on('close', () => { 12 | app.quit(); 13 | }); 14 | 15 | mainWindow.loadFile('index.html'); 16 | } 17 | 18 | app.whenReady().then(() => { 19 | createWindow(); 20 | }); 21 | -------------------------------------------------------------------------------- /shell/browser/ui/tray_icon_win.cc: -------------------------------------------------------------------------------- 1 | // Copyright (c) 2014 GitHub, Inc. 2 | // Use of this source code is governed by the MIT license that can be 3 | // found in the LICENSE file. 4 | 5 | #include "shell/browser/ui/win/notify_icon.h" 6 | #include "shell/browser/ui/win/notify_icon_host.h" 7 | 8 | namespace electron { 9 | 10 | // static 11 | TrayIcon* TrayIcon::Create(absl::optional