2019-05-21 07:15:57 +00:00
# Breaking Changes
2018-05-29 09:15:30 +00:00
2019-05-02 22:17:17 +00:00
Breaking changes will be documented here, and deprecation warnings added to JS code where possible, at least [one major version ](../tutorial/electron-versioning.md#semver ) before the change is made.
2018-05-29 09:15:30 +00:00
2019-04-25 22:14:19 +00:00
## `FIXME` comments
2018-05-29 09:15:30 +00:00
The `FIXME` string is used in code comments to denote things that should be fixed for future releases. See https://github.com/electron/electron/search?q=fixme
2019-11-08 20:46:35 +00:00
## Planned Breaking API Changes (9.0)
### `<webview>.getWebContents()`
This API, which was deprecated in Electron 8.0, is now removed.
```js
// Removed in Electron 9.0
webview.getWebContents()
// Replace with
const { remote } = require('electron')
remote.webContents.fromId(webview.getWebContentsId())
```
2019-10-09 17:59:08 +00:00
## Planned Breaking API Changes (8.0)
### Values sent over IPC are now serialized with Structured Clone Algorithm
The algorithm used to serialize objects sent over IPC (through
`ipcRenderer.send` , `ipcRenderer.sendSync` , `WebContents.send` and related
methods) has been switched from a custom algorithm to V8's built-in [Structured
Clone Algorithm][SCA], the same algorithm used to serialize messages for
`postMessage` . This brings about a 2x performance improvement for large
messages, but also brings some breaking changes in behavior.
- Sending Functions, Promises, WeakMaps, WeakSets, or objects containing any
such values, over IPC will now throw an exception, instead of silently
converting the functions to `undefined` .
```js
// Previously:
ipcRenderer.send('channel', { value: 3, someFunction: () => {} })
// => results in { value: 3 } arriving in the main process
// From Electron 8:
ipcRenderer.send('channel', { value: 3, someFunction: () => {} })
// => throws Error("() => {} could not be cloned.")
```
- `NaN` , `Infinity` and `-Infinity` will now be correctly serialized, instead
of being converted to `null` .
- Objects containing cyclic references will now be correctly serialized,
instead of being converted to `null` .
- `Set` , `Map` , `Error` and `RegExp` values will be correctly serialized,
instead of being converted to `{}` .
- `BigInt` values will be correctly serialized, instead of being converted to
`null` .
- Sparse arrays will be serialized as such, instead of being converted to dense
arrays with `null` s.
- `Date` objects will be transferred as `Date` objects, instead of being
converted to their ISO string representation.
- Typed Arrays (such as `Uint8Array` , `Uint16Array` , `Uint32Array` and so on)
will be transferred as such, instead of being converted to Node.js `Buffer` .
- Node.js `Buffer` objects will be transferred as `Uint8Array` s. You can
convert a `Uint8Array` back to a Node.js `Buffer` by wrapping the underlying
`ArrayBuffer` :
```js
Buffer.from(value.buffer, value.byteOffset, value.byteLength)
```
Sending any objects that aren't native JS types, such as DOM objects (e.g.
`Element` , `Location` , `DOMMatrix` ), Node.js objects (e.g. `process.env` ,
`Stream` ), or Electron objects (e.g. `WebContents` , `BrowserWindow` ,
`WebFrame` ) is deprecated. In Electron 8, these objects will be serialized as
before with a DeprecationWarning message, but starting in Electron 9, sending
these kinds of objects will throw a 'could not be cloned' error.
[SCA]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
2019-11-07 17:43:19 +00:00
### `<webview>.getWebContents()`
This API is implemented using the `remote` module, which has both performance
and security implications. Therefore its usage should be explicit.
```js
// Deprecated
webview.getWebContents()
// Replace with
const { remote } = require('electron')
remote.webContents.fromId(webview.getWebContentsId())
```
However, it is recommended to avoid using the `remote` module altogether.
```js
// main
const { ipcMain, webContents } = require('electron')
const getGuestForWebContents = function (webContentsId, contents) {
const guest = webContents.fromId(webContentsId)
if (!guest) {
throw new Error(`Invalid webContentsId: ${webContentsId}`)
}
if (guest.hostWebContents !== contents) {
throw new Error(`Access denied to webContents`)
}
return guest
}
ipcMain.handle('openDevTools', (event, webContentsId) => {
const guest = getGuestForWebContents(webContentsId, event.sender)
guest.openDevTools()
})
// renderer
const { ipcRenderer } = require('electron')
ipcRenderer.invoke('openDevTools', webview.getWebContentsId())
```
2019-12-02 21:27:03 +00:00
### `webFrame.setLayoutZoomLevelLimits()`
Chromium has removed support for changing the layout zoom level limits, and it
is beyond Electron's capacity to maintain it. The function will emit a warning
in Electron 8.x, and cease to exist in Electron 9.x. The layout zoom level
limits are now fixed at a minimum of 0.25 and a maximum of 5.0, as defined
[here ](https://chromium.googlesource.com/chromium/src/+/938b37a6d2886bf8335fc7db792f1eb46c65b2ae/third_party/blink/common/page/page_zoom.cc#11 ).
2019-05-09 14:58:02 +00:00
## Planned Breaking API Changes (7.0)
2019-05-21 07:17:08 +00:00
### Node Headers URL
This is the URL specified as `disturl` in a `.npmrc` file or as the `--dist-url`
command line flag when building native Node modules. Both will be supported for
2019-06-21 21:19:21 +00:00
the foreseeable future but it is recommended that you switch.
2019-05-21 07:17:08 +00:00
Deprecated: https://atom.io/download/electron
Replace with: https://electronjs.org/headers
2019-05-09 14:58:02 +00:00
### `session.clearAuthCache(options)`
The `session.clearAuthCache` API no longer accepts options for what to clear, and instead unconditionally clears the whole cache.
```js
// Deprecated
session.clearAuthCache({ type: 'password' })
// Replace with
session.clearAuthCache()
```
2019-05-09 18:48:10 +00:00
### `powerMonitor.querySystemIdleState`
```js
// Removed in Electron 7.0
powerMonitor.querySystemIdleState(threshold, callback)
// Replace with synchronous API
const idleState = getSystemIdleState(threshold)
```
### `powerMonitor.querySystemIdleTime`
```js
// Removed in Electron 7.0
powerMonitor.querySystemIdleTime(callback)
// Replace with synchronous API
const idleTime = getSystemIdleTime()
```
### webFrame Isolated World APIs
```js
2019-11-13 19:11:25 +00:00
// Removed in Electron 7.0
2019-05-09 18:48:10 +00:00
webFrame.setIsolatedWorldContentSecurityPolicy(worldId, csp)
webFrame.setIsolatedWorldHumanReadableName(worldId, name)
webFrame.setIsolatedWorldSecurityOrigin(worldId, securityOrigin)
// Replace with
webFrame.setIsolatedWorldInfo(
worldId,
{
securityOrigin: 'some_origin',
name: 'human_readable_name',
csp: 'content_security_policy'
})
```
2019-07-03 01:22:09 +00:00
### Removal of deprecated `marked` property on getBlinkMemoryInfo
This property was removed in Chromium 77, and as such is no longer available.
2019-11-13 19:11:25 +00:00
### `webkitdirectory` attribute for `<input type="file"/>`
The `webkitdirectory` property on HTML file inputs allows them to select folders.
Previous versions of Electron had an incorrect implementation where the `event.target.files`
of the input returned a `FileList` that returned one `File` corresponding to the selected folder.
As of Electron 7, that `FileList` is now list of all files contained within
the folder, similarly to Chrome, Firefox, and Edge
([link to MDN docs](https://developer.mozilla.org/en-US/docs/Web/API/HTMLInputElement/webkitdirectory)).
As an illustration, take a folder with this structure:
```console
folder
├── file1
├── file2
└── file3
```
In Electron < =6, this would return a `FileList` with a `File` object for:
```console
path/to/folder
```
In Electron 7, this now returns a `FileList` with a `File` object for:
```console
/path/to/folder/file3
/path/to/folder/file2
/path/to/folder/file1
```
Note that `webkitdirectory` no longer exposes the path to the selected folder.
If you require the path to the selected folder rather than the folder contents,
see the `dialog.showOpenDialog` API ([link](https://github.com/electron/electron/blob/master/docs/api/dialog.md#dialogshowopendialogbrowserwindow-options)).
2019-04-25 22:14:19 +00:00
## Planned Breaking API Changes (6.0)
2018-12-17 22:01:00 +00:00
2019-04-25 22:14:19 +00:00
### `win.setMenu(null)`
2019-01-31 18:58:23 +00:00
```js
// Deprecated
win.setMenu(null)
// Replace with
win.removeMenu()
```
2019-04-25 22:14:19 +00:00
### `contentTracing.getTraceBufferUsage()`
2019-02-13 21:24:57 +00:00
```js
// Deprecated
contentTracing.getTraceBufferUsage((percentage, value) => {
// do something
})
// Replace with
contentTracing.getTraceBufferUsage().then(infoObject => {
// infoObject has percentage and value fields
})
```
2019-04-25 22:14:19 +00:00
### `electron.screen` in renderer process
2018-12-17 22:01:00 +00:00
```js
// Deprecated
require('electron').screen
// Replace with
require('electron').remote.screen
```
2019-04-25 22:14:19 +00:00
### `require` in sandboxed renderers
2018-12-17 22:01:00 +00:00
```js
// Deprecated
require('child_process')
// Replace with
require('electron').remote.require('child_process')
// Deprecated
require('fs')
// Replace with
require('electron').remote.require('fs')
// Deprecated
require('os')
// Replace with
require('electron').remote.require('os')
// Deprecated
require('path')
// Replace with
require('electron').remote.require('path')
```
2019-04-25 22:14:19 +00:00
### `powerMonitor.querySystemIdleState`
2019-02-27 20:54:01 +00:00
```js
// Deprecated
powerMonitor.querySystemIdleState(threshold, callback)
// Replace with synchronous API
const idleState = getSystemIdleState(threshold)
```
2019-04-25 22:14:19 +00:00
### `powerMonitor.querySystemIdleTime`
2019-02-27 20:54:01 +00:00
```js
// Deprecated
powerMonitor.querySystemIdleTime(callback)
// Replace with synchronous API
const idleTime = getSystemIdleTime()
```
2019-05-09 14:58:02 +00:00
### `app.enableMixedSandbox`
2019-04-24 04:07:40 +00:00
```js
// Deprecated
app.enableMixedSandbox()
```
Mixed-sandbox mode is now enabled by default.
2019-07-11 15:11:46 +00:00
### `Tray`
Under macOS Catalina our former Tray implementation breaks.
Apple's native substitute doesn't support changing the highlighting behavior.
```js
// Deprecated
tray.setHighlightMode(mode)
// API will be removed in v7.0 without replacement.
```
2019-04-25 22:14:19 +00:00
## Planned Breaking API Changes (5.0)
2018-10-10 05:36:18 +00:00
2019-04-25 22:14:19 +00:00
### `new BrowserWindow({ webPreferences })`
2018-10-10 05:36:18 +00:00
The following `webPreferences` option default values are deprecated in favor of the new defaults listed below.
| Property | Deprecated Default | New Default |
|----------|--------------------|-------------|
| `contextIsolation` | `false` | `true` |
| `nodeIntegration` | `true` | `false` |
| `webviewTag` | `nodeIntegration` if set else `true` | `false` |
2019-04-26 20:30:45 +00:00
E.g. Re-enabling the webviewTag
```js
const w = new BrowserWindow({
webPreferences: {
webviewTag: true
}
})
```
2019-04-25 22:14:19 +00:00
### `nativeWindowOpen`
2018-10-25 06:31:07 +00:00
2019-06-26 04:03:23 +00:00
Child windows opened with the `nativeWindowOpen` option will always have Node.js integration disabled, unless `nodeIntegrationInSubFrames` is `true.
2018-05-29 09:15:30 +00:00
2019-04-25 22:14:19 +00:00
### Privileged Schemes Registration
2019-01-29 07:11:01 +00:00
Renderer process APIs `webFrame.setRegisterURLSchemeAsPrivileged` and `webFrame.registerURLSchemeAsBypassingCSP` as well as browser process API `protocol.registerStandardSchemes` have been removed.
A new API, `protocol.registerSchemesAsPrivileged` has been added and should be used for registering custom schemes with the required privileges. Custom schemes are required to be registered before app ready.
2019-04-25 22:14:19 +00:00
### webFrame Isolated World APIs
2019-02-13 18:05:28 +00:00
```js
// Deprecated
webFrame.setIsolatedWorldContentSecurityPolicy(worldId, csp)
webFrame.setIsolatedWorldHumanReadableName(worldId, name)
webFrame.setIsolatedWorldSecurityOrigin(worldId, securityOrigin)
// Replace with
webFrame.setIsolatedWorldInfo(
worldId,
{
securityOrigin: 'some_origin',
name: 'human_readable_name',
csp: 'content_security_policy'
})
```
2019-06-03 18:56:46 +00:00
## `webFrame.setSpellCheckProvider`
The `spellCheck` callback is now asynchronous, and `autoCorrectWord` parameter has been removed.
```js
// Deprecated
webFrame.setSpellCheckProvider('en-US', true, {
spellCheck: (text) => {
return !spellchecker.isMisspelled(text)
}
})
// Replace with
webFrame.setSpellCheckProvider('en-US', {
spellCheck: (words, callback) => {
callback(words.filter(text => spellchecker.isMisspelled(text)))
}
})
```
2019-04-25 22:14:19 +00:00
## Planned Breaking API Changes (4.0)
2018-05-29 09:17:26 +00:00
2019-01-31 18:58:23 +00:00
The following list includes the breaking API changes made in Electron 4.0.
2018-05-29 09:17:26 +00:00
2019-04-25 22:14:19 +00:00
### `app.makeSingleInstance`
2018-05-29 09:17:26 +00:00
```js
// Deprecated
2018-12-05 12:14:52 +00:00
app.makeSingleInstance((argv, cwd) => {
/* ... */
2018-05-29 09:17:26 +00:00
})
// Replace with
app.requestSingleInstanceLock()
2018-12-05 12:14:52 +00:00
app.on('second-instance', (event, argv, cwd) => {
/* ... */
2018-05-29 09:17:26 +00:00
})
```
2019-04-25 22:14:19 +00:00
### `app.releaseSingleInstance`
2018-05-29 09:17:26 +00:00
```js
// Deprecated
app.releaseSingleInstance()
// Replace with
app.releaseSingleInstanceLock()
```
2019-04-25 22:14:19 +00:00
### `app.getGPUInfo`
2018-10-08 04:06:50 +00:00
```js
app.getGPUInfo('complete')
// Now behaves the same with `basic` on macOS
app.getGPUInfo('basic')
```
2019-04-25 22:14:19 +00:00
### `win_delay_load_hook`
2018-11-20 00:13:50 +00:00
When building native modules for windows, the `win_delay_load_hook` variable in
the module's `binding.gyp` must be true (which is the default). If this hook is
not present, then the native module will fail to load on Windows, with an error
message like `Cannot find module` . See the [native module
guide](/docs/tutorial/using-native-node-modules.md) for more.
2019-04-25 22:14:19 +00:00
## Breaking API Changes (3.0)
2016-09-07 18:41:54 +00:00
2018-06-27 06:47:01 +00:00
The following list includes the breaking API changes in Electron 3.0.
2016-09-07 18:41:54 +00:00
2019-04-25 22:14:19 +00:00
### `app`
2017-05-18 03:01:06 +00:00
```js
// Deprecated
app.getAppMemoryInfo()
// Replace with
app.getAppMetrics()
2018-06-27 06:47:01 +00:00
// Deprecated
const metrics = app.getAppMetrics()
2018-09-13 16:10:51 +00:00
const { memory } = metrics[0] // Deprecated property
2017-05-18 03:01:06 +00:00
```
2019-04-25 22:14:19 +00:00
### `BrowserWindow`
2016-09-08 16:09:49 +00:00
```js
// Deprecated
2018-09-13 16:10:51 +00:00
let optionsA = { webPreferences: { blinkFeatures: '' } }
2016-09-08 16:15:05 +00:00
let windowA = new BrowserWindow(optionsA)
2016-09-08 16:09:49 +00:00
// Replace with
2018-09-13 16:10:51 +00:00
let optionsB = { webPreferences: { enableBlinkFeatures: '' } }
2016-09-08 16:15:05 +00:00
let windowB = new BrowserWindow(optionsB)
2018-05-21 01:52:04 +00:00
// Deprecated
window.on('app-command', (e, cmd) => {
if (cmd === 'media-play_pause') {
// do something
}
})
// Replace with
window.on('app-command', (e, cmd) => {
if (cmd === 'media-play-pause') {
// do something
}
})
2016-09-08 16:09:49 +00:00
```
2019-04-25 22:14:19 +00:00
### `clipboard`
2016-09-08 16:09:49 +00:00
2016-09-07 18:41:54 +00:00
```js
// Deprecated
clipboard.readRtf()
// Replace with
clipboard.readRTF()
// Deprecated
clipboard.writeRtf()
// Replace with
clipboard.writeRTF()
// Deprecated
clipboard.readHtml()
// Replace with
clipboard.readHTML()
// Deprecated
clipboard.writeHtml()
// Replace with
clipboard.writeHTML()
2016-09-08 16:09:49 +00:00
```
2019-04-25 22:14:19 +00:00
### `crashReporter`
2016-11-28 23:06:03 +00:00
```js
// Deprecated
crashReporter.start({
companyName: 'Crashly',
submitURL: 'https://crash.server.com',
autoSubmit: true
})
// Replace with
crashReporter.start({
companyName: 'Crashly',
submitURL: 'https://crash.server.com',
uploadToServer: true
})
```
2019-04-25 22:14:19 +00:00
### `nativeImage`
2016-09-07 18:41:54 +00:00
2016-09-08 16:09:49 +00:00
```js
2016-12-14 18:12:37 +00:00
// Deprecated
nativeImage.createFromBuffer(buffer, 1.0)
// Replace with
nativeImage.createFromBuffer(buffer, {
scaleFactor: 1.0
})
2016-09-08 16:09:49 +00:00
```
2016-09-07 18:41:54 +00:00
2019-04-25 22:14:19 +00:00
### `process`
2018-06-27 06:47:01 +00:00
```js
// Deprecated
const info = process.getProcessMemoryInfo()
```
2019-04-25 22:14:19 +00:00
### `screen`
2016-09-16 22:57:07 +00:00
```js
// Deprecated
2018-03-07 07:06:33 +00:00
screen.getMenuBarHeight()
2016-09-16 22:57:07 +00:00
// Replace with
2018-03-07 07:06:33 +00:00
screen.getPrimaryDisplay().workArea
2016-09-16 22:57:07 +00:00
```
2019-04-25 22:14:19 +00:00
### `session`
2017-02-07 23:44:56 +00:00
```js
// Deprecated
2018-12-05 12:14:52 +00:00
ses.setCertificateVerifyProc((hostname, certificate, callback) => {
2017-02-07 23:44:56 +00:00
callback(true)
})
// Replace with
2018-12-05 12:14:52 +00:00
ses.setCertificateVerifyProc((request, callback) => {
2017-02-07 23:44:56 +00:00
callback(0)
})
```
2019-04-25 22:14:19 +00:00
### `Tray`
2016-09-07 18:41:54 +00:00
2016-09-08 16:09:49 +00:00
```js
2016-09-07 18:41:54 +00:00
// Deprecated
tray.setHighlightMode(true)
// Replace with
tray.setHighlightMode('on')
// Deprecated
tray.setHighlightMode(false)
// Replace with
tray.setHighlightMode('off')
2016-09-08 16:09:49 +00:00
```
2016-09-07 18:41:54 +00:00
2019-04-25 22:14:19 +00:00
### `webContents`
2016-09-08 16:09:49 +00:00
```js
2016-09-07 18:41:54 +00:00
// Deprecated
2018-09-13 16:10:51 +00:00
webContents.openDevTools({ detach: true })
2016-09-07 18:41:54 +00:00
// Replace with
2018-09-13 16:10:51 +00:00
webContents.openDevTools({ mode: 'detach' })
2018-08-23 01:45:43 +00:00
// Removed
webContents.setSize(options)
// There is no replacement for this API
2016-09-07 18:41:54 +00:00
```
2016-11-04 21:30:14 +00:00
2019-04-25 22:14:19 +00:00
### `webFrame`
2016-11-22 16:11:14 +00:00
```js
2016-11-14 18:33:30 +00:00
// Deprecated
webFrame.registerURLSchemeAsSecure('app')
// Replace with
2018-09-13 16:10:51 +00:00
protocol.registerStandardSchemes(['app'], { secure: true })
2016-11-14 18:33:30 +00:00
// Deprecated
2018-09-13 16:10:51 +00:00
webFrame.registerURLSchemeAsPrivileged('app', { secure: true })
2016-11-14 18:33:30 +00:00
// Replace with
2018-09-13 16:10:51 +00:00
protocol.registerStandardSchemes(['app'], { secure: true })
2016-11-22 16:11:14 +00:00
```
2019-04-25 22:14:19 +00:00
### `<webview>`
2018-08-23 01:45:43 +00:00
```js
// Removed
webview.setAttribute('disableguestresize', '')
// There is no replacement for this API
// Removed
webview.setAttribute('guestinstance', instanceId)
// There is no replacement for this API
2018-08-29 06:59:23 +00:00
// Keyboard listeners no longer work on webview tag
webview.onkeydown = () => { /* handler */ }
webview.onkeyup = () => { /* handler */ }
2018-08-23 01:45:43 +00:00
```
2019-04-25 22:14:19 +00:00
### Node Headers URL
2016-11-04 21:30:14 +00:00
This is the URL specified as `disturl` in a `.npmrc` file or as the `--dist-url`
command line flag when building native Node modules.
Deprecated: https://atom.io/download/atom-shell
Replace with: https://atom.io/download/electron
2017-06-15 19:46:25 +00:00
2019-04-25 22:14:19 +00:00
## Breaking API Changes (2.0)
2018-05-29 09:23:28 +00:00
2018-05-29 09:42:20 +00:00
The following list includes the breaking API changes made in Electron 2.0.
2019-04-25 22:14:19 +00:00
### `BrowserWindow`
2018-05-29 09:23:28 +00:00
```js
// Deprecated
2018-09-13 16:10:51 +00:00
let optionsA = { titleBarStyle: 'hidden-inset' }
2018-05-29 09:23:28 +00:00
let windowA = new BrowserWindow(optionsA)
// Replace with
2018-09-13 16:10:51 +00:00
let optionsB = { titleBarStyle: 'hiddenInset' }
2018-05-29 09:23:28 +00:00
let windowB = new BrowserWindow(optionsB)
```
2019-04-25 22:14:19 +00:00
### `menu`
2018-05-29 09:23:28 +00:00
```js
2018-05-29 09:37:42 +00:00
// Removed
2018-05-29 09:23:28 +00:00
menu.popup(browserWindow, 100, 200, 2)
2018-05-29 09:37:42 +00:00
// Replaced with
2018-09-13 16:10:51 +00:00
menu.popup(browserWindow, { x: 100, y: 200, positioningItem: 2 })
2018-05-29 09:23:28 +00:00
```
2019-04-25 22:14:19 +00:00
### `nativeImage`
2018-05-29 09:23:28 +00:00
```js
2018-05-29 09:37:42 +00:00
// Removed
2018-05-29 09:23:28 +00:00
nativeImage.toPng()
2018-05-29 09:37:42 +00:00
// Replaced with
2018-05-29 09:23:28 +00:00
nativeImage.toPNG()
2018-05-29 09:37:42 +00:00
// Removed
2018-05-29 09:23:28 +00:00
nativeImage.toJpeg()
2018-05-29 09:37:42 +00:00
// Replaced with
2018-05-29 09:23:28 +00:00
nativeImage.toJPEG()
```
2019-04-25 22:14:19 +00:00
### `process`
2018-05-29 09:23:28 +00:00
* `process.versions.electron` and `process.version.chrome` will be made
read-only properties for consistency with the other `process.versions`
properties set by Node.
2019-04-25 22:14:19 +00:00
### `webContents`
2018-05-29 09:23:28 +00:00
```js
2018-05-29 09:37:42 +00:00
// Removed
2018-05-29 09:23:28 +00:00
webContents.setZoomLevelLimits(1, 2)
2018-05-29 09:37:42 +00:00
// Replaced with
2018-05-29 09:23:28 +00:00
webContents.setVisualZoomLevelLimits(1, 2)
```
2019-04-25 22:14:19 +00:00
### `webFrame`
2018-05-29 09:23:28 +00:00
```js
2018-05-29 09:37:42 +00:00
// Removed
2018-05-29 09:23:28 +00:00
webFrame.setZoomLevelLimits(1, 2)
2018-05-29 09:37:42 +00:00
// Replaced with
2018-05-29 09:23:28 +00:00
webFrame.setVisualZoomLevelLimits(1, 2)
```
2019-04-25 22:14:19 +00:00
### `<webview>`
2018-05-29 09:23:28 +00:00
```js
2018-05-29 09:37:42 +00:00
// Removed
2018-05-29 09:23:28 +00:00
webview.setZoomLevelLimits(1, 2)
2018-05-29 09:37:42 +00:00
// Replaced with
2018-05-29 09:23:28 +00:00
webview.setVisualZoomLevelLimits(1, 2)
```
2019-04-25 22:14:19 +00:00
### Duplicate ARM Assets
2018-05-29 09:23:28 +00:00
2018-05-29 09:37:42 +00:00
Each Electron release includes two identical ARM builds with slightly different
filenames, like `electron-v1.7.3-linux-arm.zip` and
`electron-v1.7.3-linux-armv7l.zip` . The asset with the `v7l` prefix was added
to clarify to users which ARM version it supports, and to disambiguate it from
2018-05-29 09:23:28 +00:00
future armv6l and arm64 assets that may be produced.
2018-05-29 09:37:42 +00:00
The file _without the prefix_ is still being published to avoid breaking any
2019-06-21 21:19:21 +00:00
setups that may be consuming it. Starting at 2.0, the unprefixed file will
2018-05-29 09:23:28 +00:00
no longer be published.
For details, see
[6986 ](https://github.com/electron/electron/pull/6986 )
2018-05-29 09:37:42 +00:00
and
2018-05-29 09:23:28 +00:00
[7189 ](https://github.com/electron/electron/pull/7189 ).