1.7.8 1.7.6 1.7.5 1.6.11 1.6.10 1.6.9 1.6.8 1.6.7 1.6.6 1.6.5 1.6.2 1.6.1 1.4.16 1.4.15 1.4.14 1.4.13 1.4.12 1.4.11 1.4.10 1.4.8 1.4.7 1.4.6 1.4.5 1.4.4 1.4.3 1.4.2 1.4.1 1.4.0 1.3.15 1.3.14 1.3.13 1.3.12 1.3.10 1.3.9 1.3.8 1.3.7 1.3.6 1.3.5 1.3.4 1.3.3 1.3.2 1.3.1 1.3.0 1.2.8 1.2.7 1.2.6 1.2.5 1.2.4 1.2.3 1.2.2 1.2.1 1.2.0 1.1.3 1.1.2 1.1.1 1.1.0 1.0.2 1.0.1 1.0.0 0.37.8 0.37.7 0.37.6 0.37.5 0.37.4 0.37.3 0.37.2 0.37.1 0.37.0 0.36.12 0.36.11 0.36.10 0.36.9 0.36.8 0.36.7 0.36.6 0.36.5 0.36.4 0.36.3 0.36.2 0.36.1 0.36.0 0.35.6 0.35.5 0.35.4 0.35.3 0.35.2 0.34.5
Installing the electron module as a development dependency in your project will let you use Electron from the command line at specific versions. More information on the module's repository.
$ npm install --save-dev electron
# Launch from inside your project's directory:
$ ./node_modules/.bin/electron .app.makeSingleInstance hanging. #10586WebContents #9819code and domain as properties to error events emitted by autoUpdater module #10125TouchBarScrubber.continuous was getting ignored #10133accept file types #10015BrowserView.fromId() which returned the BrowserView with the given id #10039BrowserWindow.addExtension, BrowserWindow.removeExtension, BrowserWindow.getExtensions to add/remove/get Chrome extensions in an Electron app #9918treatPackageAsDirectory flag to dialog.showOpenDialog, in order to treat packages, such as .app folders, as a directory instead of a file #9834nativeWindowOpen could
lose their configured webContents options when navigating URLs. #9972<input> elements using accept attributes. #9745show() on a modal window would cause the
parent window to not be re-enabled when the modal was closed. #9962alwaysOnTop windows would not reappear correctly
after being restored from a miniaturized position. #9695Tray objects not properly dispatching a click event when the first
subitem was selected. #9967app.disableDomainBlockingFor3DAPIs() API to disable the Chrome
behavior of disabling 3D APIs for domains where the GPU process crashes
too frequently. #10003new-window event now supports configuring the webPreferences of
the window being opened from a window using the sandbox or
nativeWindowOpen options. #9972subtitle option is now supported when creating notifications. #9903fullscreenWindowTitle option to the BrowserWindow constructor
to show the window title when in fullscreen for windows using a custom
titleBarStyle. #9788plugins setting
is disabled on the BrowserWindow. #9564electron.d.ts TypeScript definition file. https://github.com/electron/electron/pull/9484beforeunload would not correctly fire after
reloading. #9292app.getAppMemoryInfo() API with memory details for each process
associated with the app. #9214process.getCPUUsage() and process.getIOCounters() APIs. #9373process.getProcessMemoryInfo() and process.getSystemMemoryInfo() are now
callable from sandboxed renderer processes. #9333electron.d.ts, is now provided with each
release. #7857TouchBarSegmentedControl
items via a new mode property. #9315dialog.showCertificateTrustDialog() API. #9242alert, confirm,
open, history.go, and postMessage would throw errors in the main process
instead of the renderer processes when the arguments were invalid. #9252chrome-devtools: URLs would incorrectly override certain window options. #9278window.open would
throw errors in the main process. #9287sandbox option enabled. #9314postMessage across windows where the
targetOrigin parameter was not correctly compared against the source
origin. #9301webPreferences in the features parameter
to window.open would throw an error in the main process. #9289Error emitted on autoUpdater error events
would be missing the message and stack properties when serialized to JSON
or sent over IPC. #9255require is now set to the application root
for non-file: URLs such as about:blank. #9095javascript option is now disabled in windows opened from a window that
already has it disabled, similar to the nodeIntegration option. #9250sheet-begin and sheet-end events are now emitted by BrowserWindow
instances when dialog sheets are presented/dismissed. #9108session-end event is now emitted by BrowserWindow instances when the
OS session is ending. #9254app.exit() did not close all open windows. #9133scrollBounce to true did not enable it. #9134dialog.showMessageBox. #9187xinput1_3.dll from the distribution. #9157BrowserView class that is an alternative to the
<webview> tag. #9166flushStore(callback) API to the Cookies module that writes
any unwritten cookie data to disk. #9194iconPosition property to TouchBarButton items to change the icon
position. #9208remote module issue where errors thrown in the main process while
setting remote properties would not be re-thrown in the renderer process.
#9097remote module issue where certain remote objects could not be set as
remote properties. #9101--eval argument would not receive messages. #9132kioclient will now be used on KDE when shell.moveItemToTrash is called.
#8528dialog.showCertificateTrustDialog API that prompts the user
to accept a self-signed or untrusted certificate. #9099esc button on the touch bar with a custom
item. #9023ffmpeg that
does not include proprietary codecs. #9057<webview> tags. #9037net module
and the response’s content encoding was not supported. #9001net module requests did not support non-string
header values. #9062& characters could not be used in top-level
menu item labels. #8984crashReporter module is now available in sandboxed renderer processes.
#8956net module.
#9007editMenu and windowMenu menu item roles that include the standard
OS submenu items. #8880tabbingIdentifier option to the BrowserWindow
constructor that enables groupable native tabs on macOS 10.12+. #9052uploadToServer option to crashReporter.start is now supported. #9053Buffer global would be unavailable in modules
required from preload scripts when node integration was disabled. #8758<webview> tags were in a page. #8742async option to the menu.popup API that causes the method
to return immediately instead of after the menu is closed on all platforms
and also no longer blocks rendering updates on macOS. #8702dialog.showMessageBox API now supports the cancelId property
similar to other platforms. #8733Buffer class is no longer available on the window global when
Node integration is disabled. #8605coffee-script, threw errors
when required. #8618minimumFontSize, defaultFontSize, and defaultMonospaceFontSize
settings can now be configured via the webpreferences attribute of a
<webview> tag. #8542titleBarStyle value of hidden-inset did not work on
certain OS versions. #8619scroll-touch-end event not firing. #8673BrowserWindow.setVibrancy not working on certain OS versions. #8717app.getFileIcon(path, callback) API to get the native icon for a
file type. #7851session.setCertificateVerifyProc API is now
provided the certificate verification result and can be rejected with any
error code supported by Chrome. #7955dialog.showMessageBox API now supports showing a checkbox with a
message in the dialog. The state of the checkbox will be provided to the
callback. #8590webContents now emits a will-attach-webview event that can be used to
configure the settings of a<webview> tag before it is attached.
Calling event.preventDefault() will destroy the <webview>. #8584webContents are now persisted in a session on a
per-origin basis. #8537webContents.invalidate() on non-offscreen pages to
schedule a paint of the entire view. #8628dialog.showSaveDialog now supports message, nameFieldLabel, and
showsTagField options. #8556dialog.showOpenDialog now supports a message option. #8556dialog.showOpenDialog now supports a noResolveAliases property to
disable automatic alias (symlink) resolution. #8617crashReporter.setExtraParameter API to adjust the extra data sent
on crashes. #8648preventDefault() on a new-window event for
a sandboxed window. #8377webm
videos would not play. #8428contextIsolation option to BrowserWindow and <webview> tags
that loads the preload script and Electron APIs into a separate JavaScript
context that is isolated from the main page’s JavaScript context. #8348<webview> element now emits the context-menu event from the
underlying webContents object.will-navigate event
listener. #8254backgroundThrottling option is now correctly persisted across window
reloads. #8298Cookie header is now settable on requests made using Electron’s net
module. #8258session.enableNetworkEmulation API would lead to
high CPU usage. #8371defaultFontFamily option in the BrowserWindow constructor now supports
setting the default cursive and fantasy fonts. #8295normalizeAccessKeys option to the dialog.showMessageBox API that
normalizes keyboard accelerator keys used for buttons across platforms. #8308window.alert and window.confirm are now supported in <iframe> tags
and sandboxed windows. #8341undefined. #8189ipcRenderer event listener or setImmediate call is
now recorded correctly in the Dev Tools timeline. #8159protocol.interceptHttpProtocol now supports a custom session. #8085webContents now emits a before-input-event event that can be used to intercept
keyboard events before they are handled by the page. Calling
event.preventDefault() will cause the event to not be delivered to the
page. #8143.select-client-certificate event callback is
now optional. #8134dialog.showMessageBox. #8187nativeImage.createFromBuffer can now be called with bitmap buffers. #8175protocol.registerStandardSchemes with {secure: true} as the second
argument. #7947session.createInterruptedDownload to enable resuming a previously
interrupted download. #8061session.clearAuthCache to enable clearing a session’s HTTP
authentication cache. #8107window.alert, window.close, and window.confirm did
not behave as expected. #8120KeyboardEvent.key value would be incorrect when Control was pressed
on Linux using certain keyboard layouts. #8147dialog APIs no longer write values back into the specified options
object parameter. #8123BrowserWindow.fromDevToolsWebContents would throw an
error. #8144BrowserWindow.setAutohideCursor to change the setting dynamically.
#8092BrowserWindow.closeFilePreview to close the Quick Look preview
previously opened with BrowserWindow.previewFile. #8038systemPreferences.setUserDefault to be able to change the user
preference defaults. #8084crashReporter.get/setUploadToServer to dynamically configure the
setting. Also Renamed the autoSubmit option to uploadToServer in
crashReporter.start. The old option name is still available for
backwards-compatibility but will be removed in Electron 2.0. #7952BrowserWindow.setAppDetails to configure the properties of the
window’s taskbar button. #7952minWidth was used. #8047systemPreferences.getUserDefault would crash when
requesting a value as an array or dictionary. #7993chrome.runtime.onMessage used by dev tools extensions
now supports a response callback parameter. #7974toggledevtools and reload are now supported menu item roles. #7981setLayoutZoomLevelLimits method to webFrame, webContents, and
<webview> that can be used to set the layout-based zoom level limits of a
page. The setZoomLevelLimits API has been deprecated and renamed to
setVisualZoomLeveLimits to control the pinch-to-zoom level.
setZoomLevelLimits will be completely removed in Electron 2.0. #8041shell.openExternal is now asynchronous if the final specified argument is
a callback function. #7612zoomToPageWidth option was added to the BrowserWindow constructor that
controls how the window resizes when running the Window > Zoom menu item or
when option-clicking the green stoplight toolbar button. #7776NSAllowsArbitraryLoads to the app’s plist file. #7933BrowserWindow by calling
setVibrancy(vibrancyType) or by including a vibrancy value in the
constructor options. #7898POST data when calling BrowserWindow.loadURL via the
postData option. Also <form> tags configured with method=post will now
make POST requests with their data when submitted. #7540session.setCertificateVerifyProc callback
now includes the entire certificate chain. #7917<webview> tag now supports a disableguestresize attribute that will
disable automatic resizing of the guest webContents when the <webview>
element resizes. You can now call setSize directly on the guest
webContents to manually control the size. #7658chrome.storage.remove and chrome.storage.clear APIs are now available
to DevTools extensions. #7923about: protocol is now correctly supported by default. #7908ELECTRON_NO_ASAR environment
variable is now cached for better performance. #7978app.setAboutPanelOptions(options) with a
credits value. #7979window.opener API did not behave as expected.53.0.2785.143 from 53.0.2785.113. #7906webContents.executeJavaScript now returns a Promise that resolves to the
value returned by the specified code block. Previously this method did not
return a value. The callback option is still supported. #7533<webview> tags would be cleared or refreshed
incorrectly when toggling the visibility or attaching/detaching. #7852disturl option to NPM when compiling native modules to be used in Electron.
#7881setCertificateVerifyProc on a session. #7651net module that exposes Chrome’s native network APIs, available
via require('electron').net in the main process. #7577webFrame.registerURLSchemeAsPrivileged. #7665webpreferences attribute to <webview> tags that can
be used to set additional options similar to the webPreferences option on
the BrowserWindowconstructor. #7631clipboard module for reading from and writing to the
find pasteboard, available as clipboard.readFindText/writeFindText. #7719BrowserWindow.previewFile that opens a file in the native Quick Look
view. #7592Changelog:
ELECTRON_NO_ASAR environment variable. #7479window.open. #7520temp directory configured by user. #7500webContents.openDevTools([options]) ignoring docks state. brightray#254Tab not working as keyCode in webContents.sendInputEvent(event) API. #7500MenuItem. #7498Windows
isInvertedColorScheme() method and inverted-color-scheme-changed event to the systemPreferences module. #7518getColor(name) method and color-changed event to the systemPreferences module. #7561Linux
Chromium. #7524macOS
app.setAboutPanelOptions(options) API. #7549Changelog:
additionalFeatures parameter for new-window event. #7291event.newGuest property for the event object of new-window event. #7407crop, resize, getAspectRatio methods to NativeImage. #7488window.open. #7432Buffer from native land to JavaScript. #7452Windows
LargeAddressAware for 32bit build. brightray#253Changelog:
sandbox option in webPreferences which allows sandboxing for renderers. #6919level parameter for win.setAlwaysOnTop(flag[, level]) API. #7296changed event for cookies module. #7398macOS
Show Tab Bar menu item on macOS Sierra. #7415Windows
Linux
Changelog:
guestinstance attribute to <webview> tag which allows moving WebContents betweens <webview>s. #7157ses.getBlobData(identifier, callback) API to read uploaded data in protocol. #6941contents.invalidate() API. #7062killed parameter for crashed and gpu-process-crashed events. #7241GOOGLE_API_KEY environment variable to specify custom Google API key. #7276beginFrameSubscription not working correctly for HiDPI screens. #7163net::ERR_INSECURE_RESPONSE error when visiting some websites. #7221Linux
kioclient, kioclient5 and trash-cli in shell.moveItemToTrash(path) API. #7178macOS
scroll-touch-edge event for BrowserWindow and fix regressions of scroll-touch-begin/end events. #7239Windows
Ctrl+Y as the default accelerator of redo menu role. #7236getAccentColor method and accent-color-changed event to systemPreferences module. #7173Changelog:
remote module bug fixes from 1.4.x release line. #9240window.alert, window.close, and window.confirm did
not behave as expected. #8120KeyboardEvent.key value would be incorrect when Control was pressed
on Linux using certain keyboard layouts. #8147setLayoutZoomLevelLimits method to webFrame, webContents, and <webview> that can be used to set the layout-based zoom level limits of a page. The setZoomLevelLimits API has been deprecated and renamed to setVisualZoomLeveLimits to control the pinch-to-zoom level. setZoomLevelLimits will be completely removed in Electron 2.0. #8041Changelog:
Windows
Changelog:
Changelog:
devtools option to webPreferences. #7096shell.showItemInFolder and shell.openItem. #7182execSync throws. #7116process.stdin in renderer process. #7130<webview> loading host URL when src is empty. #7146history.replaceState is used. #7175macOS
userInfo parameter to ready event of app. #7053titleBarStyle: 'hidden-inset' on OS X 10.9. #7077Changelog:
Buffer with remote module. #6963inspectElement after openDevTools. #6940webkitRequestFileSystem not working in custom protocols. #6952null. #6977downloadItem.setSavePath not working when server returns 404 status. #6983--debug-brk not stopping on first line. #7001process.exit() not accepting empty arguments. #7028beginFrameSubscription not working for the WebContents of <webview>. libchromiumcontent#227Linux
armv7l as filename suffix. #6986win.setFullScreen(false) not working. #6961Windows
app.getJumpListSettings() and app.setJumpList(categories) APIs. #6826Changelog:
String instead of Buffer to represent certificate data. #6814, #6881isMainFrame parameter to the did-navigate-in-page event. #6810hasImageContents parameter of context-menu event being wrong. #6817win.location for objects returned by window.open. #6861webRequest.onBeforeSendHeaders API drops headers with “.” in the name. #6856fetch in renderer process. #6926ses.enableNetworkEmulation not working with default options. #6935macOS
titleBarStyle: 'hidden' on OS X 10.9. #6848setClosable, setMaximizable and setMinimizable APIs. #6850Windows
path and args parameters to app.setAsDefaultProtocolClient API. #6858win.setSkipTaskbar(skip). #6829Changelog:
view-painted event which was introduced in v1.3.1 and didn’t work. #6705win.setContentBounds(options[, animate]) and win.getContentBounds() APIs. #6654image.getBitmap() API. #6733zoomin, zoomout, resetzoom to MenuItem’s roles. #6777ipc module. #6776macOS
systemPreferences.isSwipeTrackingFromScrollEventsEnabled() API. #6686systemPreferences.postNotification(event, userInfo) and systemPreferences.postLocalNotification(event, userInfo) APIs. #6752autoUpdater. #6743startspeaking and stopspeaking to MenuItem’s roles. #6765resizable: false option disabling the fullscreen button. #6664scroll-touch-begin and scroll-touch-end events being emitted when scrolling page. #6754Windows
app.setUserTasks(tasks) API. #6766win.setThumbnailToolTip(toolTip) API. #6762autoUpdate.checkForUpdates() for twice making quitAndInstall() throw errors. #6780win.setThumbnailClip(region) API not recognizing high-DPI displays. #6782Changelog:
downloadItem.getSavePath() API. #6629image.toBitmap() API. #6661size, hotspot parameters to the cursor-changed event of WebContents. #6661setZoomFactor, getZoomFactor, setZoomLevel, getZoomLevel, setZoomLevelLimits methods to WebContents. #6685LICENSES.chromium.html being empty. libchromiumcontent#225Session being garbage collected. #6674contents.sendInputEvent(event) API. #6661Windows
shell.writeShortcutLink(shortcutPath[, operation], options) and shell.readShortcutLink(shortcutPath) APIs. #6623macOS
app.dock.isVisible() API. #6683Linux
Changelog:
view-painted event to WebContent. #6524proxyBypassRules option to ses.setProxy(config, callback) API. #6558remote module. #6572, #6590contents.copyImageAt(x, y) API. #6619<input> tag on DevPanel. brightray#238fs.access/accessSync not working with asar archives. #6598Windows
crashReporter.start(options) for multiple times. #6618macOS
Changelog:
Changelog:
options parameter for the session.fromPartition(''[, options]) API. #6470certificate object of certificate-error event. #6474autoUpdater.getFeedURL() API. #6486getAllWebContents() and getFocusedWebContents() APIs to webContents module. #6489macOS
Windows
win.setThumbnailClip(region) API. #6497Changelog:
capturePage method to WebContents class and <webview> tag. #6355showHiddenFiles to dialog.showOpenDialog(options)’s properties. #6431app.getLoginItemSettings() and app.setLoginItemSettings(settings) APIs. #6375, #6444accessibility-support-changed event and isAccessibilitySupportEnabled() method to app module. #6446unresponsive event. #6432null when passing the same Array for multiple times in remote module. #6442macOS
win.setBounds(bounds) API ignore maximum/minimum sizes. #6363Linux
console.log after relaunch. #6412Windows
thickFrame option for BrowserWindow. #6412toolbar to BrowserWindow’s type. #6428shell.openExternal(url) not working with non-ASCII characters. #6436Changelog:
require. #6213webContents.startDrag(item) API. #6333clipboard.readBookmark() and clipboard.writeBookmark(title, url) APIs. #6233onlyDirty pararmeter to webContents.beginFrameSubscription([onlyDirty ,]callback) API. #6164app.setBadgeCount(count) and app.getBadgeCount() APIs. #6243 #6309did-fail-load event emitting for canceled requests. #6201Promise not resolved in native handlers of the main process. #6220package.json includes BOM. #6354Windows
PDB files in releases. #6225ICO files. #6220tray.popUpContextMenu(menu) not popUpping menu when menu is not passed. #6280Linux
app.isUnityRunning() API. #6243dialog.showOpenDialog() replacing extensions of filenames ending with .*.gz. #6305icon property of BrowserWindow not working. #6323Changelog:
accelerator and label are now optional when role is specified for MenuItem. #6190event parameter for click handler of MenuItem. #6170session.setUserAgent(userAgent[, acceptLanguages]) API. #6172win.setContentProtection(enable) API. #6175protocol module not being set. #6195macOS
maximize event being emitted before window is maximized. #6171Linux
Changelog:
tray.getBounds() API. #6159quit, togglefullscreen roles to MenuItem. #6154 #6166protocol module not being set. #6095<webview> tag having wrong size when transform style is applied. #6128Promise being treated as unhandled rejection in the main process. #6151role when menu.insert(item) is used. #6169macOS
systemPreferences.subscribeLocalNotification(event, callback) and
systemPreferences.unsubscribeLocalNotification(id) APIs. #6150Window menu. #6089, #6097win.setProgressBar after app.dock.setIcon. #6091Delete not working as accelerator. #6168Linux
Windows
Tray not respecting scale factor.Changelog:
ready-to-show event to BrowserWindow. #6026--abi command line switch to default app. #5911showDefinitionForSelection() method to WebContents and <webview> tag. #5921pepperFlashSystemPlugin to the paths of app.getPath(name) API. #5943protocol property to Session to allow custom protocol for partition. #5904isPaused, canResume, getState APIs to DownloadItem. #5959chrome.* APIs for devtools extensions. #5924BrowserWindow.getDevToolsExtensions() API. #5965focusable option to BrowserWindow. #6023web-contents-created event to app. #6029<webview> tag. #5913partition. #5904window.opener being null in window opened by <webview> tag. #5953OS X
requestHeaders parameter for autoUpdater.setFeedURL(url[, requestHeaders]) API. #5879maximizable: false not working for frameless window. #5944Windows
win.setFocusable(focusable) API. #6013 #6023autoUpdater not waiting for current app to quit before launching newly installed app. #6037Changelog:
app.relaunch([options]) API. #5837array and dictionary types in systemPreferences.getUserDefault(key, type) API. #5833pasteandmatchstyle and delete roles to MenuItem. #5870app.disableHardwareAcceleration() API. #5889update-target-url event to WebContents and <webview> tag. #5903disableBlinkFeatures option to webPreferences of BrowserWindow. #5923disableBlinkFeatures attribute to <webview> tag. #5923fetch in custom protocols. #5932OS X
Linux
BrowserWindow.focus() not moving focus to the window. #5888Changelog:
mimeType is not defined in the handler of protocol.registerBufferJob API. #5711app.releaseSingleInstance() API. #5720select-bluetooth-device event to WebContents. #5781preload script not working when webSecurity: false is set. #5768protocol.registerHttpProtocol not working when the target URL redirects. #5753remote module. #5736print() method not available for the window returned by window.open. #5737Windows
fullscreen: false option also setting fullscreenable: false in BrowserWindow. #5718OS X
BrowserWindow.setAspectRatio(0) #5734Changelog:
beforeunload handler nows prevents the page to unload. #5648Promise is detected in remote module. #5689webpageURL parameter to app.setUserActivity(type, userInfo[, webpageURL]) API. #5658document.visibilityState and visibilitychange event not working in <webview> tag. #5684app.quit() while there are BrowserWindows with closable set to false. #5701Migration Notice:
true in beforeunload handler now prevents the page to unload. #5648ATOM_SHELL_INTERNAL_RUN_AS_NODE environment variable has been removed, the code relies on it should use the public ELECTRON_RUN_AS_NODE environment variable instead. #5682ATOM_SHELL_ environment variables have been renamed, if you are maintaining your own Electron fork, you might be affected. #5683Changelog:
Windows
Changelog:
BrowserWindow.setIcon(icon) API. #5624Session.allowNTLMCredentialsForDomains(domains) API, and mark app.allowNTLMCredentialsForDomains(domains) as deprecated. #5638did-fail-load event being empty. #5634require('electron') being able to be overridden by npm modules.
#5662remote module not handling rejection of Promise in the main process. #5666Windows
OS X
offsetX parameter to BrowserWindow.setSheetOffset(offsetY[, offsetX]) API. #5603BrowserWindow.setAspectRatio(ratio) not correctly implemented. #5644Linux
ffmpeg not stripped. #5668Changelog:
<webview> tag when nodeIntegration is off in host window. #5559--disable-http2 command line switch. electron/brightray#222webFrame.getResourceUsage() and webFrame.clearCache() APIs. #5413buttonLabel option to dialog.showOpenDialog(options) and dialog.showSaveDialog(options). #5509Invalid package error when there is asar path in the command passed to child_process.exec. #5571<webview> tag not inheriting host window’s zoom level. #5616OS X
temporary-exception.
#5584, #5601systemPreferences.subscribeNotification(event, callback) now accepts event and userInfo parameters. #5582titleBarStyle option makes the top of window draggable. #5557Windows
Linux
libnotify.so.4 on some distributions. electron/brightray#221Changelog:
Windows
Changelog:
protocol module to be imported before the ready event of app module. #5406context-menu event to WebContents. #5379process.defaultApp property. #5421protocol.registerStandardSchemes(schemes) not working. #5406expirationDate not showing for persistent cookies in session.cookies.get API. #5444protocol.registerStandardSchemes(schemes) not working. #5406OS X
scrollBounce option to webPreferences. #5412app.setUserActivity(type, userInfo), app.getCurrentActivityType() APIs and continue-activity event for Handoff feature of OS X. #5352app.dock.downloadFinished(filePath) API. #5477app.removeAsDefaultProtocolClient(protocol) API not working. #5440Linux
dialog.showMessageBox() to a suitable size. #5496Changelog:
Changelog:
Migration notice:
BrowserWindow have been removed but there
were no deprecation warnings in previous versions, you should use the
corresponding events in webContents instead:
crashdevtools-focuseddevtools-openeddevtools-closedNativeImage.toDataUrl has been removed but there were no deprecation
warnings in previous versions, you should use toDataURL instead.Changelog:
userData directory is created during the ready event of app module. #5340autoUpdater.quitAndInstall() is called while there is no update. #5287systemPreferences module. #5282app.isDefaultProtocolClient(protocol) API. #5302app.makeSingleInstance(callback) wrongly returning true on first launch. #5311will-download event not emitted for HTML pages. #5315webContents.executeJavaScript not working after being called immediately after loadURL. #5319desktopCapturer.getSources not responding when there is subsequent calls with different arguments. #5320OS X
Command Plus accelerator appearing as Shift Command = in menu. #5298Windows
display-removed event not working. #5334Changelog:
mode option to webContents.openDevTools(options) API.openExternal type of permission parameter to Session.setPermissionRequestHandler(handler) API.process.windowsStore property to determine whether the app is an Windows Store app.devToolsWebContents.hostWebContents.session.enableNetworkEmulation(options) API not working.WebContents.executeJavaScript(code) not working when called during a resource load after page is loaded.app.setPath to change the location of userData directory, a folder is still created at the default location.Windows
Linux
append hint when showing notifications.app.importCertificate(options, callback) API.OS X
BrowserWindow.setSheetOffset(offset) for changing the offset when showing sheet.app.makeSingleInstance with Mac App Store build.Changelog:
will-quit when app.exit() is called.isMainFrame parameter to did-fail-load event of WebContents.statusLine property to webRequest.OnHeadersReceived API’s responseHeaders object.backgroundThrottling option to webPreferences of BrowserWindow.resourceType parameter to did-get-response-details event of WebContents.<webview> and preload script not working when there is no script tag in page.webRequest.onHeadersReceived API modifying original headers’ status line.did-fail-load and did-finish-load events.Windows
blur event handler.OS X
backgroundColor of BrowserWindow not displaying correctly.Linux
xdg-open to exit when calling shell.openExternal.tag property of HTML5 Notification API.Changelog:
Buffer with large size.Changelog:
asar archive.atom.asar in the resources directory is renamed to electron.asar.window.open when node integration is disabled in parent window.app.setAsDefaultProtocolClient(protocol) and app.removeAsDefaultProtocolClient(protocol) APIs.disposition parameter of new-window event for certain types of background types.OS X
swipe event to BrowserWindow.backgroundColor option of BrowserWindow not working.Changelog:
<webview>’s background is now transparent by default.NativeImage.getNativeHandle() API.-i/--interactive flag to default app that starts a repl for the main process.remote module.accelerator is undefined when calling Menu.buildFromTemplate.Windows
Changelog:
activeMatchOrdinal property in the result object of found-in-page event.Changelog:
OS X
libffmpeg.dylib image not found error on startup.Windows
Changelog:
Changelog:
remote module.Windows
Changelog:
show and hide events to BrowserWindow.document.hidden.visibilitychange event not working.select-client-certificate event’s callback.PrintScreen not working as accelerator.<webview> inside flexbox... in file path.Linux
resizable option not working.Windows
fullscreenable option work.OS X
platform-theme-changed event to app module.app.isDarkMode() API.Cmd+~ cycling windows in wrong direction.BrowserWindow.isMaximized() returning wrong result when window is not resizable.Changelog:
WebContents.beginFrameSubscription becomes faster and gets better image quality.callback parameter for webContents.executeJavaScript and <webview>.executeJavaScript.Changelog:
remote module.webContents.hostWebContents property.<webview>.getWebContents() API.remote module.protocol module for certain kind of URLs.Linux
Changelog:
did-fail-load event when invalid URL is passed to BrowserWindow.loadURL.cursor-changed event to WebContents.Session.setPermissionRequestHandler(handler) API.Session.clearHostResolverCache(callback) API.readRtf and writeRtf methods to clipboard module.downloadItem in will-download handler when event.preventDefault is called.WebContents.endFrameSubscription() while there are pending frames.exit event of process object not reliable in renderer process.BrowserWindow.getNativeWindowHandle() returning corrupted buffer.Windows
autoUpdater not accessible in remote module.OS X
app.show and app.hide APIs.icon not working in dialog.showMessageBox(options).Command + ~ not switching windows sometimes.Linux
Changelog:
Object has been destroyed exception in the main process.Windows
Changelog:
setMovable, isMovable, setMinimizable, isMinimizable, setMaximizable, isMaximizable, setFullScreenable, isFullScreenable, setClosable, isClosable, setHasShadow, hasShadow methods to BrowserWindow.scroll-touch-begin and scroll-touch-end events to BrowserWindow.webContents.debugger API.app.dock.setIcon API.uploadData to details of session.webRequest.onBeforeRequest.backgroundColor option of BrowserWindow.OS X
positioningItem parameter for Menu.popup.Windows
autoUpdater throws exception.asar archive.Changelog:
silent property of Notification.defaultFontFamily, defaultFontSize, defaultMonospaceFontSize, minimumFontSize, defaultEncoding options to webPreferences of BrowserWindow.<webview>.loadURL.blinkfeatures attribute for <webview>.OS X
animate parameter for setBounds, setSize, setContentSize, setPosition methods of BrowserWindow.movable option for BrowserWindow.backgroundColor option of BrowserWindow work.Windows
app.isAeroGlassEnabled() API.Changelog:
session.setProxy(config) API now accepts an Object instead of String.BrowserWindow.getFocusedWindow() API now returns null instead of undefined when there is no focused window.session.flushStorageData() API.session.getCacheSize(callback) API.BrowserWindow.getNativeWindowHandle() API.defaultId option for dialog.showMessageBox(options) API.insertText and executeJavaScript methods to webFrame module.insertText method to webContents and <webview>.<webview>.src not working before onload event.Linux
--touch-devices command line switch not working.Windows
Changelog:
isDevToolsFocused method to WebContents and <webview>.did-navigate and did-navigate-in-page events to WebContents and <webview>.will-navigate, devtools-opened, devtools-closed, devtools-focused events to <webview>.blinkFeatures option to webPreferences.overlayScrollbars, sharedWorker, pageVisibility options from webPreferences.fetch for URLs registered as privilege.remote module.capturePage with no rect.protocol.registerHttpProtocol without internet connection.OS X
drop-files not firing when dragging from the dock.app.clearRecentDocuments not working.dialog.showSaveDialog with filters with no extensions.Window menu with no submenu items.Tray.setPressedImage not working after turning off highlight mode.Windows
mkdirp inside an asar archive.dialog.openSaveDialog adding extension to filename when it shouldn’t.Changelog:
did-change-theme-color event to WebContents and <webview>.media-started-playing and media-paused events to WebContents and <webview>.findInPage method to WebContents and <webview>.credentials: 'include' being added to service worker’s headers.document.hidden and document.visibilityState values when window is minimized.webRequest API.webRequest.onBeforeSendHeaders not removing existing headers.OS X
app.dock.show().BrowserWindow with hidden-inset of titleBarStyle.shell.openExternal not working with URLs containing valid URL special characters.Linux
libnotify dynamically instead of linking with the library.Alt not toggling window menu bar.Windows
shell.moveItemToTrash not working on Windows 7.asar archive or the icon’s URL is not file:// scheme.Changelog:
session.webRequest API.A5 to webContents.printToPDF’s pageSize.crashReporter.start now requires passing submitURL and companyName.window.opener a BrowserWindowProxy.Buffers.app.addRecentDocument.x and y options not working in BrowserWindow.capturePage.OS X
xpc_ APIs in MAS build.shell.openExternal not able to open URLs with unescaped characters.Changelog:
desktopCapturer module.protocol.registerServiceWorkerSchemes API.uploadDate property for request object in protocol module.Menu.buildFromTemplate.will-quit event when calling process.exit or app.exit.appData and userData dir values.exit event of process object not including exit code.event.source not matching the object returned by window.open in message event handler.origin string in window.postMessage.OS X
BrowserWindow.setIgnoreMouseEvents API.Enter Full Screen menu item.Changeling:
appData and userData dir values.Changelog:
Windows
shell.moveItemToTrash not working on Windows 7.Changelog:
isDestroy => isDestroyed.Changelog:
menu parameter for Tray.popUpContextMenu API.downloadURL method for WebContents and <webview>.asar support in Node’s built-in modules with process.noAsar.loadURL in the did-fail-load event.page-title-updated event.downloadItem.hasUserGesture.protocol module.window.open not respecting the features string.Windows
child_process.execFile not working for files in asar archive.OS X
Changelog:
--proxy-bypass-list command line switch.ELECTRON_RUN_AS_NODE environment variable.<webview>.child_process.execFile unable to execute files in asar archive.protocol module.dialog module with remote module not working.BrowserWindow.Windows
OS X
LSUIElement is added to main bundle’s Info.plist.Changelog:
OS X