Restaurar archivos borrados

Los cambios de ruptura se documentaran aquí y se agregaran advertencias de desaprobación al código JS cuando sea posible, al menos una versión superior se publicará, antes de que se realice cualquier cambio.

Tipos de cambios de ruptura

Este documento usa la siguiente convención para clasificar los cambios de ruptura:

API Modificada: Se cambió una API de tal manera que se garantiza que el código que no ha sido actualizado produzca una excepción.
Comportamiento Modificado: El comportamiento de Electron ha cambiado, pero no de tal manera que una excepción se produzca necesariamente.
Valor por defecto Modificado: Código dependiente del viejo valor por defecto puede romperse, no necesariamente lanzando una excepción. El comportamiento antiguo puede ser restaurado especificando explícitamente el valor.
Obsoleto: Una API fue marcada como obsoleta. La API continuará funcionando, pero emitirá una advertencia de desaprobación y será eliminada en una futura versión.
Eliminado: Una API o característica fue eliminada y ya no es compatible por Electron.

Cambios Planeados en la API (23.0)

Comportamiento cambiado: Regiones arrastrables en macOS

La implementación de regiones arrastrables (usando la propiedad CSS -webkit-app-region: drag) ha cambiado en macOS para adaptarla a Windows y Linux. Anteriormente, cuando una región con -webkit-app-region: no-drag se traslapó con una región con -webkit-app-region: drag, la región no-drag siempre tendría prioridad en macOS, sin importar la capa CSS. Es decir, si una región drag estuviera por encima de una región de no-drag, sería ignorada. Comenzando en Electron 23, una región drag encima de una región no-drag hará que la región sea arrastrable.

Además, la propiedad customButtonsOnHover BrowserWindow previamente creó una región arrastrable que ignoró la propiedad CSS -webkit-app-region. Esto ha sido arreglado (ver #37210 para discusión).

Como resultado, si tu aplicación usa una ventana sin marco con regiones arrastrables en macOS, las regiones que son arrastrables en tu aplicación pueden cambiar en Electron 23.

Eliminado: Soporte para Windows 7 / 8 / 8.1

Windows 7, Windows 8 y Windows 8.1 ya no son compatibles. Electron sigue la política de deprecación de Chromium planificada, que deprecará el soporte para Windows 7 a partir de Chromium 109.

Las versiones más antiguas de Electron continuarán ejecutándose en estos sistemas operativos, pero se requerirá Windows 10 o posterior para ejecutar Electron v23.0.0 y superior.

Eliminado: eventos BrowserWindow `scroll-touch-*`

Los eventos deprecados de BrowserWindow scroll-touch-begin, scroll-touch-end y scroll-touch-edge han sido eliminados. En su lugar, utiliza el nuevo evento disponible input-event en WebContents.

// Eliminado en Electron 23.0
win.on('scroll-touch-begin', scrollTouchBegin)
win.on('scroll-touch-edge', scrollTouchEdge)
gana. n('scroll-touch-end', scrollTouchEnd)

// Reemplazar con
win.webContents.on('input-event', (_, event) => {
  if (event. type === 'gestureScrollBegin') {
    scrollTouchBegin()
  } else if (event. type === 'gestureScrollUpdate') {
    scrollTouchEdge()
  } else if (event. type === 'gestureScrollEnd') {
    scrollTouchEnd()
  }
})

Eliminado: `webContents.incrementCapturerCount(stayHidden, stayAwake)`

El método webContents.incrementCapturerCount(stayHidden, stayAwake) ha sido eliminado. It is now automatically handled by webContents.capturePage when a page capture completes.

const w = new BrowserWindow({ show: false })

// Eliminado en Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image. oDataURL())
  w.webContents.decrementCapturerCount()
})

// Reemplazar con
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

Eliminado: `webContents.decrementCapturerCount(stayHidden, stayAwake)`

El método webContents.decrementCapturerCount(stayHidden, stayAwake) ha sido eliminado. It is now automatically handled by webContents.capturePage when a page capture completes.

const w = new BrowserWindow({ show: false })

// Eliminado en Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image. oDataURL())
  w.webContents.decrementCapturerCount()
})

// Reemplazar con
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

Cambios Planeados en la API (22.0)

Obsoleto: `webContents.incrementCapturerCount(stayHidden, stayAwake)`

webContents.incrementCapturerCount(stayHidden, stayAwake) has been deprecated. It is now automatically handled by webContents.capturePage when a page capture completes.

const w = new BrowserWindow({ show: false })

// Eliminado en Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image. oDataURL())
  w.webContents.decrementCapturerCount()
})

// Reemplazar con
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

Obsoleto: `webContents.decrementCapturerCount(stayHidden, stayAwake)`

webContents.decrementCapturerCount(stayHidden, stayAwake) has been deprecated. It is now automatically handled by webContents.capturePage when a page capture completes.

const w = new BrowserWindow({ show: false })

// Eliminado en Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image. oDataURL())
  w.webContents.decrementCapturerCount()
})

// Reemplazar con
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

Eliminado: evento `new-window` de Webcontens

El evento new-window de WebContents ha sido eliminado. Es reemplazado por webContents.setWindowOpenHandler().

// Obsoleto en Electron 13
webContents.on('new-window', (event) => {
  event.preventDefault()
})

// Reemplazar por
webContents.setWindowOpenHandler((details) => {
  return { action: 'deny' }
})

Eliminado: eventos `scroll-touch-*` de BrowserWindow

Los eventos scroll-touch-begin, scroll-touch-end y scroll-touch-edge en BrowserWindow están deprecados. En su lugar, utiliza el nuevo evento disponible input-event en WebContents.

// Deprecado
win.on('scroll-touch-begin', scrollTouchBegin)
win.on('scroll-touch-edge', scrollTouchEdge)
gana. n('scroll-touch-end', scrollTouchEnd)

// Reemplazar con
win.webContents.on('input-event', (_, event) => {
  if (event. type === 'gestureScrollBegin') {
    scrollTouchBegin()
  } else if (event. type === 'gestureScrollUpdate') {
    scrollTouchEdge()
  } else if (event. type === 'gestureScrollEnd') {
    scrollTouchEnd()
  }
})

Cambios Planeados en la API (21.0)

Comportamiento modificado: V8 Memory Cage habilitado

La memory cage V8 ha sido activada, lo que tiene implicancias para los módulos nativos que envuelven memoria no-V8 con ArrayBuffer o Buffer. Vea la entrada del blog sobre memory cage V8 para más detalles.

API modificada: `webContents.printToPDF()`

webContents.printToPDF() ha sido modificado para adaptarse a Page.printToPDF en el Protocolo de Chrome DevTools. Esto ha sido cambios para abordar los cambios originales que hicieron nuestra implementación anterior insostenible y plagada de errores.

Argumentos cambiados

pageRanges

Argumentos eliminados

printSelectionOnly
marginsType
headerFooter
scaleFactor

Arguments Added

headerTemplate
footerTemplate
displayHeaderFooter
márgenes
scale
preferCSSPageSize

// Main process
const { webContents } = require('electron')

webContents.printToPDF({
  landscape: true,
  displayHeaderFooter: true,
  printBackground: true,
  scale: 2,
  pageSize: 'Ledger',
  margins: {
    top: 2,
    bottom: 2,
    left: 2,
    right: 2
  },
  pageRanges: '1-5, 8, 11-13',
  headerTemplate: '<h1>Title</h1>',
  footerTemplate: '<div><span class="pageNumber"></span></div>',
  preferCSSPageSize: true
}).then(data => {
  fs.writeFile(pdfPath, data, (error) => {
    if (error) throw error
    console.log(`Wrote PDF successfully to ${pdfPath}`)
  })
}).catch(error => {
  console.log(`Failed to write PDF to ${pdfPath}: `, error)
})

Cambios Planeados en la API (20.0)

Removed: macOS 10.11 / 10.12 support

macOS 10.11 (El Capitan) and macOS 10.12 (Sierra) are no longer supported by Chromium.

Older versions of Electron will continue to run on these operating systems, but macOS 10.13 (High Sierra) or later will be required to run Electron v20.0.0 and higher.

Default Changed: renderers without `nodeIntegration: true` are sandboxed by default

Previously, renderers that specified a preload script defaulted to being unsandboxed. This meant that by default, preload scripts had access to Node.js. En Electron 20, este comportamiento ha cambiado. Beginning in Electron 20, renderers will be sandboxed by default, unless nodeIntegration: true or sandbox: false is specified.

If your preload scripts do not depend on Node, no action is needed. If your preload scripts do depend on Node, either refactor them to remove Node usage from the renderer, or explicitly specify sandbox: false for the relevant renderers.

Eliminado: `skipTaskbar` en Linux

On X11, skipTaskbar sends a _NET_WM_STATE_SKIP_TASKBAR message to the X11 window manager. There is not a direct equivalent for Wayland, and the known workarounds have unacceptable tradeoffs (e.g. Window.is_skip_taskbar in GNOME requires unsafe mode), so Electron is unable to support this feature on Linux.

API Changed: `session.setDevicePermissionHandler(handler)`

The handler invoked when session.setDevicePermissionHandler(handler) is used has a change to its arguments. This handler no longer is passed a frame WebFrameMain, but instead is passed the origin, which is the origin that is checking for device permission.

Cambios Planeados en la API (19.0)

Elimnado: IA32 Binarios Linux

Esto es un resultado de Chromium 102.0.4999.0 que soporte a Linux IA32. Esto concluye el soporte de Linux IA32 .

Cambios Planeados en la API (18.0)

Eliminada: `nativeWindowOpen`

Antes de Electron 15, window.open estaba relucido de usar BrowserWindowProxy por defecto. This meant that window.open('about:blank') did not work to open synchronously scriptable child windows, among other incompatibilities. Since Electron 15, nativeWindowOpen has been enabled by default.

Ver a la documentación de window.open in Electron para más informacion.

Cambios Planeados en la API (17.0)

Eliminado: `desktopCapturer.getSources` en el renderizador

La API desktopCapturer.getSources ahora sólo esta disponible en el proceso principal. Esto a sido cambiado para mejorar la seguridad por defecto de las aplicaciones Electron.

Si necesitas esta funcionalidad, puede ser reemplazado de la siguiente manera:

// Proceso principal
const { ipcMain, desktopCapturer } = require('electron')

ipcMain.handle(
  'DESKTOP_CAPTURER_GET_SOURCES',
  (event, opts) => desktopCapturer.getSources(opts)
)

// Proceso renderizador
const { ipcRenderer } = require('electron')

const desktopCapturer = {
  getSources: (opts) => ipcRenderer.invoke('DESKTOP_CAPTURER_GET_SOURCES', opts)
}

However, you should consider further restricting the information returned to the renderer; for instance, displaying a source selector to the user and only returning the selected source.

Deprecated: `nativeWindowOpen`

Ver a la documentación de window.open in Electron para más informacion.

Cambios Planeados en la API (16.0)

Behavior Changed: `crashReporter` implementation switched to Crashpad on Linux

The underlying implementation of the crashReporter API on Linux has changed from Breakpad to Crashpad, bringing it in line with Windows and Mac. As a result of this, child processes are now automatically monitored, and calling process.crashReporter.start in Node child processes is no longer needed (and is not advisable, as it will start a second instance of the Crashpad reporter).

There are also some subtle changes to how annotations will be reported on Linux, including that long values will no longer be split between annotations appended with __1, __2 and so on, and instead will be truncated at the (new, longer) annotation value limit.

Deprecated: `desktopCapturer.getSources` in the renderer

Usage of the desktopCapturer.getSources API in the renderer has been deprecated and will be removed. Este cambio va a mejorar la seguridad de los apps Electron predefinidos.

Consulte aquí para más detalles sobre como reemplazar esta API en tu aplicación.

Cambios en API Planeados (15.0)

Valor por defecto modificado: `nativeWindowOpen` por defecto a `true`

Antes de Electron 15, window.open estaba relucido de usar BrowserWindowProxy por defecto. This meant that window.open('about:blank') did not work to open synchronously scriptable child windows, among other incompatibilities. nativeWindowOpen is no longer experimental, and is now the default.

Ver a la documentación de window.open in Electron para más informacion.

Cambios Planeados en la API (14.0)

Eliminado: módulo `remote`

El módulo remote fue desaprobado en Electron 12, y será eliminado en Electron 14. Es reemplazado por el módulo @electron/remote.

// Deprecated in Electron 12:
const { BrowserWindow } = require('electron').remote

// Replace with:
const { BrowserWindow } = require('@electron/remote')

// In the main process:
require('@electron/remote/main').initialize()

Eliminada: `app.allowRendererProcessReuse`

La propiedad app.allowRendererProcessReuse se eliminará como parte de nuestro plan para alinearnos más estrechamente con el modelo de proceso de Chromium para la seguridad, el rendimiento y la capacidad de mantenimiento.

Para información más detallada vea #18397.

Eliminado: Browser Window Affinity

La opción affinity al construir una nueva BrowserWindow se eliminará como parte de nuestro plan para alinear más estrechamente con el modelo de proceso de Chromium por seguridad, rendimiento y mantenimiento.

Para información más detallada vea #18397.

API modificada: `window.open()`

El parámetro opcional frameName ya no se establecerá como el título de la ventana. Esto ahora sigue la especificación descrita por la documentación nativa bajo el correspondiente parámetro windowName.

If you were using this parameter to set the title of a window, you can instead use win.setTitle(title).

Eliminado: `worldSafeExecuteJavaScript`

En Electron 14 worldSafeExecuteJavaScript será eliminado. No hay alternativa, por favor asegúrese que su código trabaja con esta propiedad activada. Ha sido activada por defecto desde Electron 12.

Será afectado por este cambio si usted utliza webFrame.executeJavaScript o webFrame.executeJavaScriptInIsolatedWorld. Necesitará asegurase que los valores devueltos por cualquiera de esos métodos son soportados por Context Bridge API ya que estos métodos utilizan la misma semántica de paso de valores.

Eliminado: BrowserWindowConstructorOptions que hereda desde las ventanas padres

Prior to Electron 14, windows opened with window.open would inherit BrowserWindow constructor options such as transparent and resizable from their parent window. Beginning with Electron 14, this behavior is removed, and windows will not inherit any BrowserWindow constructor options from their parents.

Instead, explicitly set options for the new window with setWindowOpenHandler:

webContents.setWindowOpenHandler((details) => {
  return {
    action: 'allow',
    overrideBrowserWindowOptions: {
      // ...
    }
  }
})

Eliminada: `additionalFeatures`

The deprecated additionalFeatures property in the new-window and did-create-window events of WebContents has been removed. Since new-window uses positional arguments, the argument is still present, but will always be the empty array []. (Though note, the new-window event itself is deprecated, and is replaced by setWindowOpenHandler.) Bare keys in window features will now present as keys with the value true in the options object.

// Removed in Electron 14
// Triggered by window.open('...', '', 'my-key')
webContents.on('did-create-window', (window, details) => {
  if (details.additionalFeatures.includes('my-key')) {
    // ...
  }
})

// Replace with
webContents.on('did-create-window', (window, details) => {
  if (details.options['my-key']) {
    // ...
  }
})

Cambios Planeados en la API (13.0)

API modificada: `session.setPermissionCheckHandler(handler)`

El primer parámetro de los métodos handler anteriormente siempre era un webContents, ahora puede ser a veces null. Debe usar las propiedades requestingOrigin, embeddingOrigin y securityOrigin para responder correctamente a la verificación de permiso. Como el webContents puede ser null ya no se puede confiar en él.

// Old code
session.setPermissionCheckHandler((webContents, permission) => {
  if (webContents.getURL().startsWith('https://google.com/') && permission === 'notification') {
    return true
  }
  return false
})

// Replace with
session.setPermissionCheckHandler((webContents, permission, requestingOrigin) => {
  if (new URL(requestingOrigin).hostname === 'google.com' && permission === 'notification') {
    return true
  }
  return false
})

Eliminado: `shell.moveItemToTrash()`

Se ha eliminado la API síncrona shell.moveItemToTrash() obsoleta. Utilice en su lugar shell.trashItem().

// Removed in Electron 13
shell.moveItemToTrash(path)
// Replace with
shell.trashItem(path).then(/* ... */)

Eliminado: APIs de extensión `BrowserWindow`

La APIs de extensión han sido eliminadas:

BrowserWindow.addExtension(path)
BrowserWindow.addDevToolsExtension(path)
BrowserWindow.removeExtension(name)
BrowserWindow.removeDevToolsExtension(name)
BrowserWindow.getExtensions()
BrowserWindow.getDevToolsExtensions()

En su lugar use las APIs de session:

ses.loadExtension(path)
ses.removeExtension(extension_id)
ses.getAllExtensions()

// Removed in Electron 13
BrowserWindow.addExtension(path)
BrowserWindow.addDevToolsExtension(path)
// Replace with
session.defaultSession.loadExtension(path)

// Removed in Electron 13
BrowserWindow.removeExtension(name)
BrowserWindow.removeDevToolsExtension(name)
// Replace with
session.defaultSession.removeExtension(extension_id)

// Removed in Electron 13
BrowserWindow.getExtensions()
BrowserWindow.getDevToolsExtensions()
// Replace with
session.defaultSession.getAllExtensions()

Eliminado: métodos en `systemPreferences`

Los métodos siguientes de systemPreferences han quedado obsoletos:

systemPreferences.isDarkMode()
systemPreferences.isInvertedColorScheme()
systemPreferences.isHighContrastColorScheme()

En su lugar, usa las siguientes propiedades nativeTheme:

nativeTheme.shouldUseDarkColors
nativeTheme.shouldUseInvertedColorScheme
nativeTheme.shouldUseHighContrastColors

// Removed in Electron 13
systemPreferences.isDarkMode()
// Replace with
nativeTheme.shouldUseDarkColors

// Removed in Electron 13
systemPreferences.isInvertedColorScheme()
// Replace with
nativeTheme.shouldUseInvertedColorScheme

// Removed in Electron 13
systemPreferences.isHighContrastColorScheme()
// Replace with
nativeTheme.shouldUseHighContrastColors

En desuso: evento Webcontens `nueva ventana`

El evento new-window de WebContents está obsoleto. Es reemplazado por webContents.setWindowOpenHandler().

// Obsoleto en Electron 13
webContents.on('new-window', (event) => {
  event.preventDefault()
})

// Reemplazar por
webContents.setWindowOpenHandler((details) => {
  return { action: 'deny' }
})

Cambios Planeados en la API (12.0)

Eliminado: Soporte de Pepper Flash

Chromium a eliminado el soporte para Flash, por lo tanto nosotros debemos seguir el ejemplo. Vea el Flash Roadmap de Chromium para más detalles.

Valor por defecto moidificado: `worldSafeExecuteJavaScript` por defecto a `true`

En Electron 12, worldSafeExecuteJavaScript será activado por defecto. Para restuaurar el comportamiento anterior, worldSafeExecuteJavaScript: false debe especificarse en WebPreferences. Por favor tenga en cuenta que estableciendo esta opción a false es inseguro.

Esta opción sera removida en Electron 14, así que por favor migra tu código para soportar el valor por defecto.

Valor por defecto modificado: `contextIsolation` por defecto a `true`

En Electron 12, contextIsolation será activado por defecto. Para restaurar el comportamiento anterior contextIsolation: false debe ser especificado en WebPreferences.

Nosotros recomendamos tener contextIsolation activado por la seguridad de su aplicación.

Otra implicación es que require() no puede ser usada en el renderer process a menos que nodeIntegration sea true y contextIsolation sea false.

Para más detalles ver: https://github.com/electron/electron/issues/23506

Eliminado: `crashReporter.getCrashesDirectory()`

El método crashReporter.getCrashesDirectory ha sido eliminado. Uso debe ser reemplazado por app.getPath('crashDumps').

// Eliminado en Electron 12
crashReporter.getCrashesDirectory()
// Reeamplazar con
app.getPath('crashDumps')

Eliminado: métodos `crashReporter` en el render process

Los siguientes métodos crashReporter ya no están disponible en el renderer process:

crashReporter.start
crashReporter.getLastCrashReport
crashReporter.getUploadedReports
crashReporter.getUploadToServer
crashReporter.setUploadToServer
crashReporter.getCrashesDirectory

Deberían ser llamados solo desde el proceso principal.

Vea #23265 para más detalles.

Valor por defecto modificado: `crashReporter.start({ compress: true })`

El valor por defecto de la opción compress a crashReporter.start ha cambiado de false a true. Esto significa que los volcados se subirán al servidor de ingestión de errores con el encabezado Content-Encoding: gzip y el cuerpo será comprimido.

Si su servidor de gestión de fallos no soporta cargas comprimidas, puedes desactivar la compresión especificando { compress: false } en las opciones del reportero de errores .

Obsoleto: módulo `remote`

El módulo remote está obsoleto en Electron 12 y sera eliminado en Electron 14. Es reemplazado por el módulo @electron/remote.

// Deprecated in Electron 12:
const { BrowserWindow } = require('electron').remote

// Replace with:
const { BrowserWindow } = require('@electron/remote')

// In the main process:
require('@electron/remote/main').initialize()

Obsoleto: `shell.moveItemToTrash()`

El síncrono shell.moveItemToTrash() ha sido reemplazado por el nuevo asíncrono shell.trashItem().

// Deprecated in Electron 12
shell.moveItemToTrash(path)
// Replace with
shell.trashItem(path).then(/* ... */)

Cambios Planeados en la API (11.0)

Eliminado: `BrowserView.{destroy, fromId, fromWebContents, getAllViews}` y `id` propiedad de `BrowserView`

Las APIs experimentales BrowserView.{destroy, fromId, fromWebContents, getAllViews} fueron removidas. Adicionalmente, la propiedad id de BrowserView también ha sido removida.

Para ver más información, consulta #23578.

Cambios Planeados en la API (10.0)

Desaprobado: argumento `companyName` para `crashReporter.start()`

El argumento companyName para crashReporter.start(), que era previamente requerido, ahora es opcional, y aún más, está desaprobado. Para obtener el mismo comportamiento de una forma no desaprobada, pude pasar un valor companyName en globalExtra.

// Deprecated in Electron 10
crashReporter.start({ companyName: 'Umbrella Corporation' })
// Replace with
crashReporter.start({ globalExtra: { _companyName: 'Umbrella Corporation' } })

Obsoleto: `crashReporter.getCrashesDirectory()`

El método crashReporter.getCrashesDirectory ha sido desaprobado. Uso debe ser reemplazado por app.getPath('crashDumps').

// Deprecated in Electron 10
crashReporter.getCrashesDirectory()
// Replace with
app.getPath('crashDumps')

Obsoleto: los métodos `crashReporter` en el renderer process

Llamar a los siguientes métodos crashReporter desde el renderer process es obsoleto:

crashReporter.start
crashReporter.getLastCrashReport
crashReporter.getUploadedReports
crashReporter.getUploadToServer
crashReporter.setUploadToServer
crashReporter.getCrashesDirectory

Los únicos métodos no desaprobados restantes en el modulo crashReporter en el render son addExtraParameter, removeExtraParameter y getParameters.

Todos los métodos anteriores permanecen no desaprobados cuando son llamados desde el proceso principal.

Vea #23265 para más detalles.

Obsoleto: `crashReporter.start({ compress: false })`

Establecer { compress: false } en crashReporter.start está obsoleto. Casi todos los servidores de gestión de fallos soportan compresión gzip. Esta opción será eliminada en una versión futura de Electron.

Valor por defecto modificado: `enableRemoteModule` por defecto a `false`

En Electron 9, usar el módulo remoto sin habilitarlo explícitamente a través de la opción enableRemoteModule WebPreferences comenzó a emitir una advertencia. En Electron 10, el módulo remote está deshabilitado por defecto. Para usar el módulo remote debe especificarse enableRemoteModule: true en WebPreferences:

const w = new BrowserWindow({
  webPreferences: {
    enableRemoteModule: true
  }
})

Nosotros recomendamos alejarse del módulo remote.

`protocol.unregisterProtocol`

`protocol.uninterceptProtocol`

Las APIs ahora son síncronas y el callback opcional ya no es necesario.

// Deprecated
protocol.unregisterProtocol(scheme, () => { /* ... */ })
// Replace with
protocol.unregisterProtocol(scheme)

`protocol.registerFileProtocol`

`protocol.registerBufferProtocol`

`protocol.registerStringProtocol`

`protocol.registerHttpProtocol`

`protocol.registerStreamProtocol`

`protocol.interceptFileProtocol`

`protocol.interceptStringProtocol`

`protocol.interceptHttpProtocol`

`protocol.interceptStreamProtocol`

Las APIs ahora son síncronas y el callback opcional ya no es necesario.

// Deprecated
protocol.registerFileProtocol(scheme, handler, () => { /* ... */ })
// Replace with
protocol.registerFileProtocol(scheme, handler)

El protocolo registrado o interceptado no tiene efecto en la página actual hasta que ocurra la navegación.

`protocol.isProtocolHandled`

Esta API está obsoleta y los usuarios deberían usar protocol.isProtocolRegistered y protocol.isProtocolIntercepted en su lugar.

// Deprecated
protocol.isProtocolHandled(scheme).then(() => { /* ... */ })
// Replace with
const isRegistered = protocol.isProtocolRegistered(scheme)
const isIntercepted = protocol.isProtocolIntercepted(scheme)

Cambios Planeados en la API (9.0)

Valor por defecto modificado: La carga de módulos nativos sin contexto conscientes en el proceso renderer está desactivada por defecto

A partir de Electron 9 no permitimos la carga de módulos nativos no conscientes del contexto en el proceso de renderizado. Esto es para mejorar la seguridad, el rendimiento y el mantenimiento de Electron como proyecto.

Si esto te impacta, puedes configurar de forma temporal app.allowRendererProcessReuse a false para revertir el comportamiento antiguo. Esta marca solo será una opción hasta Electron 11 y deberías planear actualizar tus módulos nativos para que sean conscientes del contexto.

Para información más detallada vea #18397.

Obsoleto: APIs de extensión `BrowserWindow`

Las siguientes APIs de extensión han sido marcadas como obsoletas:

BrowserWindow.addExtension(path)
BrowserWindow.addDevToolsExtension(path)
BrowserWindow.removeExtension(name)
BrowserWindow.removeDevToolsExtension(name)
BrowserWindow.getExtensions()
BrowserWindow.getDevToolsExtensions()

En su lugar use las APIs de session:

ses.loadExtension(path)
ses.removeExtension(extension_id)
ses.getAllExtensions()

// Deprecated in Electron 9
BrowserWindow.addExtension(path)
BrowserWindow.addDevToolsExtension(path)
// Replace with
session.defaultSession.loadExtension(path)

// Deprecated in Electron 9
BrowserWindow.removeExtension(name)
BrowserWindow.removeDevToolsExtension(name)
// Replace with
session.defaultSession.removeExtension(extension_id)

// Deprecated in Electron 9
BrowserWindow.getExtensions()
BrowserWindow.getDevToolsExtensions()
// Replace with
session.defaultSession.getAllExtensions()

Eliminado: `<webview>.getWebContents()`

Esta API la cual fue marcada como obsoleta en Electron 8.0, ahora es eliminada.

// Removed in Electron 9.0
webview.getWebContents()
// Replace with
const { remote } = require('electron')
remote.webContents.fromId(webview.getWebContentsId())

Eliminada: `webFrame.setLayoutZoomLevelLimits()`

Chromium ha eliminado el soporte para cambiar los limites del nivel de zoom del diseño y esta más allá de la capacidad de Electron el mantenerlo. La función fue marcada como obsoleta en Electron 8.x, y ha sido eliminada en Electron 9.x. Los niveles de zoom limites ahora están fijados a un mínimo de 0.25 y un máximo de 5.0, como se define aquí.

Comportamiento Modificado: Enviando objetos no JS sobre IPC ahora lanza una excepción

En Electron 8.0, el IPC se cambió para que utilizara el algoritmo de clon estructurado, con importantes mejoras de rendimiento. Para ayudar a aliviar la transición, el antiguo algoritmo de serialización de IPC se mantuvo y se usó para algunos objetos que no son serializables con un clon estructurado. In particular, DOM objects (e.g. Element, Location and DOMMatrix), Node.js objects backed by C++ classes (e.g. process.env, some members of Stream), and Electron objects backed by C++ classes (e.g. WebContents, BrowserWindow and WebFrame) are not serializable with Structured Clone. Siempre que se invocaba el algoritmo anterior, se imprimía una advertencia de desaprobación.

En Electron 9,0, se eliminó el algoritmo de serialización anterior, y enviar tales objetos no serializables ahora lanzará un error "no se pudo clonar el objeto".

API Modificada: `shell.openItem` ahora es `shell.openPath`

La API shell.openItem ha sido reemplazada con una API asíncrona shell.openPath. Puede ver el la propuesta y lógica original la API aquí.

Cambios Planeados en la API (8.0)

Comportamiento Cambiado: Los valores enviados sobre IPC ahora son serializados con Algoritmo de Clon Estructurado

El algoritmo usado para serializar los objetos enviados sobre IPC (mediante ipcRenderer.send, ipcRenderer.sendSync, WebContents.send y métodos relacionados) han sido cambiados de un algoritmo personalizado a los de V8 Structured Clone Algorithm, el mismo algoritmo usado para serializar los mensajes para postMessage. Esto conlleva una mejora en el rendimiento de 2x para mensajes grandes, pero también trae algunos cambios de comportamiento.

Enviar Functions, Promises, WeakMaps, WeakSets, o objetos que contengan tales valores sobre IPC no lanzará ninguna excepción, en lugar de convertir las funciones a undefined.

// 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 y -Infinity ahora serán correctamente serializados en lugar de ser convertidos a null.
Los objectos que contengan referencias cíclicas ahora serán correctamente serializados en lugar de ser convertidos a null.
Los valores Set, Map, Error y RegExp ahora serán correctamente serializados en lugar de ser convertidos a {}.
Los valores BigInt ahora serán correctamente serializados en lugar de ser convertidos a null.
Las matrices dispersas se serializarán como tales, en lugar de convertirse en matrices densas con nulls.
Los objetos Date serán transferidos como objetos Date, en lugar de ser convertidos en su representación de cadena ISO.
Los Arrays con tipo (tales como Uint8Array, Uint16Array, Uint32Array y así sucesivamente) serán transferidas como tales, en lugar de ser convertida a Node.js Buffer.
Los objetos Node.js Buffer serán transferidos como Uint8Arrays. Puedes convertir un Uint8Array de nuevo a un Node.js Buffer envolviendo el ArrayBuffer subyacente:

Buffer.from(value.buffer, value.byteOffset, value.byteLength)

Enviar objetos que no son de tipos nativos de JS, tales como objetos DOM (p.ej. Element, Location, DOMMatrix),objetos Node.js (p.ej. process.env, Stream), u objetos Electron (p.ej. WebContents, BrowserWindow, WebFrame) es obsoleto. En Electron 8, estos objetos serán serializados como antes con un mensaje DeprecationWarning, pero a partir de Electron 9, enviar estos tipos de objetos lanzará un error 'could not be cloned'.

Obsoleto: `<webview>.getWebContents()`

Esta API está implementada usando el módulo remote, el cual tiene implicaciones de rendimiento y seguridad. Por lo tanto, su uso debe ser explícito.

// Deprecated
webview.getWebContents()
// Replace with
const { remote } = require('electron')
remote.webContents.fromId(webview.getWebContentsId())

Sin embargo, es recomendado evitar el uso por completo del modulo remote.

// main
const { ipcMain, webContents } = require('electron')

const getGuestForWebContents = (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())

Obsoleto: `webFrame.setLayoutZoomLevelLimits()`

Chromium ha eliminado el soporte para cambiar los limites del nivel de zoom del diseño y esta más allá de la capacidad de Electron el mantenerlo. La función emitirá una advertencia en Electron 8.x, y dejará de existir en Electron 9.x. Los niveles de zoom limites ahora están fijados a un mínimo de 0.25 y un máximo de 5.0, como se define aquí.

Eventos obsoletos en `systemPreferences`

Los siguientes eventos systemPreferences han sido marcados como obsoletos:

inverted-color-scheme-changed
high-contrast-color-scheme-changed

Use el nuevo evento updated en el módulo nativeTheme en su lugar.

// Deprecated
systemPreferences.on('inverted-color-scheme-changed', () => { /* ... */ })
systemPreferences.on('high-contrast-color-scheme-changed', () => { /* ... */ })

// Replace with
nativeTheme.on('updated', () => { /* ... */ })

Obsoleto: métodos en `systemPreferences`

Los métodos siguientes de systemPreferences han quedado obsoletos:

systemPreferences.isDarkMode()
systemPreferences.isInvertedColorScheme()
systemPreferences.isHighContrastColorScheme()

En su lugar, usa las siguientes propiedades nativeTheme:

nativeTheme.shouldUseDarkColors
nativeTheme.shouldUseInvertedColorScheme
nativeTheme.shouldUseHighContrastColors

// Deprecated
systemPreferences.on('inverted-color-scheme-changed', () => { /* ... */ })
systemPreferences.on('high-contrast-color-scheme-changed', () => { /* ... */ })

// Replace with
nativeTheme.on('updated', () => { /* ... */ })

Cambios Planeados en la API (7.0)

Obsoleto: Atom.io Node Headers URL

Este es el URL especificado como disturl en un archivo .npmrc o como el comando de linea --dist-url al construir los módulos nativos de nodo. Ambos serán admitidos para el futuro previsible, pero se recomienda que cambies.

Obsoleto: https://atom.io/download/electron

Reemplazar con: https://electronjs.org/headers

API Modificada: `session.clearAuthCache()` ya no acepta opciones

La API session.clearAuthCache ya no acepta opciones de que limpiar y en su lugar incondicionalmente limpia la cache entera.

// Deprecated
session.clearAuthCache({ type: 'password' })
// Replace with
session.clearAuthCache()

API Modificada: `powerMonitor.querySystemIdleState` ahora es `powerMonitor.getSystemIdleState`

// Removed in Electron 7.0
powerMonitor.querySystemIdleState(threshold, callback)
// Replace with synchronous API
const idleState = powerMonitor.getSystemIdleState(threshold)

API Modificada: `powerMonitor.querySystemIdleTime` ahora es `powerMonitor.getSystemIdleTime`

// Removed in Electron 7.0
powerMonitor.querySystemIdleTime(callback)
// Replace with synchronous API
const idleTime = powerMonitor.getSystemIdleTime()

API Modificada: `webFrame.setIsolatedWorldInfo` reemplaza métodos separados

// Removed in Electron 7.0
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'
  })

Eliminado: propiedad `marked` en `getBlinkMemoryInfo`

Esta propiedad fue eliminada en Chromium 77, y como tal ya no está disponible.

Comportamiento Cambiado: atributo `webkitdirectory` a `<input type="file"/>` ahora lista el contenido del directorio

La propiedad webkitdirectory en las entradas de archivos HTML les permite seleccionar carpetas. Las versiones anteriores de Electron tenían una implementación incorrecta donde la entrada de event.target.files retornaba un FileList que retornaba un File correspondiente a la carpeta seleccionada.

A partir de Electron 7, que FileList lista todos los archivos contenido dentro de la carpeta, similar a Chrome, Firefox, y Edge (enlace a los documentos MDN).

Como una ilustración, toma una carpeta con esta estructura:

folder
├── file1
├── file2
└── file3

En Electron <=6, esto debería retornar un FileList con un objeto File para:

path/to/folder

En Electron 7, esto ahora retorna un FileList con un objeto File para:

/path/to/folder/file3
/path/to/folder/file2
/path/to/folder/file1

Tenga en cuenta que webkitdirectory ya no expone la ruta de la carpeta seleccionada. Si necesita la ruta a la carpeta seleccionada en lugar de los contenidos de la carpeta, vea la API Dialog. showOpenDialog (Link).

API Modificada: Versiones basadas en Callback de APIs promisificadas

Electron 5 y Electron 6 introdujeron versiones basadas en Promise de las API asíncornas existentes y desaprobaron sus contrapartes antiguas basadas en callback. En Electron 7, todas las APIs desaprobadas basadas en callback ahora están eliminadas.

Estas funciones ahora sólo devuelven Promises:

app.getFileIcon() #15742
app.dock.show() #16904
contentTracing.getCategories() #16583
contentTracing.getTraceBufferUsage() #16600
contentTracing.startRecording() #16584
contentTracing.stopRecording() #16584
contents.executeJavaScript() #17312
cookies.flushStore() #16464
cookies.get() #16464
cookies.remove() #16464
cookies.set() #16464
debugger.sendCommand() #16861
dialog.showCertificateTrustDialog() #17181
inAppPurchase.getProducts() #17355
inAppPurchase.purchaseProduct()#17355
netLog.stopLogging() #16862
session.clearAuthCache() #17259
session.clearCache() #17185
session.clearHostResolverCache() #17229
session.clearStorageData() #17249
session.getBlobData() #17303
session.getCacheSize() #17185
session.resolveProxy() #17222
session.setProxy() #17222
shell.openExternal() #16176
webContents.loadFile() #15855
webContents.loadURL() #15855
webContents.hasServiceWorker() #16535
webContents.printToPDF() #16795
webContents.savePage() #16742
webFrame.executeJavaScript() #17312
webFrame.executeJavaScriptInIsolatedWorld() #17312
webviewTag.executeJavaScript() #17312
win.capturePage() #15743

These functions now have two forms, synchronous and Promise-based asynchronous:

dialog.showMessageBox()/dialog.showMessageBoxSync() #17298
dialog.showOpenDialog()/dialog.showOpenDialogSync() #16973
dialog.showSaveDialog()/dialog.showSaveDialogSync() #17054

Cambios Planeados en la API (6.0)

API Modificada: `win.setMenu(null)` ahora es `win.removeMenu()`

// Deprecated
win.setMenu(null)
// Replace with
win.removeMenu()

API Modificada: `electron.screen` en el proceso renderer debe ser accedido a través de `remote`

// Deprecated
require('electron').screen
// Replace with
require('electron').remote.screen

API Modificada: `require()` los ing integrados de node builtins en renderizadores sandboxed no carga más de forma implícita la versión `remote`

// 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')

Obsoleto: `powerMonitor.querySystemIdleState` reemplazar con `powerMonitor.getSystemIdleState`

// Deprecated
powerMonitor.querySystemIdleState(threshold, callback)
// Replace with synchronous API
const idleState = powerMonitor.getSystemIdleState(threshold)

Obsoleto: `powerMonitor.querySystemIdleTime` reemplazado con `powerMonitor.getSystemIdleTime`

// Deprecated
powerMonitor.querySystemIdleTime(callback)
// Replace with synchronous API
const idleTime = powerMonitor.getSystemIdleTime()

Obsoleto: `app.enableMixedSandbox()` ya no es necesario

// Deprecated
app.enableMixedSandbox()

El modo Mixed-sandox ahora está activado por defecto.

Obsoleto: `Tray.setHighlightMode`

Bajo macOS Catalina nuestra implementación Tray se rompe. El sustituto nativo de Apple no soporta cambiar el comportamiento de resaltado.

// Deprecated
tray.setHighlightMode(mode)
// API will be removed in v7.0 without replacement.

Cambios Planeados en la API (5.0)

Valor por defecto modificado: `nodeIntegration` y `webviewTag` por defecto a false, `contextIsolation` por defecto a true

Los siguientes valores por defectos de opción webPreferences están obsoletos a favor de los nuevos valores por defectos listados a continuación.

Propiedad	Valor obsoleto	El valor por defecto nuevo
`contextIsolation`	`false`	`true`
`nodeIntegration`	`true`	`false`
`webviewTag`	`nodeIntegration` if set else `true`	`false`

P.e. Volver a habilitar el webviewTag

const w = new BrowserWindow({
  webPreferences: {
    webviewTag: true
  }
})

Comportamiento Modificado: `nodeIntegration` en ventanas hijas abiertas a través de `nativeWindowOpen`

Child windows opened with the nativeWindowOpen option will always have Node.js integration disabled, unless nodeIntegrationInSubFrames is true.

API Modificada: El registro de esquemas privilegiados ahora debe hacerse antes de que la aplicación este lista

Las APIs de Renderer Process webFrame.registerURLSchemeAsPrivileged y webFrame.registerURLSchemeAsBypassingCSP tal como la API del proceso de navegador protocol.registerStandardSchemes han sido eliminados. Una nueva API, protocol.registerSchemesAsPrivileged ha sido agregada y debe ser usada para registrar esquemas personalizados con los privilegios requeridos. Se requieren esquemas personalizados para ser registrados antes de que la aplicación esté lista.

Obsoleto: `webFrame.setIsolatedWorld*` reemplazado con `webFrame.setIsolatedWorldInfo`

// 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'
  })

API Modificada: `webFrame.setSpellCheckProvider` ahora toma un callbak asíncrono

El callback spellCheck ahora es asíncrono, y el parametro autoCorrectWord ha sido eliminado.

// 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)))
  }
})

API Modificada: `webContents.getZoomLevel` y `webContents.getZoomFactor` ahora son síncrono

webContents.getZoomLevel y webContents.getZoomFactor ya no toman parámetros callback, en su lugar devuelven directamente sus valores numéricos.

// Deprecated
webContents.getZoomLevel((level) => {
  console.log(level)
})
// Replace with
const level = webContents.getZoomLevel()
console.log(level)

// Deprecated
webContents.getZoomFactor((factor) => {
  console.log(factor)
})
// Replace with
const factor = webContents.getZoomFactor()
console.log(factor)

Cambios planeados en la API(4.0)

La siguiente lista incluye cambios efectuados en la API 4.0 de Electrón.

`app.makeSingleInstance`

// Deprecated
app.makeSingleInstance((argv, cwd) => {
  /* ... */
})
// Replace with
app.requestSingleInstanceLock()
app.on('second-instance', (event, argv, cwd) => {
  /* ... */
})

`app.releaseSingleInstance`

// Obsoleto
app.releaseSingleInstance()
// Reemplazar con
app.releaseSingleInstanceLock()

`app.getGPUInfo`

app.getGPUInfo('complete')
// Now behaves the same with `basic` on macOS
app.getGPUInfo('basic')

`win_delay_load_hook`

Cuando se construye módulos nativos para windows, la variable win_delay_load_hook del módulo binding.gyp debe ser true (el cual es por defecto). Si este hook no esta presente, luego el módulo nativo va a fallar al cargar en Windows, con un mensaje de error como Cannot find module. Consulte la guía de módulo nativo para más infromación.

Eliminado: soporte de Linux IA32

Electron 18 will no longer run on 32-bit Linux systems. See discontinuing support for 32-bit Linux for more information.

Cambios en la API(3.0)

La siguiente lista incluye cambios efectuados en la API 3.0 de Electrón.

`app`

// Deprecated
app.getAppMemoryInfo()
// Replace with
app.getAppMetrics()

// Deprecated
const metrics = app.getAppMetrics()
const { memory } = metrics[0] // Deprecated property

`BrowserWindow`

// Deprecated
const optionsA = { webPreferences: { blinkFeatures: '' } }
const windowA = new BrowserWindow(optionsA)
// Replace with
const optionsB = { webPreferences: { enableBlinkFeatures: '' } }
const windowB = new BrowserWindow(optionsB)

// 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
  }
})

`clipboard`

// Cambiar
clipboard.readRtf()
// Reemplazar con
clipboard.readRTF()

// Cambiar
clipboard.writeRtf()
// Reemplazar con
clipboard.writeRTF()

// Cambiar
clipboard.readHtml()
// Reemplazar con
clipboard.readHTML()

// Cambiar
clipboard.writeHtml()
// Reemplazar con
clipboard.writeHTML()

`crashReporter`

// Cambiar
crashReporter.start({
  companyName: 'Crashly',
  submitURL: 'https://crash.server.com',
  autoSubmit: true
})
// Reemplazar con
crashReporter.start({
  companyName: 'Crashly',
  submitURL: 'https://crash.server.com',
  uploadToServer: true
})

`nativeImage`

// Obsoleto
nativeImage.createFromBuffer(buffer, 1.0)
// Reemplazar con
nativeImage.createFromBuffer(buffer, {
  scaleFactor: 1.0
})

`process`

// Deprecated
const info = process.getProcessMemoryInfo()

`screen`

// Obsoleto
screen.getMenuBarHeight()
// Reemplazar con
screen.getPrimaryDisplay().workArea

`session`

// Deprecated
ses.setCertificateVerifyProc((hostname, certificate, callback) => {
  callback(true)
})
// Replace with
ses.setCertificateVerifyProc((request, callback) => {
  callback(0)
})

`Tray`

// Cambiar
tray.setHighlightMode(true)
// Reemplazar con
tray.setHighlightMode('on')

// Cambiar
tray.setHighlightMode(false)
// Reemplazar con
tray.setHighlightMode('off')

`webContents`

// Deprecated
webContents.openDevTools({ detach: true })
// Replace with
webContents.openDevTools({ mode: 'detach' })

// Removed
webContents.setSize(options)
// There is no replacement for this API

`webFrame`

// Deprecated
webFrame.registerURLSchemeAsSecure('app')
// Replace with
protocol.registerStandardSchemes(['app'], { secure: true })

// Deprecated
webFrame.registerURLSchemeAsPrivileged('app', { secure: true })
// Replace with
protocol.registerStandardSchemes(['app'], { secure: true })

`<webview>`

// Eliminado
webview.setAttribute('disableguestresize', '')
// No hay reemplazo para esto en la API

// Eliminado
webview.setAttribute('guestinstance', instanceId)
// No hay reemplazo para esto en la API

// Los eventos de tecldo ya no funcionan en la etiqueta de webview
webview.onkeydown = () => { /* handler */ }
webview.onkeyup = () => { /* handler */ }

URL de cabecera de nodo

Este es el URL especificado como disturl en un archivo .npmrc o como el comando de linea --dist-url al construir los módulos nativos de nodo.

Cambiar: https://atom.io/download/atom-shell

Reemplazar con: https://atom.io/download/electron

Cambios en la API(2.0)

La siguiente lista incluye cambios efectuados en la API 2.0 de Electrón.

`BrowserWindow`

// Deprecated
const optionsA = { titleBarStyle: 'hidden-inset' }
const windowA = new BrowserWindow(optionsA)
// Replace with
const optionsB = { titleBarStyle: 'hiddenInset' }
const windowB = new BrowserWindow(optionsB)

`menu`

// Removed
menu.popup(browserWindow, 100, 200, 2)
// Replaced with
menu.popup(browserWindow, { x: 100, y: 200, positioningItem: 2 })

`nativeImage`

// Obsoleto
nativeImage.toPng()
// Reemplazar con
nativeImage.toPNG()

// Obsoleto
nativeImage.toJpeg()
// Reemplazar con
nativeImage.toJPEG()

`process`

Versión de procesos de Electron y Versión de procesos de Chrome Serán propiedades de solo lectura para la consistencia con otras propiedades de process.versions configuradas por Node.

`webContents`

// Obsoleto
webContents.setZoomLevelLimits(1, 2)
// Reemplazar con
webContents.setVisualZoomLevelLimits(1, 2)

`webFrame`

// Obsoleto
webFrame.setZoomLevelLimits(1, 2)
// Reemplazar con
webFrame.setVisualZoomLevelLimits(1, 2)

`<webview>`

// Obsoleto
webview.setZoomLevelLimits(1, 2)
// Reemplazar con
webview.setVisualZoomLevelLimits(1, 2)

Duplicado de brazo ARM

Cada versión de Electrón incluye dos versiones de ARM idénticas con diferentes nombres de archivo, como: electron-v1.7.3-linux-arm.zip y electron-v1.7.3-linux-armv7l.zip. Se agregó el archivo con el prefijo v7l para aclarar a los usuarios qué versión de ARM soporta y desambiguar los futuros archivos de armv6l y arm64 que pueden ser producidos.

El archivo sin el prefijo todavía se está publicando para evitar romper cualquier configuración que pueda estar consumiéndolo. A partir de 2.0, el archivo sin prefijo ya no será publicado.

Para más detalles, vea: 6986 y 7189.

Tipos de cambios de ruptura
Cambios Planeados en la API (23.0)
- Comportamiento cambiado: Regiones arrastrables en macOS
- Eliminado: Soporte para Windows 7 / 8 / 8.1
- Eliminado: eventos BrowserWindow scroll-touch-*
- Eliminado: webContents.incrementCapturerCount(stayHidden, stayAwake)
- Eliminado: webContents.decrementCapturerCount(stayHidden, stayAwake)
Cambios Planeados en la API (22.0)
- Obsoleto: webContents.incrementCapturerCount(stayHidden, stayAwake)
- Obsoleto: webContents.decrementCapturerCount(stayHidden, stayAwake)
- Eliminado: evento new-window de Webcontens
- Eliminado: eventos scroll-touch-* de BrowserWindow
Cambios Planeados en la API (21.0)
- Comportamiento modificado: V8 Memory Cage habilitado
- API modificada: webContents.printToPDF()
Cambios Planeados en la API (20.0)
- Removed: macOS 10.11 / 10.12 support
- Default Changed: renderers without nodeIntegration: true are sandboxed by default
- Eliminado: skipTaskbar en Linux
- API Changed: session.setDevicePermissionHandler(handler)
Cambios Planeados en la API (19.0)
- Elimnado: IA32 Binarios Linux
Cambios Planeados en la API (18.0)
- Eliminada: nativeWindowOpen
Cambios Planeados en la API (17.0)
- Eliminado: desktopCapturer.getSources en el renderizador
- Deprecated: nativeWindowOpen
Cambios Planeados en la API (16.0)
- Behavior Changed: crashReporter implementation switched to Crashpad on Linux
- Deprecated: desktopCapturer.getSources in the renderer
Cambios en API Planeados (15.0)
- Valor por defecto modificado: nativeWindowOpen por defecto a true
Cambios Planeados en la API (14.0)
- Eliminado: módulo remote
- Eliminada: app.allowRendererProcessReuse
- Eliminado: Browser Window Affinity
- API modificada: window.open()
- Eliminado: worldSafeExecuteJavaScript
- Eliminado: BrowserWindowConstructorOptions que hereda desde las ventanas padres
- Eliminada: additionalFeatures
Cambios Planeados en la API (13.0)
- API modificada: session.setPermissionCheckHandler(handler)
- Eliminado: shell.moveItemToTrash()
- Eliminado: APIs de extensión BrowserWindow
- Eliminado: métodos en systemPreferences
- En desuso: evento Webcontens nueva ventana
Cambios Planeados en la API (12.0)
- Eliminado: Soporte de Pepper Flash
- Valor por defecto moidificado: worldSafeExecuteJavaScript por defecto a true
- Valor por defecto modificado: contextIsolation por defecto a true
- Eliminado: crashReporter.getCrashesDirectory()
- Eliminado: métodos crashReporter en el render process
- Valor por defecto modificado: crashReporter.start({ compress: true })
- Obsoleto: módulo remote
- Obsoleto: shell.moveItemToTrash()
Cambios Planeados en la API (11.0)
- Eliminado: BrowserView.{destroy, fromId, fromWebContents, getAllViews} y id propiedad de BrowserView
Cambios Planeados en la API (10.0)
- Desaprobado: argumento companyName para crashReporter.start()
- Obsoleto: crashReporter.getCrashesDirectory()
- Obsoleto: los métodos crashReporter en el renderer process
- Obsoleto: crashReporter.start({ compress: false })
- Valor por defecto modificado: enableRemoteModule por defecto a false
- unregisterProtocol
- uninterceptProtocol
- registerFileProtocol
- registerBufferProtocol
- registerStringProtocol
- registerHttpProtocol
- registerStreamProtocol
- interceptFileProtocol
- interceptStringProtocol
- interceptStringProtocol
- interceptHttpProtocol
- interceptStreamProtocol
- isProtocolHandled
Cambios Planeados en la API (9.0)
- Valor por defecto modificado: La carga de módulos nativos sin contexto conscientes en el proceso renderer está desactivada por defecto
- Obsoleto: APIs de extensión BrowserWindow
- Eliminado: <webview>.getWebContents()
- Eliminada: webFrame.setLayoutZoomLevelLimits()
- Comportamiento Modificado: Enviando objetos no JS sobre IPC ahora lanza una excepción
- API Modificada: shell.openItem ahora es shell.openPath
Cambios Planeados en la API (8.0)
- Comportamiento Cambiado: Los valores enviados sobre IPC ahora son serializados con Algoritmo de Clon Estructurado
- Obsoleto: <webview>.getWebContents()
- Obsoleto: webFrame.setLayoutZoomLevelLimits()
- Eventos obsoletos en systemPreferences
- Obsoleto: métodos en systemPreferences
Cambios Planeados en la API (7.0)
- Obsoleto: Atom.io Node Headers URL
- API Modificada: session.clearAuthCache() ya no acepta opciones
- API Modificada: powerMonitor.querySystemIdleState ahora es powerMonitor.getSystemIdleState
- API Modificada: powerMonitor.querySystemIdleTime ahora es powerMonitor.getSystemIdleTime
- API Modificada: webFrame.setIsolatedWorldInfo reemplaza métodos separados
- Eliminado: propiedad marked en getBlinkMemoryInfo
- Comportamiento Cambiado: atributo webkitdirectory a <input type="file"/> ahora lista el contenido del directorio
- API Modificada: Versiones basadas en Callback de APIs promisificadas
Cambios Planeados en la API (6.0)
- API Modificada: win.setMenu(null) ahora es win.removeMenu()
- API Modificada: electron.screen en el proceso renderer debe ser accedido a través de remote
- API Modificada: require() los ing integrados de node builtins en renderizadores sandboxed no carga más de forma implícita la versión remote
- Obsoleto: powerMonitor.querySystemIdleState reemplazar con powerMonitor.getSystemIdleState
- Obsoleto: powerMonitor.querySystemIdleTime reemplazado con powerMonitor.getSystemIdleTime
- Obsoleto: app.enableMixedSandbox() ya no es necesario
- Obsoleto: Tray.setHighlightMode
Cambios Planeados en la API (5.0)
- Valor por defecto modificado: nodeIntegration y webviewTag por defecto a false, contextIsolation por defecto a true
- Comportamiento Modificado: nodeIntegration en ventanas hijas abiertas a través de nativeWindowOpen
- API Modificada: El registro de esquemas privilegiados ahora debe hacerse antes de que la aplicación este lista
- Obsoleto: webFrame.setIsolatedWorld* reemplazado con webFrame.setIsolatedWorldInfo
- API Modificada: webFrame.setSpellCheckProvider ahora toma un callbak asíncrono
- API Modificada: webContents.getZoomLevel y webContents.getZoomFactor ahora son síncrono
Cambios planeados en la API(4.0)
- makeSingleInstance
- releaseSingleInstance
- getGPUInfo
- win_delay_load_hook
- Eliminado: soporte de Linux IA32
Cambios en la API(3.0)
- app
- BrowserWindow
- clipboard
- crashReporter
- nativeImage
- process
- screen
- session
- Tray
- webContents
- webFrame
- <webview>
- URL de cabecera de nodo
Cambios en la API(2.0)
- BrowserWindow
- menu
- nativeImage
- process
- webContents
- webFrame
- <webview>
- Duplicado de brazo ARM

Restaurar archivos borrados

Tipos de cambios de ruptura​

Cambios Planeados en la API (23.0)​

Comportamiento cambiado: Regiones arrastrables en macOS​

Eliminado: Soporte para Windows 7 / 8 / 8.1​

Eliminado: eventos BrowserWindow scroll-touch-*​

Eliminado: webContents.incrementCapturerCount(stayHidden, stayAwake)​

Eliminado: webContents.decrementCapturerCount(stayHidden, stayAwake)​

Cambios Planeados en la API (22.0)​

Obsoleto: webContents.incrementCapturerCount(stayHidden, stayAwake)​

Obsoleto: webContents.decrementCapturerCount(stayHidden, stayAwake)​

Eliminado: evento new-window de Webcontens​

Eliminado: eventos scroll-touch-* de BrowserWindow​

Cambios Planeados en la API (21.0)​

Comportamiento modificado: V8 Memory Cage habilitado​

API modificada: webContents.printToPDF()​

Cambios Planeados en la API (20.0)​

Removed: macOS 10.11 / 10.12 support​

Default Changed: renderers without nodeIntegration: true are sandboxed by default​

Eliminado: skipTaskbar en Linux​

API Changed: session.setDevicePermissionHandler(handler)​

Cambios Planeados en la API (19.0)​

Elimnado: IA32 Binarios Linux​

Cambios Planeados en la API (18.0)​

Eliminada: nativeWindowOpen​

Cambios Planeados en la API (17.0)​

Eliminado: desktopCapturer.getSources en el renderizador​

Deprecated: nativeWindowOpen​

Cambios Planeados en la API (16.0)​

Behavior Changed: crashReporter implementation switched to Crashpad on Linux​

Deprecated: desktopCapturer.getSources in the renderer​

Cambios en API Planeados (15.0)​

Valor por defecto modificado: nativeWindowOpen por defecto a true​

Cambios Planeados en la API (14.0)​

Eliminado: módulo remote​

Eliminada: app.allowRendererProcessReuse​

Eliminado: Browser Window Affinity​

API modificada: window.open()​

Eliminado: worldSafeExecuteJavaScript​

Eliminado: BrowserWindowConstructorOptions que hereda desde las ventanas padres​

Eliminada: additionalFeatures​

Cambios Planeados en la API (13.0)​

API modificada: session.setPermissionCheckHandler(handler)​

Eliminado: shell.moveItemToTrash()​

Eliminado: APIs de extensión BrowserWindow​

Eliminado: métodos en systemPreferences​

En desuso: evento Webcontens nueva ventana​

Cambios Planeados en la API (12.0)​

Eliminado: Soporte de Pepper Flash​

Valor por defecto moidificado: worldSafeExecuteJavaScript por defecto a true​

Valor por defecto modificado: contextIsolation por defecto a true​

Eliminado: crashReporter.getCrashesDirectory()​

Eliminado: métodos crashReporter en el render process​

Valor por defecto modificado: crashReporter.start({ compress: true })​

Obsoleto: módulo remote​

Obsoleto: shell.moveItemToTrash()​

Cambios Planeados en la API (11.0)​

Eliminado: BrowserView.{destroy, fromId, fromWebContents, getAllViews} y id propiedad de BrowserView​

Cambios Planeados en la API (10.0)​

Desaprobado: argumento companyName para crashReporter.start()​

Obsoleto: crashReporter.getCrashesDirectory()​

Obsoleto: los métodos crashReporter en el renderer process​

Obsoleto: crashReporter.start({ compress: false })​

Valor por defecto modificado: enableRemoteModule por defecto a false​

protocol.unregisterProtocol​

protocol.uninterceptProtocol​

protocol.registerFileProtocol​

protocol.registerBufferProtocol​

protocol.registerStringProtocol​

protocol.registerHttpProtocol​

protocol.registerStreamProtocol​

protocol.interceptFileProtocol​

protocol.interceptStringProtocol​

protocol.interceptStringProtocol​

protocol.interceptHttpProtocol​

protocol.interceptStreamProtocol​

protocol.isProtocolHandled​

Cambios Planeados en la API (9.0)​

Valor por defecto modificado: La carga de módulos nativos sin contexto conscientes en el proceso renderer está desactivada por defecto​

Obsoleto: APIs de extensión BrowserWindow​

Tipos de cambios de ruptura

Cambios Planeados en la API (23.0)

Comportamiento cambiado: Regiones arrastrables en macOS

Eliminado: Soporte para Windows 7 / 8 / 8.1

Eliminado: eventos BrowserWindow `scroll-touch-*`

Eliminado: `webContents.incrementCapturerCount(stayHidden, stayAwake)`

Eliminado: `webContents.decrementCapturerCount(stayHidden, stayAwake)`

Cambios Planeados en la API (22.0)

Obsoleto: `webContents.incrementCapturerCount(stayHidden, stayAwake)`

Obsoleto: `webContents.decrementCapturerCount(stayHidden, stayAwake)`

Eliminado: evento `new-window` de Webcontens

Eliminado: eventos `scroll-touch-*` de BrowserWindow

Cambios Planeados en la API (21.0)

Comportamiento modificado: V8 Memory Cage habilitado

API modificada: `webContents.printToPDF()`

Cambios Planeados en la API (20.0)

Removed: macOS 10.11 / 10.12 support

Default Changed: renderers without `nodeIntegration: true` are sandboxed by default

Eliminado: `skipTaskbar` en Linux

API Changed: `session.setDevicePermissionHandler(handler)`

Cambios Planeados en la API (19.0)

Elimnado: IA32 Binarios Linux

Cambios Planeados en la API (18.0)

Eliminada: `nativeWindowOpen`

Cambios Planeados en la API (17.0)

Eliminado: `desktopCapturer.getSources` en el renderizador

Deprecated: `nativeWindowOpen`

Cambios Planeados en la API (16.0)

Behavior Changed: `crashReporter` implementation switched to Crashpad on Linux

Deprecated: `desktopCapturer.getSources` in the renderer

Cambios en API Planeados (15.0)

Valor por defecto modificado: `nativeWindowOpen` por defecto a `true`

Cambios Planeados en la API (14.0)

Eliminado: módulo `remote`

Eliminada: `app.allowRendererProcessReuse`

Eliminado: Browser Window Affinity

API modificada: `window.open()`

Eliminado: `worldSafeExecuteJavaScript`

Eliminado: BrowserWindowConstructorOptions que hereda desde las ventanas padres

Eliminada: `additionalFeatures`

Cambios Planeados en la API (13.0)

API modificada: `session.setPermissionCheckHandler(handler)`

Eliminado: `shell.moveItemToTrash()`

Eliminado: APIs de extensión `BrowserWindow`

Eliminado: métodos en `systemPreferences`

En desuso: evento Webcontens `nueva ventana`

Cambios Planeados en la API (12.0)

Eliminado: Soporte de Pepper Flash

Valor por defecto moidificado: `worldSafeExecuteJavaScript` por defecto a `true`

Valor por defecto modificado: `contextIsolation` por defecto a `true`

Eliminado: `crashReporter.getCrashesDirectory()`

Eliminado: métodos `crashReporter` en el render process

Valor por defecto modificado: `crashReporter.start({ compress: true })`

Obsoleto: módulo `remote`

Obsoleto: `shell.moveItemToTrash()`

Cambios Planeados en la API (11.0)

Eliminado: `BrowserView.{destroy, fromId, fromWebContents, getAllViews}` y `id` propiedad de `BrowserView`

Cambios Planeados en la API (10.0)

Desaprobado: argumento `companyName` para `crashReporter.start()`

Obsoleto: `crashReporter.getCrashesDirectory()`

Obsoleto: los métodos `crashReporter` en el renderer process

Obsoleto: `crashReporter.start({ compress: false })`

Valor por defecto modificado: `enableRemoteModule` por defecto a `false`

`protocol.unregisterProtocol`

`protocol.uninterceptProtocol`

`protocol.registerFileProtocol`

`protocol.registerBufferProtocol`

`protocol.registerStringProtocol`

`protocol.registerHttpProtocol`

`protocol.registerStreamProtocol`

`protocol.interceptFileProtocol`

`protocol.interceptStringProtocol`

`protocol.interceptStringProtocol`

`protocol.interceptHttpProtocol`

`protocol.interceptStreamProtocol`

`protocol.isProtocolHandled`

Cambios Planeados en la API (9.0)

Valor por defecto modificado: La carga de módulos nativos sin contexto conscientes en el proceso renderer está desactivada por defecto

Obsoleto: APIs de extensión `BrowserWindow`

Eliminado: `<webview>.getWebContents()`