重大变更

重大变更将在此处记录，并在可行的情况下，至少在变更实施前一个主要版本中向 JS 代码添加弃用警告。

重大变更的类型

本文档使用以下约定对重大变更进行分类

API 变更: API 发生了更改，未更新的代码必然会抛出异常。
行为变更: Electron 的行为发生了变化，但不是必然会抛出异常的方式。
默认值变更: 依赖旧默认值的代码可能会损坏，但不一定抛出异常。可以通过显式指定值来恢复旧行为。
已弃用: API 已标记为弃用。该 API 将继续工作，但会发出弃用警告，并在未来版本中移除。
已移除: API 或功能已移除，Electron 不再支持。

计划的重大 API 变更 (37.0)

行为变更: Linux 上的 `BrowserWindow.IsVisibleOnAllWorkspaces()`

如果窗口当前不可见，Linux 上的 BrowserWindow.IsVisibleOnAllWorkspaces() 现在将返回 false。

行为变更: `app.commandLine`

app.commandLine 会将大写的开关和参数转换为小写。

app.commandLine 只用于处理 chromium 开关（不区分大小写），并且通过 app.commandLine 传递的开关不会传递给任何子进程。

如果您使用 app.commandLine 控制主进程的行为，则应通过 process.argv 进行。

已弃用: `NativeImage.getBitmap()`

NativeImage.toBitmap() 返回位图的新分配副本。NativeImage.getBitmap() 最初是一个替代函数，返回原始位图而非副本。在引入沙箱后，这发生了变化，因此两者都返回副本，功能上等效。

客户端代码应改为调用 NativeImage.toBitmap()

// Deprecated
bitmap = image.getBitmap()
// Use this instead
bitmap = image.toBitmap()

计划的重大 API 变更 (36.0)

已移除: `PrinterInfo` 上的 `isDefault` 和 `status` 属性

这些属性已从 PrinterInfo 对象中移除，因为它们已从上游 Chromium 中移除。

已移除: `Session.clearStorageData(options)` 中的 `quota` 类型 `syncable`

调用 Session.clearStorageData(options) 时，不再支持 options.quota 类型 syncable，因为它已从上游 Chromium 中移除。

已弃用: `Session.clearStorageData(options)` 中的 `quota` 属性

调用 Session.clearStorageData(options) 时，options.quota 属性已弃用。由于 syncable 类型已移除，只剩下 'temporary' 类型，因此无需指定它。

已弃用: `ProtocolResponse` 中 `session` 属性的 `null` 值

以前，将 ProtocolResponse.session 属性设置为 null 会创建一个随机的独立会话。现在不再支持此操作。

由于开销原因，不建议在此处使用单用途会话；但是，需要保留此行为的旧代码可以通过使用 session.fromPartition(some_random_string) 创建一个随机会话，然后在 ProtocolResponse.session 中使用它来模拟此行为。

已弃用: `session` 上的扩展方法和事件

session.loadExtension、session.removeExtension、session.getExtension、session.getAllExtensions、'extension-loaded' 事件、'extension-unloaded' 事件和 'extension-ready' 事件都已移至新的 session.extensions 类。

已移除: `systemPreferences.isAeroGlassEnabled()`

systemPreferences.isAeroGlassEnabled() 函数已移除，没有替代项。自 Electron 23 以来，它一直返回 true，该版本仅支持 Windows 10+，其中 DWM 合成无法再禁用。

https://learn.microsoft.com/en-us/windows/win32/dwm/composition-ovw#disabling-dwm-composition-windows7-and-earlier

已变更: 在运行 GNOME 时，GTK 4 为默认设置

在上游变更后，运行 GNOME 时 GTK 4 现在为默认设置。

在极少数情况下，这可能会导致某些应用程序或配置出现以下错误消息

Gtk-ERROR **: 11:30:38.382: GTK 2/3 symbols detected. Using GTK 2/3 and GTK 4 in the same process is not supported

受影响的用户可以通过指定 gtk-version 命令行标志来解决此问题

$ electron --gtk-version=3   # or --gtk-version=2

也可以使用app.commandLine.appendSwitch 函数实现相同效果。

计划的重大 API 变更 (35.0)

行为变更: Linux 上 Dialog API 的 `defaultPath` 选项

在 Linux 上，文件对话框所需的 portal 版本已从 4 回退到 3。使用 portal 文件选择器对话框时，除非 portal 后端版本为 4 或更高，否则不支持使用 Dialog API 的 defaultPath 选项。--xdg-portal-required-version 命令行开关可以用于强制您的应用程序使用所需的版本。有关详细信息，请参阅#44426。

已弃用: `session.serviceWorkers` 上的 `getFromVersionID`

session.serviceWorkers.fromVersionID(versionId) API 已弃用，取而代之的是 session.serviceWorkers.getInfoFromVersionID(versionId)。此更改旨在随着 session.serviceWorkers.getWorkerFromVersionID(versionId) API 的引入，使其更清晰地表明返回的是哪个对象。

// Deprecated
session.serviceWorkers.fromVersionID(versionId)

// Replace with
session.serviceWorkers.getInfoFromVersionID(versionId)

已弃用: `Session` 上的 `setPreloads`、`getPreloads`

引入了 registerPreloadScript、unregisterPreloadScript 和 getPreloadScripts 作为弃用方法的替代。这些新的 API 允许第三方库注册预加载脚本，而无需替换现有脚本。此外，新的 type 选项允许除了 frame 之外的额外预加载目标。

// Deprecated
session.setPreloads([path.join(__dirname, 'preload.js')])

// Replace with:
session.registerPreloadScript({
  type: 'frame',
  id: 'app-preload',
  filePath: path.join(__dirname, 'preload.js')
})

已弃用: `WebContents` 上 `console-message` 事件中的 `level`、`message`、`line` 和 `sourceId` 参数

WebContents 上的 console-message 事件已更新，以便在 Event 参数中提供详细信息。

// Deprecated
webContents.on('console-message', (event, level, message, line, sourceId) => {})

// Replace with:
webContents.on('console-message', ({ level, message, lineNumber, sourceId, frame }) => {})

此外，level 现在是一个字符串，可能的值包括 info、warning、error 和 debug。

行为变更: `WebRequestFilter` 的 `urls` 属性。

以前，空的 urls 数组被解释为包含所有 URL。现在，要显式包含所有 URL，开发人员应使用 <all_urls> 模式，这是一个匹配所有可能 URL 的指定 URL 模式。此更改澄清了意图并确保了更可预测的行为。

// Deprecated
const deprecatedFilter = {
  urls: []
}

// Replace with
const newFilter = {
  urls: ['<all_urls>']
}

已弃用: `systemPreferences.isAeroGlassEnabled()`

systemPreferences.isAeroGlassEnabled() 函数已弃用，没有替代项。自 Electron 23 以来，它一直返回 true，该版本仅支持 Windows 10+，其中 DWM 合成无法再禁用。

https://learn.microsoft.com/en-us/windows/win32/dwm/composition-ovw#disabling-dwm-composition-windows7-and-earlier

计划的重大 API 变更 (34.0)

这使得该行为与 Linux 保持一致。之前的行为：在 Windows 全屏期间，菜单栏仍然可见。新行为：在 Windows 全屏期间，菜单栏被隐藏。

更正：这以前在 Electron 33 中列为重大变更，但首次发布是在 Electron 34 中。

计划的重大 API 变更 (33.0)

已弃用: `document.execCommand("paste")`

同步剪贴板读取 API document.execCommand("paste") 已弃用，取而代之的是 async clipboard API。这是为了与浏览器默认行为保持一致。

WebPreferences 上用于触发此 API 权限检查的 enableDeprecatedPaste 选项以及相关的权限类型 deprecated-sync-clipboard-read 也已弃用。

行为变更: 帧属性可能会检索到分离的 WebFrameMain 实例或根本没有

提供对 WebFrameMain 实例访问的 API 可能会返回一个 frame.detached 设置为 true 的实例，或者可能返回 null。

当一个帧执行跨源导航时，它会进入分离状态，不再附加到页面。在此状态下，它可能在被删除之前运行卸载处理程序。如果在该状态期间发送 IPC，则 frame.detached 将设置为 true，该帧不久后将被销毁。

接收事件时，务必在接收到后立即访问 WebFrameMain 属性。否则，无法保证其指向与接收时相同的网页。为避免预期不符，在网页已更改的后期访问情况下，Electron 将返回 null。

ipcMain.on('unload-event', (event) => {
  event.senderFrame // ✅ accessed immediately
})

ipcMain.on('unload-event', async (event) => {
  await crossOriginNavigationPromise
  event.senderFrame // ❌ returns `null` due to late access
})

行为变更: Windows 上的自定义协议 URL 处理

由于 Chromium 为支持非特殊方案 URL 所做的更改，使用 Windows 文件路径的自定义协议 URL 将不再与已弃用的 protocol.registerFileProtocol 以及 BrowserWindow.loadURL、WebContents.loadURL 和 <webview>.loadURL 上的 baseURLForDataURL 属性正确工作。protocol.handle 也无法处理这些类型的 URL，但这并非更改，因为它始终是这样工作的。

// No longer works
protocol.registerFileProtocol('other', () => {
  callback({ filePath: '/path/to/my/file' })
})

const mainWindow = new BrowserWindow()
mainWindow.loadURL('data:text/html,<script src="loaded-from-dataurl.js"></script>', { baseURLForDataURL: 'other://C:\\myapp' })
mainWindow.loadURL('other://C:\\myapp\\index.html')

// Replace with
const path = require('node:path')
const nodeUrl = require('node:url')
protocol.handle(other, (req) => {
  const srcPath = 'C:\\myapp\\'
  const reqURL = new URL(req.url)
  return net.fetch(nodeUrl.pathToFileURL(path.join(srcPath, reqURL.pathname)).toString())
})

mainWindow.loadURL('data:text/html,<script src="loaded-from-dataurl.js"></script>', { baseURLForDataURL: 'other://' })
mainWindow.loadURL('other://index.html')

行为变更: `app` 上 `login` 事件的 `webContents` 属性

当 app 的 login 事件因从使用 respondToAuthRequestsFromMainProcess 选项创建的utility process 发出的请求而触发时，事件中的 webContents 属性将为 null。

已弃用: `BrowserWindowConstructorOption.type` 中的 `textured` 选项

BrowserWindowConstructorOptions 中 type 的 textured 选项已弃用，没有替代项。此选项依赖于 macOS 上的NSWindowStyleMaskTexturedBackground 样式掩码，该掩码已弃用且无替代方案。

已移除: macOS 10.15 支持

Chromium 不再支持 macOS 10.15 (Catalina)。

旧版 Electron 将继续在 Catalina 上运行，但运行 Electron v33.0.0 及更高版本需要 macOS 11 (Big Sur) 或更高版本。

行为变更: 原生模块现在需要 C++20

由于上游的更改，V8 和 Node.js 现在都要求 C++20 作为最低版本。使用原生 Node 模块的开发人员应使用 --std=c++20 构建其模块，而不是 --std=c++17。使用 gcc9 或更低版本的镜像可能需要更新到 gcc10 才能编译。有关详细信息，请参阅#43555。

已弃用: `systemPreferences.accessibilityDisplayShouldReduceTransparency`

systemPreferences.accessibilityDisplayShouldReduceTransparency 属性现已弃用，取而代之的是新的 nativeTheme.prefersReducedTransparency，它提供相同的信息并且跨平台工作。

// Deprecated
const shouldReduceTransparency = systemPreferences.accessibilityDisplayShouldReduceTransparency

// Replace with:
const prefersReducedTransparency = nativeTheme.prefersReducedTransparency

计划的重大 API 变更 (32.0)

已移除: `File.path`

Web File 对象的非标准 path 属性在早期版本的 Electron 中添加，作为在渲染进程中处理本地文件更常见时的一种便捷方法。然而，它代表着对标准的偏离，也存在轻微的安全风险，因此自 Electron 32.0 起，已将其移除，转而支持webUtils.getPathForFile 方法。

// Before (renderer)

const file = document.querySelector('input[type=file]').files[0]
alert(`Uploaded file path was: ${file.path}`)

// After (renderer)

const file = document.querySelector('input[type=file]').files[0]
electron.showFilePath(file)

// (preload)
const { contextBridge, webUtils } = require('electron')

contextBridge.exposeInMainWorld('electron', {
  showFilePath (file) {
    // It's best not to expose the full file path to the web content if
    // possible.
    const path = webUtils.getPathForFile(file)
    alert(`Uploaded file path was: ${path}`)
  }
})

已弃用: `WebContents` 上的 `clearHistory`、`canGoBack`、`goBack`、`canGoForward`、`goForward`、`goToIndex`、`canGoToOffset`、`goToOffset`

导航相关的 API 现已弃用。

这些 API 已移至 WebContents 的 navigationHistory 属性，以提供更结构化、更直观的界面来管理导航历史记录。

// Deprecated
win.webContents.clearHistory()
win.webContents.canGoBack()
win.webContents.goBack()
win.webContents.canGoForward()
win.webContents.goForward()
win.webContents.goToIndex(index)
win.webContents.canGoToOffset()
win.webContents.goToOffset(index)

// Replace with
win.webContents.navigationHistory.clear()
win.webContents.navigationHistory.canGoBack()
win.webContents.navigationHistory.goBack()
win.webContents.navigationHistory.canGoForward()
win.webContents.navigationHistory.goForward()
win.webContents.navigationHistory.canGoToOffset()
win.webContents.navigationHistory.goToOffset(index)

行为变更: `userData` 中的 `databases` 目录将被删除

如果在 app.getPath('userData') 返回的目录中有一个名为 databases 的目录，它将在首次运行 Electron 32 时被删除。databases 目录曾被 WebSQL 使用，WebSQL 在 Electron 31 中被移除。Chromium 现在执行清理，会删除此目录。请参阅issue #45396。

计划的重大 API 变更 (31.0)

已移除: `WebSQL` 支持

Chromium 已在上游移除对 WebSQL 的支持，并将其转换为仅限 Android。有关详细信息，请参阅Chromium 的移除意图讨论。

行为变更: `nativeImage.toDataURL` 将保留 PNG 色彩空间

PNG 解码器实现已更改为保留色彩空间数据，此函数返回的编码数据现在与之匹配。

有关详细信息，请参阅crbug.com/332584706。

行为变更: 在 macOS 上，`window.flashFrame(bool)` 将持续闪烁 dock 图标

这使得该行为与 Windows 和 Linux 保持一致。之前的行为：第一次调用 flashFrame(true) 只弹跳一次 dock 图标（使用 NSInformationalRequest 级别），而 flashFrame(false) 不执行任何操作。新行为：持续闪烁直到调用 flashFrame(false)。这将使用 NSCriticalRequest 级别。要显式使用 NSInformationalRequest 来使 dock 图标弹跳一次，仍然可以使用dock.bounce('informational')。

计划的重大 API 变更 (30.0)

行为变更: 跨源 iframe 现在使用权限策略访问功能

跨源 iframe 现在必须通过 allow 属性指定给定 iframe 可用的功能，才能访问它们。

有关详细信息，请参阅文档。

已移除: `--disable-color-correct-rendering` 开关

此开关从未正式记录，但无论如何在此处注明其移除。Chromium 本身现在对色彩空间有更好的支持，因此不再需要此标志。

行为变更: macOS 上的 `BrowserView.setAutoResize` 行为

在 Electron 30 中，BrowserView 现在是新的WebContentsView API 的一个包装器。

以前，BrowserView API 的 setAutoResize 功能在 macOS 上由 autoresizing 支持，在 Windows 和 Linux 上由自定义算法支持。对于简单用例（例如使 BrowserView 填充整个窗口），这两种方法的行为是相同的。然而，在更高级的情况下，BrowserViews 在 macOS 上的 autoresizing 方式与其他平台不同，因为 Windows 和 Linux 的自定义调整大小算法与 macOS 的 autoresizing API 的行为并不完全匹配。现在，所有平台上的 autoresizing 行为都已标准化。

如果您的应用程序使用 BrowserView.setAutoResize 执行比使 BrowserView 填充整个窗口更复杂的操作，则很可能您已经有了处理 macOS 上此行为差异的自定义逻辑。如果是这样，在 Electron 30 中将不再需要该逻辑，因为 autoresizing 行为是一致的。

已弃用: `BrowserView`

BrowserView 类已弃用，并由新的WebContentsView 类取代。

BrowserWindow 中与 BrowserView 相关的方法也已弃用

BrowserWindow.fromBrowserView(browserView)
win.setBrowserView(browserView)
win.getBrowserView()
win.addBrowserView(browserView)
win.removeBrowserView(browserView)
win.setTopBrowserView(browserView)
win.getBrowserViews()

已移除: `WebContents` 上 `context-menu` 事件中的 `params.inputFormType` 属性

WebContents 的 context-menu 事件中 params 对象的 inputFormType 属性已移除。请改用新的 formControlType 属性。

已移除: `process.getIOCounters()`

Chromium 已移除对该信息的访问权限。

计划的重大 API 变更 (29.0)

行为变更: `ipcRenderer` 不能再通过 `contextBridge` 发送

现在，尝试通过 contextBridge 将整个 ipcRenderer 模块作为对象发送，将在桥的接收端得到一个空对象。此更改是为了移除/缓解安全风险。您不应直接通过桥暴露 ipcRenderer 或其方法。相反，应提供一个安全的包装器，如下所示

contextBridge.exposeInMainWorld('app', {
  onEvent: (cb) => ipcRenderer.on('foo', (e, ...args) => cb(args))
})

已移除: `app` 上 `renderer-process-crashed` 事件

app 上的 renderer-process-crashed 事件已移除。请改用新的 render-process-gone 事件。

// Removed
app.on('renderer-process-crashed', (event, webContents, killed) => { /* ... */ })

// Replace with
app.on('render-process-gone', (event, webContents, details) => { /* ... */ })

已移除: `WebContents` 和 `<webview>` 上的 `crashed` 事件

WebContents 和 <webview> 上的 crashed 事件已移除。请改用新的 render-process-gone 事件。

// Removed
win.webContents.on('crashed', (event, killed) => { /* ... */ })
webview.addEventListener('crashed', (event) => { /* ... */ })

// Replace with
win.webContents.on('render-process-gone', (event, details) => { /* ... */ })
webview.addEventListener('render-process-gone', (event) => { /* ... */ })

已移除: `app` 上 `gpu-process-crashed` 事件

app 上的 gpu-process-crashed 事件已移除。请改用新的 child-process-gone 事件。

// Removed
app.on('gpu-process-crashed', (event, killed) => { /* ... */ })

// Replace with
app.on('child-process-gone', (event, details) => { /* ... */ })

计划的重大 API 变更 (28.0)

行为变更: `WebContents.backgroundThrottling` 设置为 false 会影响宿主 `BrowserWindow` 中的所有 `WebContents`

将 WebContents.backgroundThrottling 设置为 false 将禁用 BrowserWindow 中所有由其显示的 WebContents 的帧限速。

已移除: `BrowserWindow.setTrafficLightPosition(position)`

BrowserWindow.setTrafficLightPosition(position) 已移除，应改用 BrowserWindow.setWindowButtonPosition(position) API，该 API 接受 null 而不是 { x: 0, y: 0 } 来将位置重置为系统默认值。

// Removed in Electron 28
win.setTrafficLightPosition({ x: 10, y: 10 })
win.setTrafficLightPosition({ x: 0, y: 0 })

// Replace with
win.setWindowButtonPosition({ x: 10, y: 10 })
win.setWindowButtonPosition(null)

已移除: `BrowserWindow.getTrafficLightPosition()`

BrowserWindow.getTrafficLightPosition() 已移除，应改用 BrowserWindow.getWindowButtonPosition() API，该 API 在没有自定义位置时返回 null 而不是 { x: 0, y: 0 }。

// Removed in Electron 28
const pos = win.getTrafficLightPosition()
if (pos.x === 0 && pos.y === 0) {
  // No custom position.
}

// Replace with
const ret = win.getWindowButtonPosition()
if (ret === null) {
  // No custom position.
}

已移除: `ipcRenderer.sendTo()`

ipcRenderer.sendTo() API 已移除。应通过在渲染器之间设置一个 MessageChannel 来替代。

IpcRendererEvent 的 senderId 和 senderIsMainFrame 属性也已被移除。

已移除: `app.runningUnderRosettaTranslation`

app.runningUnderRosettaTranslation 属性已被移除。请改用 app.runningUnderARM64Translation。

// Removed
console.log(app.runningUnderRosettaTranslation)
// Replace with
console.log(app.runningUnderARM64Translation)

已废弃: `app` 的 `renderer-process-crashed` 事件

app 的 renderer-process-crashed 事件已废弃。请改用新的 render-process-gone 事件。

// Deprecated
app.on('renderer-process-crashed', (event, webContents, killed) => { /* ... */ })

// Replace with
app.on('render-process-gone', (event, webContents, details) => { /* ... */ })

已废弃: `WebContents` 上 `context-menu` 的 `params.inputFormType` 属性

WebContents 中 context-menu 事件的 params 对象的 inputFormType 属性已废弃。请改用新的 formControlType 属性。

已废弃: `WebContents` 和 `<webview>` 的 `crashed` 事件

WebContents 和 <webview> 的 crashed 事件已废弃。请改用新的 render-process-gone 事件。

// Deprecated
win.webContents.on('crashed', (event, killed) => { /* ... */ })
webview.addEventListener('crashed', (event) => { /* ... */ })

// Replace with
win.webContents.on('render-process-gone', (event, details) => { /* ... */ })
webview.addEventListener('render-process-gone', (event) => { /* ... */ })

已废弃: `app` 的 `gpu-process-crashed` 事件

app 的 gpu-process-crashed 事件已废弃。请改用新的 child-process-gone 事件。

// Deprecated
app.on('gpu-process-crashed', (event, killed) => { /* ... */ })

// Replace with
app.on('child-process-gone', (event, details) => { /* ... */ })

计划中的重大 API 变更 (27.0)

已移除: macOS 10.13 / 10.14 支持

macOS 10.13 (High Sierra) 和 macOS 10.14 (Mojave) 不再受 Chromium 支持。

旧版本的 Electron 将继续在这些操作系统上运行，但运行 Electron v27.0.0 及更高版本需要 macOS 10.15 (Catalina) 或更高版本。

已废弃: `ipcRenderer.sendTo()`

ipcRenderer.sendTo() API 已废弃。应通过在渲染器之间设置 MessageChannel 来替代。

IpcRendererEvent 的 senderId 和 senderIsMainFrame 属性也已被废弃。

已移除: `systemPreferences` 中的配色方案事件

以下 systemPreferences 事件已被移除

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

请改用 nativeTheme 模块上的新 updated 事件。

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

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

已移除: macOS 上 `window.setVibrancy` 的部分选项

以下活力选项已被移除

'light'
'medium-light'
'dark'
'ultra-dark'
'appearance-based'

这些选项之前已被废弃，并由 Apple 在 10.15 版本中移除。

已移除: `webContents.getPrinters`

webContents.getPrinters 方法已被移除。请改用 webContents.getPrintersAsync。

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

// Removed
console.log(w.webContents.getPrinters())
// Replace with
w.webContents.getPrintersAsync().then((printers) => {
  console.log(printers)
})

已移除: `systemPreferences.{get,set}AppLevelAppearance` 和 `systemPreferences.appLevelAppearance`

systemPreferences.getAppLevelAppearance 和 systemPreferences.setAppLevelAppearance 方法以及 systemPreferences.appLevelAppearance 属性已被移除。请改用 nativeTheme 模块。

// Removed
systemPreferences.getAppLevelAppearance()
// Replace with
nativeTheme.shouldUseDarkColors

// Removed
systemPreferences.appLevelAppearance
// Replace with
nativeTheme.shouldUseDarkColors

// Removed
systemPreferences.setAppLevelAppearance('dark')
// Replace with
nativeTheme.themeSource = 'dark'

已移除: `systemPreferences.getColor` 的 `alternate-selected-control-text` 值

systemPreferences.getColor 的 alternate-selected-control-text 值已被移除。请改用 selected-content-background。

// Removed
systemPreferences.getColor('alternate-selected-control-text')
// Replace with
systemPreferences.getColor('selected-content-background')

计划中的重大 API 变更 (26.0)

已废弃: `webContents.getPrinters`

webContents.getPrinters 方法已废弃。请改用 webContents.getPrintersAsync。

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

// Deprecated
console.log(w.webContents.getPrinters())
// Replace with
w.webContents.getPrintersAsync().then((printers) => {
  console.log(printers)
})

已废弃: `systemPreferences.{get,set}AppLevelAppearance` 和 `systemPreferences.appLevelAppearance`

systemPreferences.getAppLevelAppearance 和 systemPreferences.setAppLevelAppearance 方法以及 systemPreferences.appLevelAppearance 属性已废弃。请改用 nativeTheme 模块。

// Deprecated
systemPreferences.getAppLevelAppearance()
// Replace with
nativeTheme.shouldUseDarkColors

// Deprecated
systemPreferences.appLevelAppearance
// Replace with
nativeTheme.shouldUseDarkColors

// Deprecated
systemPreferences.setAppLevelAppearance('dark')
// Replace with
nativeTheme.themeSource = 'dark'

已废弃: `systemPreferences.getColor` 的 `alternate-selected-control-text` 值

systemPreferences.getColor 的 alternate-selected-control-text 值已废弃。请改用 selected-content-background。

// Deprecated
systemPreferences.getColor('alternate-selected-control-text')
// Replace with
systemPreferences.getColor('selected-content-background')

计划中的重大 API 变更 (25.0)

已废弃: `protocol.{un,}{register,intercept}{Buffer,String,Stream,File,Http}Protocol` 和 `protocol.isProtocol{Registered,Intercepted}`

protocol.register*Protocol 和 protocol.intercept*Protocol 方法已被 protocol.handle 取代。

新方法可以注册新协议或拦截现有协议，并且响应可以是任何类型。

// Deprecated in Electron 25
protocol.registerBufferProtocol('some-protocol', () => {
  callback({ mimeType: 'text/html', data: Buffer.from('<h5>Response</h5>') })
})

// Replace with
protocol.handle('some-protocol', () => {
  return new Response(
    Buffer.from('<h5>Response</h5>'), // Could also be a string or ReadableStream.
    { headers: { 'content-type': 'text/html' } }
  )
})

// Deprecated in Electron 25
protocol.registerHttpProtocol('some-protocol', () => {
  callback({ url: 'https://electron.js.cn' })
})

// Replace with
protocol.handle('some-protocol', () => {
  return net.fetch('https://electron.js.cn')
})

// Deprecated in Electron 25
protocol.registerFileProtocol('some-protocol', () => {
  callback({ filePath: '/path/to/my/file' })
})

// Replace with
protocol.handle('some-protocol', () => {
  return net.fetch('file:///path/to/my/file')
})

已废弃: `BrowserWindow.setTrafficLightPosition(position)`

BrowserWindow.setTrafficLightPosition(position) 已废弃，应改用 BrowserWindow.setWindowButtonPosition(position) API，该 API 接受 null 而不是 { x: 0, y: 0 } 来将位置重置为系统默认值。

// Deprecated in Electron 25
win.setTrafficLightPosition({ x: 10, y: 10 })
win.setTrafficLightPosition({ x: 0, y: 0 })

// Replace with
win.setWindowButtonPosition({ x: 10, y: 10 })
win.setWindowButtonPosition(null)

已废弃: `BrowserWindow.getTrafficLightPosition()`

BrowserWindow.getTrafficLightPosition() 已废弃，应改用 BrowserWindow.getWindowButtonPosition() API，该 API 在没有自定义位置时返回 null 而不是 { x: 0, y: 0 }。

// Deprecated in Electron 25
const pos = win.getTrafficLightPosition()
if (pos.x === 0 && pos.y === 0) {
  // No custom position.
}

// Replace with
const ret = win.getWindowButtonPosition()
if (ret === null) {
  // No custom position.
}

计划中的重大 API 变更 (24.0)

API 已变更: `nativeImage.createThumbnailFromPath(path, size)`

maxSize 参数已更改为 size，以反映传入的尺寸将是创建的缩略图的尺寸。以前，如果图像小于 maxSize，Windows 不会放大图像，而 macOS 会总是将尺寸设置为 maxSize。现在跨平台行为一致。

更新的行为

// a 128x128 image.
const imagePath = path.join('path', 'to', 'capybara.png')

// Scaling up a smaller image.
const upSize = { width: 256, height: 256 }
nativeImage.createThumbnailFromPath(imagePath, upSize).then(result => {
  console.log(result.getSize()) // { width: 256, height: 256 }
})

// Scaling down a larger image.
const downSize = { width: 64, height: 64 }
nativeImage.createThumbnailFromPath(imagePath, downSize).then(result => {
  console.log(result.getSize()) // { width: 64, height: 64 }
})

以前的行为 (在 Windows 上)

// a 128x128 image
const imagePath = path.join('path', 'to', 'capybara.png')
const size = { width: 256, height: 256 }
nativeImage.createThumbnailFromPath(imagePath, size).then(result => {
  console.log(result.getSize()) // { width: 128, height: 128 }
})

计划中的重大 API 变更 (23.0)

行为已变更: macOS 上的可拖拽区域

macOS 上可拖拽区域 (使用 CSS 属性 -webkit-app-region: drag) 的实现已更改，以与 Windows 和 Linux 保持一致。以前，当一个带有 -webkit-app-region: no-drag 的区域与一个带有 -webkit-app-region: drag 的区域重叠时，无论 CSS 层级如何，no-drag 区域在 macOS 上总是优先。也就是说，如果一个 drag 区域在一个 no-drag 区域上面，它会被忽略。从 Electron 23 开始，一个位于 no-drag 区域上面的 drag 区域将正确地使该区域可拖拽。

此外，customButtonsOnHover BrowserWindow 属性以前会创建一个忽略 -webkit-app-region CSS 属性的可拖拽区域。这现在已被修复 (参见 #37210 的讨论)。

因此，如果您的应用在 macOS 上使用无框窗口和可拖拽区域，您的应用中可拖拽的区域可能会在 Electron 23 中发生变化。

已移除: Windows 7 / 8 / 8.1 支持

Windows 7、Windows 8 和 Windows 8.1 不再受支持。 Electron 遵循 Chromium 的计划废弃策略，该策略将从 Chromium 109 开始废弃 Windows 7 支持。

旧版本的 Electron 将继续在这些操作系统上运行，但运行 Electron v23.0.0 及更高版本需要 Windows 10 或更高版本。

已移除: BrowserWindow `scroll-touch-*` 事件

BrowserWindow 上已废弃的 scroll-touch-begin、scroll-touch-end 和 scroll-touch-edge 事件已被移除。请改用 WebContents 上新提供的 input-event 事件。

// Removed in Electron 23.0
win.on('scroll-touch-begin', scrollTouchBegin)
win.on('scroll-touch-edge', scrollTouchEdge)
win.on('scroll-touch-end', scrollTouchEnd)

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

已移除: `webContents.incrementCapturerCount(stayHidden, stayAwake)`

webContents.incrementCapturerCount(stayHidden, stayAwake) 函数已被移除。现在由 webContents.capturePage 在页面捕获完成时自动处理。

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

// Removed in Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image.toDataURL())
  w.webContents.decrementCapturerCount()
})

// Replace with
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

已移除: `webContents.decrementCapturerCount(stayHidden, stayAwake)`

webContents.decrementCapturerCount(stayHidden, stayAwake) 函数已被移除。现在由 webContents.capturePage 在页面捕获完成时自动处理。

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

// Removed in Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image.toDataURL())
  w.webContents.decrementCapturerCount()
})

// Replace with
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

计划中的重大 API 变更 (22.0)

已废弃: `webContents.incrementCapturerCount(stayHidden, stayAwake)`

webContents.incrementCapturerCount(stayHidden, stayAwake) 已废弃。现在由 webContents.capturePage 在页面捕获完成时自动处理。

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

// Removed in Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image.toDataURL())
  w.webContents.decrementCapturerCount()
})

// Replace with
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

已废弃: `webContents.decrementCapturerCount(stayHidden, stayAwake)`

webContents.decrementCapturerCount(stayHidden, stayAwake) 已废弃。现在由 webContents.capturePage 在页面捕获完成时自动处理。

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

// Removed in Electron 23
w.webContents.incrementCapturerCount()
w.capturePage().then(image => {
  console.log(image.toDataURL())
  w.webContents.decrementCapturerCount()
})

// Replace with
w.capturePage().then(image => {
  console.log(image.toDataURL())
})

已移除: WebContents `new-window` 事件

WebContents 的 new-window 事件已被移除。它由 webContents.setWindowOpenHandler() 取代。

// Removed in Electron 22
webContents.on('new-window', (event) => {
  event.preventDefault()
})

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

已移除: `<webview>` `new-window` 事件

<webview> 的 new-window 事件已被移除。没有直接替代。

// Removed in Electron 22
webview.addEventListener('new-window', (event) => {})

// Replace with

// main.js
mainWindow.webContents.on('did-attach-webview', (event, wc) => {
  wc.setWindowOpenHandler((details) => {
    mainWindow.webContents.send('webview-new-window', wc.id, details)
    return { action: 'deny' }
  })
})

// preload.js
const { ipcRenderer } = require('electron')
ipcRenderer.on('webview-new-window', (e, webContentsId, details) => {
  console.log('webview-new-window', webContentsId, details)
  document.getElementById('webview').dispatchEvent(new Event('new-window'))
})

// renderer.js
document.getElementById('webview').addEventListener('new-window', () => {
  console.log('got new-window event')
})

已废弃: BrowserWindow `scroll-touch-*` 事件

BrowserWindow 上的 scroll-touch-begin、scroll-touch-end 和 scroll-touch-edge 事件已废弃。请改用 WebContents 上新提供的 input-event 事件。

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

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

计划中的重大 API 变更 (21.0)

行为已变更: 已启用 V8 Memory Cage

V8 Memory Cage 已启用，这对使用 ArrayBuffer 或 Buffer 封装非 V8 内存的本地模块有影响。更多详情请参阅关于 V8 Memory Cage 的博客文章。

API 已变更: `webContents.printToPDF()`

webContents.printToPDF() 已修改，以符合 Chrome DevTools Protocol 中 Page.printToPDF。这一改变是为了应对上游的变化，这些变化使得我们之前的实现难以维护且存在大量错误。

参数已变更

pageRanges

参数已移除

printSelectionOnly
marginsType
headerFooter
scaleFactor

参数已添加

headerTemplate
footerTemplate
displayHeaderFooter
margins
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)
})

计划中的重大 API 变更 (20.0)

已移除: macOS 10.11 / 10.12 支持

Chromium 不再支持 macOS 10.11 (El Capitan) 和 macOS 10.12 (Sierra)。

旧版本的 Electron 将继续在这些操作系统上运行，但运行 Electron v20.0.0 及更高版本需要 macOS 10.13 (High Sierra) 或更高版本。

默认已更改: 未设置 `nodeIntegration: true` 的渲染器默认沙盒化

以前，指定了预加载脚本的渲染器默认不沙盒化。这意味着默认情况下，预加载脚本可以访问 Node.js。在 Electron 20 中，此默认设置已更改。从 Electron 20 开始，除非指定了 nodeIntegration: true 或 sandbox: false，否则渲染器默认将被沙盒化。

如果您的预加载脚本不依赖于 Node，则无需采取任何措施。如果您的预加载脚本依赖于 Node，请重构它们以从渲染器中移除 Node 的使用，或者为相关的渲染器明确指定 sandbox: false。

已移除: Linux 上的 `skipTaskbar`

在 X11 上，skipTaskbar 会向 X11 窗口管理器发送 _NET_WM_STATE_SKIP_TASKBAR 消息。 Wayland 没有直接等效的功能，已知的变通方法具有不可接受的折衷（例如，GNOME 中的 Window.is_skip_taskbar 需要非安全模式），因此 Electron 无法在 Linux 上支持此功能。

API 已变更: `session.setDevicePermissionHandler(handler)`

使用 session.setDevicePermissionHandler(handler) 时调用的处理程序的参数已更改。此处理程序不再传递帧 WebFrameMain，而是传递 origin，即正在检查设备权限的源。

计划中的重大 API 变更 (19.0)

已移除: IA32 Linux 二进制文件

这是 Chromium 102.0.4999.0 放弃对 IA32 Linux 支持的结果。这完成了对 IA32 Linux 支持的移除。

计划中的重大 API 变更 (18.0)

已移除: `nativeWindowOpen`

在 Electron 15 之前，window.open 默认垫片使用 BrowserWindowProxy。这意味着 window.open('about:blank') 无法打开可同步脚本化的子窗口，以及其他不兼容问题。从 Electron 15 开始，nativeWindowOpen 已默认启用。

有关更多详细信息，请参阅 Electron 中的 window.open 文档。

计划中的重大 API 变更 (17.0)

已移除: 渲染器中的 `desktopCapturer.getSources`

desktopCapturer.getSources API 现在仅在主进程中可用。更改此项是为了提高 Electron 应用的默认安全性。

如果需要此功能，可以按如下方式替换

// Main process
const { ipcMain, desktopCapturer } = require('electron')

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

// Renderer process
const { ipcRenderer } = require('electron')

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

但是，您应考虑进一步限制返回给渲染器的信息；例如，向用户显示源选择器并仅返回选定的源。

已废弃: `nativeWindowOpen`

有关更多详细信息，请参阅 Electron 中的 window.open 文档。

计划中的重大 API 变更 (16.0)

行为已变更: Linux 上的 `crashReporter` 实现已切换到 Crashpad

Linux 上 crashReporter API 的底层实现已从 Breakpad 切换到 Crashpad，使其与 Windows 和 Mac 保持一致。因此，子进程现在被自动监控，不再需要在 Node 子进程中调用 process.crashReporter.start（并且不建议这样做，因为它会启动 Crashpad 报告器的第二个实例）。

注释在 Linux 上的报告方式也有一些细微的变化，包括长值将不再在附加了 __1、__2 等的注释之间分割，而是将在（新的、更长的）注释值限制处被截断。

已废弃: 渲染器中的 `desktopCapturer.getSources`

在渲染器中使用 desktopCapturer.getSources API 已废弃并将被移除。此更改提高了 Electron 应用的默认安全性。

有关如何在应用中替换此 API 的详细信息，请参阅此处。

计划中的重大 API 变更 (15.0)

默认已更改: `nativeWindowOpen` 默认为 `true`

在 Electron 15 之前，window.open 默认垫片使用 BrowserWindowProxy。这意味着 window.open('about:blank') 无法打开可同步脚本化的子窗口，以及其他不兼容问题。 nativeWindowOpen 不再是实验性的，现在是默认设置。

有关更多详细信息，请参阅 Electron 中的 window.open 文档。

已废弃: `app.runningUnderRosettaTranslation`

app.runningUnderRosettaTranslation 属性已废弃。请改用 app.runningUnderARM64Translation。

// Deprecated
console.log(app.runningUnderRosettaTranslation)
// Replace with
console.log(app.runningUnderARM64Translation)

计划中的重大 API 变更 (14.0)

已移除: `remote` 模块

remote 模块在 Electron 12 中已废弃，并将在 Electron 14 中移除。它由 @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()

已移除: `app.allowRendererProcessReuse`

app.allowRendererProcessReuse 属性将被移除，这是我们计划更紧密地与 Chromium 的进程模型对齐，以提高安全性、性能和可维护性的一部分。

更多详细信息请参阅 #18397。

已移除: 浏览器窗口关联性 (Browser Window Affinity)

构建新的 BrowserWindow 时的 affinity 选项将被移除，这是我们计划更紧密地与 Chromium 的进程模型对齐，以提高安全性、性能和可维护性的一部分。

更多详细信息请参阅 #18397。

API 已变更: `window.open()`

可选参数 frameName 将不再设置窗口的标题。现在遵循原生文档中相应参数 windowName 描述的规范。

如果使用此参数来设置窗口标题，可以改用 win.setTitle(title)。

已移除: `worldSafeExecuteJavaScript`

在 Electron 14 中，worldSafeExecuteJavaScript 将被移除。没有替代方法，请确保您的代码在此属性启用时能够正常工作。自 Electron 12 以来，它已默认启用。

如果您使用 webFrame.executeJavaScript 或 webFrame.executeJavaScriptInIsolatedWorld，此更改将影响您。您需要确保这些方法返回的值受上下文桥接 API 支持，因为这些方法使用相同的值传递语义。

已移除: BrowserWindowConstructorOptions 从父窗口继承

在 Electron 14 之前，使用 window.open 打开的窗口会从其父窗口继承 BrowserWindow 构造函数选项，例如 transparent 和 resizable。从 Electron 14 开始，此行为被移除，窗口将不再从其父窗口继承任何 BrowserWindow 构造函数选项。

请改用 setWindowOpenHandler 为新窗口显式设置选项

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

已移除: `additionalFeatures`

WebContents 的 new-window 和 did-create-window 事件中已废弃的 additionalFeatures 属性已被移除。由于 new-window 使用位置参数，该参数仍然存在，但将始终是空数组 []。（但请注意，new-window 事件本身已废弃，并由 setWindowOpenHandler 取代）。窗口功能中的裸键现在将作为值为 true 的键出现在 options 对象中。

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

计划中的重大 API 变更 (13.0)

API 已变更: `session.setPermissionCheckHandler(handler)`

handler 方法的第一个参数以前总是 webContents，现在有时可能是 null。您应该使用 requestingOrigin、embeddingOrigin 和 securityOrigin 属性来正确响应权限检查。由于 webContents 可以为 null，因此不能再依赖它。

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

已移除: `shell.moveItemToTrash()`

已废弃的同步 shell.moveItemToTrash() API 已被移除。请改用异步 shell.trashItem()。

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

已移除: `BrowserWindow` 扩展 API

已废弃的扩展 API 已被移除

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

请改用 session API

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()

已移除: `systemPreferences` 中的方法

以下 systemPreferences 方法已废弃

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

请改用以下 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

已废弃：WebContents `new-window` 事件

WebContents 的 new-window 事件已废弃。它被 webContents.setWindowOpenHandler() 取代。

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

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

计划中的重大 API 更改 (12.0)

已移除：对 Pepper Flash 的支持

Chromium 已移除对 Flash 的支持，我们也必须这样做。详情请参阅 Chromium 的 Flash 路线图。

默认更改：`worldSafeExecuteJavaScript` 默认为 `true`

在 Electron 12 中，worldSafeExecuteJavaScript 将默认启用。要恢复以前的行为，必须在 WebPreferences 中指定 worldSafeExecuteJavaScript: false。请注意，将此选项设置为 false 是不安全的。

此选项将在 Electron 14 中移除，请迁移您的代码以支持默认值。

默认更改：`contextIsolation` 默认为 `true`

在 Electron 12 中，contextIsolation 将默认启用。要恢复以前的行为，必须在 WebPreferences 中指定 contextIsolation: false。

我们建议启用 contextIsolation 以保障应用程序的安全。

另一个影响是，除非 nodeIntegration 为 true 且 contextIsolation 为 false，否则不能在渲染进程中使用 require()。

详情请参阅：https://github.com/electron/electron/issues/23506

已移除：`crashReporter.getCrashesDirectory()`

crashReporter.getCrashesDirectory 方法已移除。应用应改为使用 app.getPath('crashDumps')。

// Removed in Electron 12
crashReporter.getCrashesDirectory()
// Replace with
app.getPath('crashDumps')

已移除：渲染进程中的 `crashReporter` 方法

以下 crashReporter 方法不再在渲染进程中可用

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

它们应仅在主进程中调用。

详情请参阅：#23265。

默认更改：`crashReporter.start({ compress: true })`

crashReporter.start 中 compress 选项的默认值已从 false 更改为 true。这意味着崩溃转储将通过 Content-Encoding: gzip 头上传到崩溃接收服务器，并且主体将被压缩。

如果您的崩溃接收服务器不支持压缩负载，您可以在崩溃报告器选项中指定 `{ compress: false }` 来关闭压缩。

已废弃：`remote` 模块

在 Electron 12 中，remote 模块已废弃，并将在 Electron 14 中移除。它被 @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()

已废弃：`shell.moveItemToTrash()`

同步的 shell.moveItemToTrash() 已被新的异步 shell.trashItem() 取代。

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

计划中的重大 API 更改 (11.0)

已移除：`BrowserView.{destroy, fromId, fromWebContents, getAllViews}` 和 `BrowserView` 的 `id` 属性

实验性 API BrowserView.{destroy, fromId, fromWebContents, getAllViews} 现已移除。此外，BrowserView 的 id 属性也已移除。

详情请参阅：#23578。

计划中的重大 API 更改 (10.0)

已废弃：`crashReporter.start()` 的 `companyName` 参数

crashReporter.start() 的 companyName 参数以前是必需的，现在是可选的，并且已被废弃。要以非废弃的方式获得相同的行为，您可以在 globalExtra 中传递 companyName 值。

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

已废弃：`crashReporter.getCrashesDirectory()`

crashReporter.getCrashesDirectory 方法已废弃。应用应改为使用 app.getPath('crashDumps')。

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

已废弃：渲染进程中的 `crashReporter` 方法

在渲染进程中调用以下 crashReporter 方法已废弃

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

在渲染进程的 crashReporter 模块中，唯一未废弃的方法是 addExtraParameter、removeExtraParameter 和 getParameters。

从主进程调用时，上述所有方法均未废弃。

详情请参阅：#23265。

已废弃：`crashReporter.start({ compress: false })`

在 crashReporter.start 中设置 { compress: false } 已废弃。几乎所有崩溃接收服务器都支持 gzip 压缩。此选项将在 Electron 的未来版本中移除。

默认更改：`enableRemoteModule` 默认为 `false`

在 Electron 9 中，如果未通过 WebPreferences 选项 enableRemoteModule 显式启用，使用 remote 模块会开始发出警告。在 Electron 10 中，remote 模块现在默认禁用。要使用 remote 模块，必须在 WebPreferences 中指定 enableRemoteModule: true

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

我们建议不再使用 remote 模块。

`protocol.unregisterProtocol`

`protocol.uninterceptProtocol`

API 现在是同步的，不再需要可选的回调函数。

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

`protocol.registerFileProtocol`

`protocol.registerBufferProtocol`

`protocol.registerStringProtocol`

`protocol.registerHttpProtocol`

`protocol.registerStreamProtocol`

`protocol.interceptFileProtocol`

`protocol.interceptStringProtocol`

`protocol.interceptBufferProtocol`

`protocol.interceptHttpProtocol`

`protocol.interceptStreamProtocol`

API 现在是同步的，不再需要可选的回调函数。

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

注册或拦截的协议对当前页面无效，直到发生导航。

`protocol.isProtocolHandled`

此 API 已废弃，用户应改用 protocol.isProtocolRegistered 和 protocol.isProtocolIntercepted。

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

计划中的重大 API 更改 (9.0)

默认更改：默认禁用在渲染进程中加载非上下文感知原生模块

从 Electron 9 开始，我们不再允许在渲染进程中加载非上下文感知原生模块。这是为了提高 Electron 项目的安全性、性能和可维护性。

如果这影响到您，您可以暂时将 app.allowRendererProcessReuse 设置为 false 以恢复旧行为。此标志仅在 Electron 11 之前可用，因此您应该计划更新您的原生模块以使其具有上下文感知能力。

更多详细信息请参阅 #18397。

已废弃：`BrowserWindow` 扩展 API

以下扩展 API 已废弃

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

请改用 session API

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()

已移除：`<webview>.getWebContents()`

此 API 在 Electron 8.0 中已废弃，现在已移除。

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

已移除：`webFrame.setLayoutZoomLevelLimits()`

Chromium 已移除对更改布局缩放级别限制的支持，这超出了 Electron 的维护能力。此函数在 Electron 8.x 中已废弃，并在 Electron 9.x 中移除。布局缩放级别限制现已固定在最小 0.25 和最大 5.0，定义在此。

行为更改：通过 IPC 发送非 JS 对象现在会抛出异常

在 Electron 8.0 中，IPC 已更改为使用结构化克隆算法，带来了显著的性能改进。为帮助简化过渡，保留了旧的 IPC 序列化算法，并将其用于某些无法通过结构化克隆序列化的对象。特别是，DOM 对象 (例如 Element, Location 和 DOMMatrix) 、由 C++ 类支持的 Node.js 对象 (例如 process.env、Stream 的某些成员) 以及由 C++ 类支持的 Electron 对象 (例如 WebContents, BrowserWindow 和 WebFrame) 不能通过结构化克隆进行序列化。每次调用旧算法时，都会打印废弃警告。

在 Electron 9.0 中，旧的序列化算法已移除，发送此类不可序列化对象现在会抛出 "object could not be cloned" 错误。

API 更改：`shell.openItem` 现为 `shell.openPath`

shell.openItem API 已被异步的 shell.openPath API 取代。您可以在此处查看原始 API 提案和理由。

计划中的重大 API 更改 (8.0)

行为更改：通过 IPC 发送的值现在使用结构化克隆算法进行序列化

用于通过 IPC (通过 ipcRenderer.send、ipcRenderer.sendSync、WebContents.send 和相关方法) 发送对象的序列化算法已从自定义算法切换到 V8 内置的结构化克隆算法，该算法与 postMessage 用于序列化消息的算法相同。这使得处理大型消息的性能提升了 2 倍，但也带来了一些行为上的重大变化。

通过 IPC 发送 Functions, Promises, WeakMaps, WeakSets, 或包含任何此类值的对象现在将抛出异常，而不再静默地将函数转换为 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 和 -Infinity 现在将正确序列化，而不再转换为 null。
包含循环引用的对象现在将正确序列化，而不再转换为 null。
Set, Map, Error 和 RegExp 值将正确序列化，而不再转换为 {}。
BigInt 值将正确序列化，而不再转换为 null。
稀疏数组将按原样序列化，而不再转换为包含 null 的密集数组。
Date 对象将作为 Date 对象传输，而不再转换为其 ISO 字符串表示形式。
类型化数组 (例如 Uint8Array, Uint16Array, Uint32Array 等) 将按原样传输，而不再转换为 Node.js Buffer。
Node.js Buffer 对象将作为 Uint8Array 传输。您可以通过封装基础 ArrayBuffer 将 Uint8Array 转换回 Node.js Buffer。

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

发送任何非原生 JS 类型的对象，例如 DOM 对象 (例如 Element, Location, DOMMatrix)、Node.js 对象 (例如 process.env, Stream) 或 Electron 对象 (例如 WebContents, BrowserWindow, WebFrame) 已废弃。在 Electron 8 中，这些对象将像以前一样序列化并带有 DeprecationWarning 消息，但从 Electron 9 开始，发送这些类型的对象将抛出 'could not be cloned' 错误。

已废弃：`<webview>.getWebContents()`

此 API 使用 remote 模块实现，这具有性能和安全影响。因此其使用应显式声明。

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

然而，建议完全避免使用 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())

已废弃：`webFrame.setLayoutZoomLevelLimits()`

Chromium 已移除对更改布局缩放级别限制的支持，这超出了 Electron 的维护能力。此函数在 Electron 8.x 中将发出警告，并在 Electron 9.x 中不再存在。布局缩放级别限制现已固定在最小 0.25 和最大 5.0，定义在此。

已废弃：`systemPreferences` 中的事件

以下 systemPreferences 事件已废弃

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

请改用 nativeTheme 模块上的新 updated 事件。

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

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

已废弃：`systemPreferences` 中的方法

以下 systemPreferences 方法已废弃

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

请改用以下 nativeTheme 属性

nativeTheme.shouldUseDarkColors
nativeTheme.shouldUseInvertedColorScheme
nativeTheme.shouldUseHighContrastColors

// Deprecated
systemPreferences.isDarkMode()
// Replace with
nativeTheme.shouldUseDarkColors

// Deprecated
systemPreferences.isInvertedColorScheme()
// Replace with
nativeTheme.shouldUseInvertedColorScheme

// Deprecated
systemPreferences.isHighContrastColorScheme()
// Replace with
nativeTheme.shouldUseHighContrastColors

计划中的重大 API 更改 (7.0)

已废弃：Atom.io Node 头文件 URL

这是在 `.npmrc` 文件中指定为 `disturl` 或在构建原生 Node 模块时作为 `--dist-url` 命令行标志指定的 URL。这两种方式在可预见的将来都会得到支持，但建议您进行切换。

已废弃：https://atom.io/download/electron

替换为：https://electron.js.cn/headers

API 更改：`session.clearAuthCache()` 不再接受选项

session.clearAuthCache API 不再接受用于清除内容的选项，而是无条件清除整个缓存。

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

API 更改：`powerMonitor.querySystemIdleState` 现为 `powerMonitor.getSystemIdleState`

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

API 更改：`powerMonitor.querySystemIdleTime` 现为 `powerMonitor.getSystemIdleTime`

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

API 更改：`webFrame.setIsolatedWorldInfo` 取代单独方法

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

已移除：`getBlinkMemoryInfo` 中的 `marked` 属性

此属性已在 Chromium 77 中移除，因此不再可用。

行为更改：`<input type="file"/>` 的 `webkitdirectory` 属性现在列出目录内容

HTML 文件输入上的 webkitdirectory 属性允许它们选择文件夹。以前的 Electron 版本有一个不正确的实现，其中输入的 event.target.files 返回一个 FileList，该 FileList 返回一个与选定文件夹对应的 File。

从 Electron 7 开始，该 FileList 现在是文件夹中包含的所有文件的列表，类似于 Chrome、Firefox 和 Edge (链接到 MDN 文档)。

举例来说，假设有一个具有此结构的文件夹

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

在 Electron <=6 中，这将返回一个 FileList，其中包含一个 File 对象用于

path/to/folder

在 Electron 7 中，这现在返回一个 FileList，其中包含一个 File 对象用于

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

请注意，webkitdirectory 不再公开选定文件夹的路径。如果您需要选定文件夹的路径而不是文件夹内容，请参阅 dialog.showOpenDialog API (链接)。

API 更改：基于回调的 Promise 化 API 版本

Electron 5 和 Electron 6 引入了现有异步 API 的 Promise 版本，并废弃了其较旧的基于回调的对应版本。在 Electron 7 中，所有已废弃的基于回调的 API 现已移除。

这些函数现在只返回 Promise

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

这些函数现在有两种形式：同步和基于 Promise 的异步

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

计划中的重大 API 更改 (6.0)

API 更改：`win.setMenu(null)` 现为 `win.removeMenu()`

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

API 更改：渲染进程中的 `electron.screen` 应通过 `remote` 访问

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

API 更改：在沙盒化渲染进程中 `require()` Node 内置模块不再隐式加载 `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')

已废弃：`powerMonitor.querySystemIdleState` 由 `powerMonitor.getSystemIdleState` 取代

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

已废弃：`powerMonitor.querySystemIdleTime` 由 `powerMonitor.getSystemIdleTime` 取代

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

已弃用：不再需要 `app.enableMixedSandbox()`

// Deprecated
app.enableMixedSandbox()

混合沙箱模式现在默认启用。

已弃用：`Tray.setHighlightMode`

在 macOS Catalina 上，我们以前的 Tray 实现会中断。苹果的原生替代方案不支持更改高亮行为。

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

计划中的重大 API 变更 (5.0)

默认值已更改：`nodeIntegration` 和 `webviewTag` 默认为 false，`contextIsolation` 默认为 true

以下 webPreferences 选项的默认值已弃用，转而使用下面列出的新默认值。

属性	已弃用默认值	新默认值
`contextIsolation`	`false`	`true`
`nodeIntegration`	`true`	`false`
`webviewTag`	如果设置了 `nodeIntegration` 则使用其值，否则为 `true`	`false`

例如，重新启用 webviewTag

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

行为已更改：通过 `nativeWindowOpen` 打开的子窗口中的 `nodeIntegration`

使用 nativeWindowOpen 选项打开的子窗口将始终禁用 Node.js 集成，除非 nodeIntegrationInSubFrames 为 true。

API 已更改：现在必须在应用就绪之前注册特权方案

渲染进程 API webFrame.registerURLSchemeAsPrivileged 和 webFrame.registerURLSchemeAsBypassingCSP 以及浏览器进程 API protocol.registerStandardSchemes 已移除。添加了一个新 API protocol.registerSchemesAsPrivileged，应使用它来注册具有所需特权的自定义方案。自定义方案必须在应用就绪之前注册。

已弃用：`webFrame.setIsolatedWorld*` 已替换为 `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 已更改：`webFrame.setSpellCheckProvider` 现在接受异步回调

spellCheck 回调现在是异步的，并且 autoCorrectWord 参数已移除。

// 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 已更改：`webContents.getZoomLevel` 和 `webContents.getZoomFactor` 现在是同步的

webContents.getZoomLevel 和 webContents.getZoomFactor 不再接受回调参数，而是直接返回其数字值。

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

计划中的重大 API 变更 (4.0)

以下列表包含 Electron 4.0 中进行的重大 API 变更。

`app.makeSingleInstance`

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

`app.releaseSingleInstance`

// Deprecated
app.releaseSingleInstance()
// Replace with
app.releaseSingleInstanceLock()

`app.getGPUInfo`

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

`win_delay_load_hook`

构建 Windows 原生模块时，模块 binding.gyp 文件中的 win_delay_load_hook 变量必须为 true（这是默认值）。如果不存在此钩子，则原生模块将无法在 Windows 上加载，并显示类似 Cannot find module 的错误消息。有关更多信息，请参阅原生模块指南。

已移除：IA32 Linux 支持

Electron 18 将不再支持 32 位 Linux 系统。有关更多信息，请参阅停止支持 32 位 Linux。

重大 API 变更 (3.0)

以下列表包含 Electron 3.0 中的重大 API 变更。

`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`

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

`crashReporter`

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

`nativeImage`

// Deprecated
nativeImage.createFromBuffer(buffer, 1.0)
// Replace with
nativeImage.createFromBuffer(buffer, {
  scaleFactor: 1.0
})

`process`

// Deprecated
const info = process.getProcessMemoryInfo()

`screen`

// Deprecated
screen.getMenuBarHeight()
// Replace with
screen.getPrimaryDisplay().workArea

`session`

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

`Tray`

// Deprecated
tray.setHighlightMode(true)
// Replace with
tray.setHighlightMode('on')

// Deprecated
tray.setHighlightMode(false)
// Replace with
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>`

// Removed
webview.setAttribute('disableguestresize', '')
// There is no replacement for this API

// Removed
webview.setAttribute('guestinstance', instanceId)
// There is no replacement for this API

// Keyboard listeners no longer work on webview tag
webview.onkeydown = () => { /* handler */ }
webview.onkeyup = () => { /* handler */ }

Node Headers URL

这是在 `.npmrc` 文件中指定为 `disturl` 的 URL，或在构建原生 Node 模块时作为 `--dist-url` 命令行标志指定的 URL。

已弃用：https://atom.io/download/atom-shell

替换为：https://atom.io/download/electron

重大 API 变更 (2.0)

以下列表包含 Electron 2.0 中进行的重大 API 变更。

`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`

// Removed
nativeImage.toPng()
// Replaced with
nativeImage.toPNG()

// Removed
nativeImage.toJpeg()
// Replaced with
nativeImage.toJPEG()

`process`

为了与 Node 设置的其他 process.versions 属性保持一致，process.versions.electron 和 process.version.chrome 将被设为只读属性。

`webContents`

// Removed
webContents.setZoomLevelLimits(1, 2)
// Replaced with
webContents.setVisualZoomLevelLimits(1, 2)

`webFrame`

// Removed
webFrame.setZoomLevelLimits(1, 2)
// Replaced with
webFrame.setVisualZoomLevelLimits(1, 2)

`<webview>`

// Removed
webview.setZoomLevelLimits(1, 2)
// Replaced with
webview.setVisualZoomLevelLimits(1, 2)

重复的 ARM 资产

每个 Electron 版本都包含两个完全相同的 ARM 构建，文件名略有不同，例如 electron-v1.7.3-linux-arm.zip 和 electron-v1.7.3-linux-armv7l.zip。添加带有 v7l 前缀的资产是为了向用户澄清它支持的 ARM 版本，并将其与未来可能生成的 armv6l 和 arm64 资产区分开来。

为了避免破坏可能正在使用它的任何设置，不带前缀的文件仍然在发布。从 2.0 开始，不带前缀的文件将不再发布。

有关详细信息，请参阅 6986 和 7189。

重大变更类型
计划中的重大 API 变更 (37.0)
- 行为已更改：Linux 上 BrowserWindow.IsVisibleOnAllWorkspaces() 的行为
- 行为变更：app.commandLine
- 已弃用：NativeImage.getBitmap()
计划中的重大 API 变更 (36.0)
- 已移除：PrinterInfo 上的 isDefault 和 status 属性
- 已移除：Session.clearStorageData(options) 中的 syncable 配额类型
- 已弃用：Session.clearStorageData(options) 中的 quota 属性
- 已弃用：ProtocolResponse 中 session 属性的 null 值
- 已弃用：session 上的扩展方法和事件
- 已移除：systemPreferences.isAeroGlassEnabled()
- 已更改：在运行 GNOME 时，GTK 4 是默认设置
计划中的重大 API 变更 (35.0)
- 行为已更改：Linux 上 Dialog API 的 defaultPath 选项
- 已弃用：session.serviceWorkers 上的 getFromVersionID
- 已弃用：Session 上的 setPreloads、getPreloads
- 已弃用：WebContents 上 console-message 事件中的 level、message、line 和 sourceId 参数
- 行为已更改：WebRequestFilter 的 urls 属性。
- 已弃用：systemPreferences.isAeroGlassEnabled()
计划中的重大 API 变更 (34.0)
- 行为已更改：在 Windows 上全屏时将隐藏菜单栏
计划中的重大 API 变更 (33.0)
- 已弃用：document.execCommand("paste")
- 行为已更改：帧属性可能会检索到分离的 WebFrameMain 实例或根本没有实例
- 行为已更改：Windows 上的自定义协议 URL 处理
- 行为已更改：app 上 login 事件中的 webContents 属性
- 已弃用：BrowserWindowConstructorOption.type 中的 textured 选项
- 已移除：macOS 10.15 支持
- 行为已更改：原生模块现在需要 C++20
- 已弃用：systemPreferences.accessibilityDisplayShouldReduceTransparency
计划中的重大 API 变更 (32.0)
- 已移除：File.path
- 已弃用：WebContents 上的 clearHistory、canGoBack、goBack、canGoForward、goForward、goToIndex、canGoToOffset、goToOffset
- 行为已更改：userData 中的 databases 目录将被删除
计划中的重大 API 变更 (31.0)
- 已移除：WebSQL 支持
- 行为已更改：nativeImage.toDataURL 将保留 PNG 色彩空间
- 行为已更改：window.flashFrame(bool) 在 macOS 上将持续闪烁 Dock 图标
计划中的重大 API 变更 (30.0)
- 行为已更改：跨域 iframe 现在使用权限策略访问功能
- 已移除：--disable-color-correct-rendering 开关
- 行为已更改：BrowserView.setAutoResize 在 macOS 上的行为
- 已弃用：BrowserView
- 已移除：WebContents 上 context-menu 事件中的 params.inputFormType 属性
- 已移除：process.getIOCounters()
计划中的重大 API 变更 (29.0)
- 行为已更改：ipcRenderer 不再能通过 contextBridge 发送
- 已移除：app 上的 renderer-process-crashed 事件
- 已移除：WebContents 和 <webview> 上的 crashed 事件
- 已移除：app 上的 gpu-process-crashed 事件
计划中的重大 API 变更 (28.0)
- 行为已更改：将 WebContents.backgroundThrottling 设置为 false 会影响宿主 BrowserWindow 中的所有 WebContents
- 已移除：BrowserWindow.setTrafficLightPosition(position)
- 已移除：BrowserWindow.getTrafficLightPosition()
- 已移除：ipcRenderer.sendTo()
- 已移除：app.runningUnderRosettaTranslation
- 已弃用：app 上的 renderer-process-crashed 事件
- 已弃用：WebContents 上 context-menu 事件中的 params.inputFormType 属性
- 已弃用：WebContents 和 <webview> 上的 crashed 事件
- 已弃用：app 上的 gpu-process-crashed 事件
计划中的重大 API 变更 (27.0)
- 已移除：macOS 10.13 / 10.14 支持
- 已弃用：ipcRenderer.sendTo()
- 已移除：systemPreferences 中的颜色方案事件
- 已移除：macOS 上 window.setVibrancy 的某些选项
- 已移除：webContents.getPrinters
- 已移除：systemPreferences.{get,set}AppLevelAppearance 和 systemPreferences.appLevelAppearance
- 已移除：systemPreferences.getColor 的 alternate-selected-control-text 值
计划中的重大 API 变更 (26.0)
- 已弃用：webContents.getPrinters
- 已弃用：systemPreferences.{get,set}AppLevelAppearance 和 systemPreferences.appLevelAppearance
- 已弃用：systemPreferences.getColor 的 alternate-selected-control-text 值
计划中的重大 API 变更 (25.0)
- 已弃用：protocol.{un,}{register,intercept}{Buffer,String,Stream,File,Http}Protocol 和 protocol.isProtocol{Registered,Intercepted}
- 已弃用：BrowserWindow.setTrafficLightPosition(position)
- 已弃用：BrowserWindow.getTrafficLightPosition()
计划中的重大 API 变更 (24.0)
- API 已更改：nativeImage.createThumbnailFromPath(path, size)
计划中的重大 API 变更 (23.0)
- 行为已更改：macOS 上的可拖拽区域
- 已移除：Windows 7 / 8 / 8.1 支持
- 已移除：BrowserWindow scroll-touch-* 事件
- 已移除：webContents.incrementCapturerCount(stayHidden, stayAwake)
- 已移除：webContents.decrementCapturerCount(stayHidden, stayAwake)
计划中的重大 API 变更 (22.0)
- 已弃用：webContents.incrementCapturerCount(stayHidden, stayAwake)
- 已弃用：webContents.decrementCapturerCount(stayHidden, stayAwake)
- 已移除：WebContents new-window 事件
- 已移除：<webview> new-window 事件
- 已弃用：BrowserWindow scroll-touch-* 事件
计划中的重大 API 变更 (21.0)
- 行为已更改：V8 Memory Cage 已启用
- API 已更改：webContents.printToPDF()
计划中的重大 API 变更 (20.0)
- 已移除：macOS 10.11 / 10.12 支持
- 默认值已更改：未设置 nodeIntegration: true 的渲染器默认启用沙箱
- 已移除：Linux 上的 skipTaskbar
- API 已更改：session.setDevicePermissionHandler(handler)
计划中的重大 API 变更 (19.0)
- 已移除：IA32 Linux 二进制文件
计划中的重大 API 变更 (18.0)
- 已移除：nativeWindowOpen
计划中的重大 API 变更 (17.0)
- 已移除：渲染进程中的 desktopCapturer.getSources
- 已弃用：nativeWindowOpen
计划中的重大 API 变更 (16.0)
- 行为已更改：crashReporter 在 Linux 上的实现切换到 Crashpad
- 已弃用：渲染进程中的 desktopCapturer.getSources
计划中的重大 API 变更 (15.0)
- 默认值已更改：nativeWindowOpen 默认为 true
- 已弃用：app.runningUnderRosettaTranslation
计划中的重大 API 变更 (14.0)
- 已移除：remote 模块
- 已移除：app.allowRendererProcessReuse
- 已移除：浏览器窗口亲和性
- API 已更改：window.open()
- 已移除：worldSafeExecuteJavaScript
- 已移除：BrowserWindowConstructorOptions 继承自父窗口
- 已移除：additionalFeatures
计划中的重大 API 变更 (13.0)
- API 已更改：session.setPermissionCheckHandler(handler)
- 已移除：shell.moveItemToTrash()
- 已移除：BrowserWindow 扩展 API
- 已移除：systemPreferences 中的方法
- 已弃用：WebContents new-window 事件
计划中的重大 API 变更 (12.0)
- 已移除：Pepper Flash 支持
- 默认值已更改：worldSafeExecuteJavaScript 默认为 true
- 默认值已更改：contextIsolation 默认为 true
- 已移除：crashReporter.getCrashesDirectory()
- 已移除：渲染进程中的 crashReporter 方法
- 默认值已更改：crashReporter.start({ compress: true })
- 已弃用：remote 模块
- 已弃用：shell.moveItemToTrash()
计划中的重大 API 变更 (11.0)
- 已移除：BrowserView.{destroy, fromId, fromWebContents, getAllViews} 和 BrowserView 的 id 属性
计划中的重大 API 变更 (10.0)
- 已弃用：crashReporter.start() 的 companyName 参数
- 已弃用：crashReporter.getCrashesDirectory()
- 已弃用：渲染进程中的 crashReporter 方法
- 已弃用：crashReporter.start({ compress: false })
- 默认值已更改：enableRemoteModule 默认为 false
- unregisterProtocol
- uninterceptProtocol
- registerFileProtocol
- registerBufferProtocol
- registerStringProtocol
- registerHttpProtocol
- registerStreamProtocol
- interceptFileProtocol
- interceptStringProtocol
- interceptBufferProtocol
- interceptHttpProtocol
- interceptStreamProtocol
- isProtocolHandled
计划中的重大 API 变更 (9.0)
- 默认值已更改：渲染进程中加载非上下文感知的原生模块默认禁用
- 已弃用：BrowserWindow 扩展 API
- 已移除：<webview>.getWebContents()
- 已移除：webFrame.setLayoutZoomLevelLimits()
- 行为已更改：现在通过 IPC 发送非 JS 对象会抛出异常
- API 已更改：shell.openItem 现在是 shell.openPath
计划中的重大 API 变更 (8.0)
- 行为已更改：现在通过 IPC 发送的值使用结构化克隆算法序列化
- 已弃用：<webview>.getWebContents()
- 已弃用：webFrame.setLayoutZoomLevelLimits()
- systemPreferences 中的已弃用事件
- 已弃用：systemPreferences 中的方法
计划中的重大 API 变更 (7.0)
- 已弃用：Atom.io Node Headers URL
- API 已更改：session.clearAuthCache() 不再接受选项
- API 已更改：powerMonitor.querySystemIdleState 现在是 powerMonitor.getSystemIdleState
- API 已更改：powerMonitor.querySystemIdleTime 现在是 powerMonitor.getSystemIdleTime
- API 已更改：webFrame.setIsolatedWorldInfo 替换了单独的方法
- 已移除：getBlinkMemoryInfo 上的 marked 属性
- 行为已更改：<input type="file"/> 的 webkitdirectory 属性现在列出目录内容
- API 已更改：Promisified API 的基于回调的版本
计划中的重大 API 变更 (6.0)
- API 已更改：win.setMenu(null) 现在是 win.removeMenu()
- API 已更改：渲染进程中的 electron.screen 应通过 remote 访问
- API 已更改：在沙箱渲染器中 require() Node 内置模块不再隐式加载 remote 版本
- 已弃用：powerMonitor.querySystemIdleState 已替换为 powerMonitor.getSystemIdleState
- 已弃用：powerMonitor.querySystemIdleTime 已替换为 powerMonitor.getSystemIdleTime
- 已弃用：不再需要 app.enableMixedSandbox()
- 已弃用：Tray.setHighlightMode
计划中的重大 API 变更 (5.0)
- 默认值已更改：nodeIntegration 和 webviewTag 默认为 false，contextIsolation 默认为 true
- 行为已更改：通过 nativeWindowOpen 打开的子窗口中的 nodeIntegration
- API 已更改：现在必须在应用就绪之前注册特权方案
- 已弃用：webFrame.setIsolatedWorld* 已替换为 webFrame.setIsolatedWorldInfo
- API 已更改：webFrame.setSpellCheckProvider 现在接受异步回调
- API 已更改：webContents.getZoomLevel 和 webContents.getZoomFactor 现在是同步的
计划中的重大 API 变更 (4.0)
- makeSingleInstance
- releaseSingleInstance
- getGPUInfo
- win_delay_load_hook
- 已移除：IA32 Linux 支持
重大 API 变更 (3.0)
- app
- BrowserWindow
- clipboard
- crashReporter
- nativeImage
- process
- screen
- session
- Tray
- webContents
- webFrame
- <webview>
- Node Headers URL
重大 API 变更 (2.0)
- BrowserWindow
- menu
- nativeImage
- process
- webContents
- webFrame
- <webview>
- 重复的 ARM 资产

重大变更的类型​

计划的重大 API 变更 (37.0)​

行为变更: Linux 上的 BrowserWindow.IsVisibleOnAllWorkspaces()​

行为变更: app.commandLine​

已弃用: NativeImage.getBitmap()​

计划的重大 API 变更 (36.0)​

已移除: PrinterInfo 上的 isDefault 和 status 属性​

已移除: Session.clearStorageData(options) 中的 quota 类型 syncable​

已弃用: Session.clearStorageData(options) 中的 quota 属性​

已弃用: ProtocolResponse 中 session 属性的 null 值​

已弃用: session 上的扩展方法和事件​

已移除: systemPreferences.isAeroGlassEnabled()​

已变更: 在运行 GNOME 时，GTK 4 为默认设置​

计划的重大 API 变更 (35.0)​

行为变更: Linux 上 Dialog API 的 defaultPath 选项​

已弃用: session.serviceWorkers 上的 getFromVersionID​

已弃用: Session 上的 setPreloads、getPreloads​

已弃用: WebContents 上 console-message 事件中的 level、message、line 和 sourceId 参数​

行为变更: WebRequestFilter 的 urls 属性。​

已弃用: systemPreferences.isAeroGlassEnabled()​

计划的重大 API 变更 (34.0)​

行为变更: 在 Windows 全屏期间将隐藏菜单栏​

计划的重大 API 变更 (33.0)​

已弃用: document.execCommand("paste")​

行为变更: 帧属性可能会检索到分离的 WebFrameMain 实例或根本没有​

行为变更: Windows 上的自定义协议 URL 处理​

行为变更: app 上 login 事件的 webContents 属性​

已弃用: BrowserWindowConstructorOption.type 中的 textured 选项​

已移除: macOS 10.15 支持​

行为变更: 原生模块现在需要 C++20​

已弃用: systemPreferences.accessibilityDisplayShouldReduceTransparency​

计划的重大 API 变更 (32.0)​

已移除: File.path​

已弃用: WebContents 上的 clearHistory、canGoBack、goBack、canGoForward、goForward、goToIndex、canGoToOffset、goToOffset​

行为变更: userData 中的 databases 目录将被删除​

计划的重大 API 变更 (31.0)​

已移除: WebSQL 支持​

行为变更: nativeImage.toDataURL 将保留 PNG 色彩空间​

行为变更: 在 macOS 上，window.flashFrame(bool) 将持续闪烁 dock 图标​

计划的重大 API 变更 (30.0)​

行为变更: 跨源 iframe 现在使用权限策略访问功能​

已移除: --disable-color-correct-rendering 开关​

行为变更: macOS 上的 BrowserView.setAutoResize 行为​

已弃用: BrowserView​

已移除: WebContents 上 context-menu 事件中的 params.inputFormType 属性​

已移除: process.getIOCounters()​

计划的重大 API 变更 (29.0)​

行为变更: ipcRenderer 不能再通过 contextBridge 发送​

已移除: app 上 renderer-process-crashed 事件​

已移除: WebContents 和 <webview> 上的 crashed 事件​

已移除: app 上 gpu-process-crashed 事件​

计划的重大 API 变更 (28.0)​

行为变更: WebContents.backgroundThrottling 设置为 false 会影响宿主 BrowserWindow 中的所有 WebContents​

已移除: BrowserWindow.setTrafficLightPosition(position)​

已移除: BrowserWindow.getTrafficLightPosition()​

已移除: ipcRenderer.sendTo()​

已移除: app.runningUnderRosettaTranslation​

已废弃: app 的 renderer-process-crashed 事件​

已废弃: WebContents 上 context-menu 的 params.inputFormType 属性​

已废弃: WebContents 和 <webview> 的 crashed 事件​

已废弃: app 的 gpu-process-crashed 事件​

计划中的重大 API 变更 (27.0)​

已移除: macOS 10.13 / 10.14 支持​

已废弃: ipcRenderer.sendTo()​

已移除: systemPreferences 中的配色方案事件​

已移除: macOS 上 window.setVibrancy 的部分选项​

已移除: webContents.getPrinters​

已移除: systemPreferences.{get,set}AppLevelAppearance 和 systemPreferences.appLevelAppearance​

已移除: systemPreferences.getColor 的 alternate-selected-control-text 值​

计划中的重大 API 变更 (26.0)​

已废弃: webContents.getPrinters​

已废弃: systemPreferences.{get,set}AppLevelAppearance 和 systemPreferences.appLevelAppearance​

已废弃: systemPreferences.getColor 的 alternate-selected-control-text 值​

计划中的重大 API 变更 (25.0)​

已废弃: protocol.{un,}{register,intercept}{Buffer,String,Stream,File,Http}Protocol 和 protocol.isProtocol{Registered,Intercepted}​

已废弃: BrowserWindow.setTrafficLightPosition(position)​

已废弃: BrowserWindow.getTrafficLightPosition()​

计划中的重大 API 变更 (24.0)​

API 已变更: nativeImage.createThumbnailFromPath(path, size)​

计划中的重大 API 变更 (23.0)​

重大变更的类型

计划的重大 API 变更 (37.0)

行为变更: Linux 上的 `BrowserWindow.IsVisibleOnAllWorkspaces()`

行为变更: `app.commandLine`

已弃用: `NativeImage.getBitmap()`

计划的重大 API 变更 (36.0)

已移除: `PrinterInfo` 上的 `isDefault` 和 `status` 属性

已移除: `Session.clearStorageData(options)` 中的 `quota` 类型 `syncable`

已弃用: `Session.clearStorageData(options)` 中的 `quota` 属性

已弃用: `ProtocolResponse` 中 `session` 属性的 `null` 值

已弃用: `session` 上的扩展方法和事件

已移除: `systemPreferences.isAeroGlassEnabled()`

已变更: 在运行 GNOME 时，GTK 4 为默认设置

计划的重大 API 变更 (35.0)

行为变更: Linux 上 Dialog API 的 `defaultPath` 选项

已弃用: `session.serviceWorkers` 上的 `getFromVersionID`

已弃用: `Session` 上的 `setPreloads`、`getPreloads`

已弃用: `WebContents` 上 `console-message` 事件中的 `level`、`message`、`line` 和 `sourceId` 参数

行为变更: `WebRequestFilter` 的 `urls` 属性。

已弃用: `systemPreferences.isAeroGlassEnabled()`

计划的重大 API 变更 (34.0)

行为变更: 在 Windows 全屏期间将隐藏菜单栏

计划的重大 API 变更 (33.0)

已弃用: `document.execCommand("paste")`

行为变更: 帧属性可能会检索到分离的 WebFrameMain 实例或根本没有

行为变更: Windows 上的自定义协议 URL 处理

行为变更: `app` 上 `login` 事件的 `webContents` 属性

已弃用: `BrowserWindowConstructorOption.type` 中的 `textured` 选项

已移除: macOS 10.15 支持

行为变更: 原生模块现在需要 C++20

已弃用: `systemPreferences.accessibilityDisplayShouldReduceTransparency`

计划的重大 API 变更 (32.0)

已移除: `File.path`

已弃用: `WebContents` 上的 `clearHistory`、`canGoBack`、`goBack`、`canGoForward`、`goForward`、`goToIndex`、`canGoToOffset`、`goToOffset`

行为变更: `userData` 中的 `databases` 目录将被删除

计划的重大 API 变更 (31.0)

已移除: `WebSQL` 支持

行为变更: `nativeImage.toDataURL` 将保留 PNG 色彩空间

行为变更: 在 macOS 上，`window.flashFrame(bool)` 将持续闪烁 dock 图标

计划的重大 API 变更 (30.0)

行为变更: 跨源 iframe 现在使用权限策略访问功能

已移除: `--disable-color-correct-rendering` 开关

行为变更: macOS 上的 `BrowserView.setAutoResize` 行为

已弃用: `BrowserView`

已移除: `WebContents` 上 `context-menu` 事件中的 `params.inputFormType` 属性

已移除: `process.getIOCounters()`

计划的重大 API 变更 (29.0)

行为变更: `ipcRenderer` 不能再通过 `contextBridge` 发送

已移除: `app` 上 `renderer-process-crashed` 事件

已移除: `WebContents` 和 `<webview>` 上的 `crashed` 事件

已移除: `app` 上 `gpu-process-crashed` 事件

计划的重大 API 变更 (28.0)

行为变更: `WebContents.backgroundThrottling` 设置为 false 会影响宿主 `BrowserWindow` 中的所有 `WebContents`

已移除: `BrowserWindow.setTrafficLightPosition(position)`

已移除: `BrowserWindow.getTrafficLightPosition()`

已移除: `ipcRenderer.sendTo()`

已移除: `app.runningUnderRosettaTranslation`

已废弃: `app` 的 `renderer-process-crashed` 事件

已废弃: `WebContents` 上 `context-menu` 的 `params.inputFormType` 属性

已废弃: `WebContents` 和 `<webview>` 的 `crashed` 事件

已废弃: `app` 的 `gpu-process-crashed` 事件

计划中的重大 API 变更 (27.0)

已移除: macOS 10.13 / 10.14 支持

已废弃: `ipcRenderer.sendTo()`

已移除: `systemPreferences` 中的配色方案事件

已移除: macOS 上 `window.setVibrancy` 的部分选项

已移除: `webContents.getPrinters`

已移除: `systemPreferences.{get,set}AppLevelAppearance` 和 `systemPreferences.appLevelAppearance`

已移除: `systemPreferences.getColor` 的 `alternate-selected-control-text` 值

计划中的重大 API 变更 (26.0)

已废弃: `webContents.getPrinters`

已废弃: `systemPreferences.{get,set}AppLevelAppearance` 和 `systemPreferences.appLevelAppearance`

已废弃: `systemPreferences.getColor` 的 `alternate-selected-control-text` 值

计划中的重大 API 变更 (25.0)

已废弃: `protocol.{un,}{register,intercept}{Buffer,String,Stream,File,Http}Protocol` 和 `protocol.isProtocol{Registered,Intercepted}`

已废弃: `BrowserWindow.setTrafficLightPosition(position)`

已废弃: `BrowserWindow.getTrafficLightPosition()`

计划中的重大 API 变更 (24.0)

API 已变更: `nativeImage.createThumbnailFromPath(path, size)`

计划中的重大 API 变更 (23.0)