2016-09-07 18:41:54 +00:00
|
|
|
# Planned Breaking API Changes
|
|
|
|
|
|
|
|
The following list includes the APIs that will be removed in Electron 2.0.
|
|
|
|
|
|
|
|
There is no timetable for when this release will occur but deprecation
|
|
|
|
warnings will be added at least 90 days beforehand.
|
|
|
|
|
2016-09-08 16:09:49 +00:00
|
|
|
## `BrowserWindow`
|
|
|
|
|
|
|
|
```js
|
|
|
|
// Deprecated
|
2016-09-08 16:15:05 +00:00
|
|
|
let optionsA = {webPreferences: {blinkFeatures: ''}}
|
|
|
|
let windowA = new BrowserWindow(optionsA)
|
2016-09-08 16:09:49 +00:00
|
|
|
// Replace with
|
2016-09-08 16:15:05 +00:00
|
|
|
let optionsB = {webPreferences: {enableBlinkFeatures: ''}}
|
|
|
|
let windowB = new BrowserWindow(optionsB)
|
2016-09-08 16:09:49 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## `clipboard`
|
|
|
|
|
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
|
|
|
```
|
|
|
|
|
2016-11-28 23:06:03 +00:00
|
|
|
## `crashReporter`
|
|
|
|
|
|
|
|
```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
|
|
|
|
})
|
|
|
|
```
|
|
|
|
|
2016-09-08 16:09:49 +00:00
|
|
|
## `nativeImage`
|
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
|
|
|
|
nativeImage.toPng()
|
|
|
|
// Replace with
|
|
|
|
nativeImage.toPNG()
|
|
|
|
|
|
|
|
// Deprecated
|
|
|
|
nativeImage.toJpeg()
|
|
|
|
// Replace with
|
|
|
|
nativeImage.toJPEG()
|
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
|
|
|
|
2016-09-16 22:57:07 +00:00
|
|
|
## `process`
|
|
|
|
|
|
|
|
```js
|
|
|
|
// Deprecated
|
|
|
|
process.versions['atom-shell']
|
|
|
|
// Replace with
|
|
|
|
process.versions.electron
|
|
|
|
```
|
|
|
|
|
2017-01-12 21:49:25 +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.
|
|
|
|
|
2016-09-08 16:09:49 +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
|
|
|
|
2016-09-08 16:09:49 +00:00
|
|
|
## `webContents`
|
|
|
|
|
|
|
|
```js
|
2016-09-07 18:41:54 +00:00
|
|
|
// Deprecated
|
|
|
|
webContents.openDevTools({detach: true})
|
|
|
|
// Replace with
|
|
|
|
webContents.openDevTools({mode: 'detach'})
|
|
|
|
```
|
2016-11-04 21:30:14 +00:00
|
|
|
|
2016-11-22 16:11:14 +00:00
|
|
|
```js
|
|
|
|
// Deprecated
|
|
|
|
webContents.setZoomLevelLimits(1, 2)
|
|
|
|
// Replace with
|
|
|
|
webContents.setVisualZoomLevelLimits(1, 2)
|
|
|
|
```
|
|
|
|
|
|
|
|
## `webFrame`
|
|
|
|
|
|
|
|
```js
|
|
|
|
// Deprecated
|
|
|
|
webFrame.setZoomLevelLimits(1, 2)
|
|
|
|
// Replace with
|
|
|
|
webFrame.setVisualZoomLevelLimits(1, 2)
|
2016-11-14 18:33:30 +00:00
|
|
|
|
|
|
|
// Deprecated
|
|
|
|
webFrame.registerURLSchemeAsSecure('app')
|
|
|
|
// Replace with
|
2016-11-16 14:41:06 +00:00
|
|
|
protocol.registerStandardSchemes(['app'], {secure: true})
|
2016-11-14 18:33:30 +00:00
|
|
|
|
|
|
|
// Deprecated
|
|
|
|
webFrame.registerURLSchemeAsPrivileged('app', {secure: true})
|
|
|
|
// Replace with
|
2016-11-16 14:41:06 +00:00
|
|
|
protocol.registerStandardSchemes(['app'], {secure: true})
|
2016-11-22 16:11:14 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
## `<webview>`
|
|
|
|
|
|
|
|
```js
|
|
|
|
// Deprecated
|
|
|
|
webview.setZoomLevelLimits(1, 2)
|
|
|
|
// Replace with
|
|
|
|
webview.setVisualZoomLevelLimits(1, 2)
|
|
|
|
```
|
|
|
|
|
2016-11-04 21:30:14 +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.
|
|
|
|
|
|
|
|
Deprecated: https://atom.io/download/atom-shell
|
|
|
|
|
|
|
|
Replace with: https://atom.io/download/electron
|