George Xu 4f84efa1ea deprecate: mark desktopCapturer.getSources as deprecated ...

Deprecate desktopCapturer.getSources() in favor of
session.setDisplayMediaRequestHandler(), which aligns with the
web-standard navigator.mediaDevices.getDisplayMedia() API.

Changes:
- Add deprecation warning (warnOnce) to getSources()
- Mark getSources() as deprecated in docs with migration guide
- Update session.md examples to not use desktopCapturer.getSources
- Add breaking-changes.md entry for 43.0
- Add tests for preferredDisplaySurface in media handler

Notes: Deprecated `desktopCapturer.getSources()` in favor of `session.setDisplayMediaRequestHandler()`.

2026-05-01 12:44:28 -07:00

..

structures

feat: support WebAuthn Touch ID platform authenticator on macOS (#51255)

2026-04-30 12:40:03 -04:00

app.md

feat: support WebAuthn Touch ID platform authenticator on macOS (#51255)

2026-04-30 12:40:03 -04:00

auto-updater.md

feat: msix auto-updater (#49230)

2026-01-29 16:38:26 -05:00

base-window.md

docs: note required windows in 'new-window-for-tab' event (#49851)

2026-02-18 19:30:43 -08:00

browser-view.md

docs: no class inheritance (#47403)

2025-06-10 10:00:06 +02:00

browser-window.md

docs: note required windows in 'new-window-for-tab' event (#49851)

2026-02-18 19:30:43 -08:00

client-request.md

docs: fix typos across documentation (#49734)

2026-02-11 12:45:46 +01:00

clipboard.md

docs: add more api history (C-D) (#49510)

2026-03-05 11:30:20 +01:00

command-line-switches.md

feat: allow --experimental-inspector-network-resource node flag (#49689)

2026-04-28 16:23:15 -04:00

command-line.md

chore: lint code blocks in docs with ESLint (#42113)

2025-05-29 12:45:26 -07:00

content-tracing.md

feat: support heap profiling in contentTracing (#50826)

2026-04-20 15:01:13 +09:00

context-bridge.md

feat: context bridge support VideoFrame (#47316)

2025-08-07 16:41:49 -04:00

cookies.md

feat: introduce os_crypt_async in safeStorage (#49054)

2026-02-15 19:54:50 +01:00

corner-smoothing-css.md

docs: fix typos across documentation (#49734)

2026-02-11 12:45:46 +01:00

crash-reporter.md

docs: add more api history (C-D) (#49510)

2026-03-05 11:30:20 +01:00

debugger.md

docs: remove stale example and standardize DevTools capitalization (#49321)

2026-01-14 10:35:53 +01:00

desktop-capturer.md

deprecate: mark desktopCapturer.getSources as deprecated

2026-05-01 12:44:28 -07:00

dialog.md

feat: use Downloads folder as default path for file dialogs (#49868)

2026-03-20 17:28:53 -04:00

dock.md

docs: Document known issue with dock.hide() method (#50476)

2026-03-27 10:00:04 -04:00

download-item.md

chore: lint code blocks in docs with ESLint (#42113)

2025-05-29 12:45:26 -07:00

environment-variables.md

docs: add ELECTRON_INSTALL env vars and remove ELECTRON_SKIP_BINARY_D… (#50979)

2026-04-15 11:35:35 -05:00

extensions-api.md

docs: remove stale example and standardize DevTools capitalization (#49321)

2026-01-14 10:35:53 +01:00

extensions.md

docs: unify [!NOTE] structure (#46893)

2025-05-09 14:36:42 -07:00

global-shortcut.md

feat: add setSuspended and isSuspended to globalShortcut (#50425)

2026-04-07 15:21:43 +02:00

image-view.md

docs: add API history (G-I) (#50194)

2026-03-12 14:43:39 +01:00

in-app-purchase.md

docs: add API history (G-I) (#50194)

2026-03-12 14:43:39 +01:00

incoming-message.md

docs: fix typos across documentation (#49734)

2026-02-11 12:45:46 +01:00

ipc-main-service-worker.md

docs: no class inheritance (#47403)

2025-06-10 10:00:06 +02:00

ipc-main.md

docs: add API history (G-I) (#50194)

2026-03-12 14:43:39 +01:00

ipc-renderer.md

docs: add API history (G-I) (#50194)

2026-03-12 14:43:39 +01:00

menu-item.md

feat: add accessible labels for macOS menus (#50240)

2026-04-30 09:39:43 -04:00

menu.md

fix: move Electron help menu links to default app only (#50629)

2026-04-09 12:14:22 -07:00

message-channel-main.md

docs: no class inheritance (#47403)

2025-06-10 10:00:06 +02:00

message-port-main.md

docs: fix broken links (#36519)

2022-12-05 13:18:57 -05:00

native-image.md

docs: explain how to load SF Symbols with nativeImage (#48908)

2025-11-13 10:41:00 -05:00

native-theme.md

feat: add accessibilityDisplayShouldDifferentiateWithoutColor on macOS (#49912)

2026-03-20 19:51:23 -04:00

navigation-history.md

docs: clarify navigationhistory offsets (#45616)

2025-02-21 17:35:17 -06:00

net-log.md

docs: unify [!NOTE] structure (#46893)

2025-05-09 14:36:42 -07:00

net.md

chore: lint code blocks in docs with ESLint (#42113)

2025-05-29 12:45:26 -07:00

notification.md

feat: add Notification.getHistory() for macOS (#50325)

2026-04-16 16:49:10 -07:00

parent-port.md

docs: fix broken links (#36519)

2022-12-05 13:18:57 -05:00

power-monitor.md

docs: fix powerMonitor event types (#45518)

2025-02-10 10:13:11 -05:00

power-save-blocker.md

docs: unify [!NOTE] structure (#46893)

2025-05-09 14:36:42 -07:00

process.md

docs: fix typos across documentation (#49734)

2026-02-11 12:45:46 +01:00

protocol.md

docs: clarify allowed characters in protocol names (#50411)

2026-03-27 09:39:16 -04:00

push-notifications.md

fix: APNS token ids are lowercase ASCII (#46101)

2025-03-20 07:57:50 +01:00

safe-storage.md

fix: lazily initialize safeStorage async encryptor (#50419)

2026-03-23 10:47:14 -07:00

screen.md

fix: screen.getCursorScreenPoint() crash on Wayland (#50092)

2026-03-06 15:24:33 -05:00

service-worker-main.md

docs: fix some module headings (#48177)

2025-08-27 14:52:26 -07:00

service-workers.md

chore: lint code blocks in docs with ESLint (#42113)

2025-05-29 12:45:26 -07:00

session.md

deprecate: mark desktopCapturer.getSources as deprecated

2026-05-01 12:44:28 -07:00

share-menu.md

docs: add a few API history fragments (#49340)

2026-01-21 12:57:02 -05:00

shared-texture.md

chore: use relative links from docs/ to files outside of docs/ (#49605)

2026-02-19 01:15:27 -08:00

shell.md

docs: document that shell.trashItem requires backslashes (#49038)

2026-01-21 13:21:01 -05:00

system-preferences.md

feat: Add getAccentColor on Linux (#48027)

2025-10-21 14:26:30 -04:00

touch-bar-button.md

docs: type names changed from wrapper to primitive (#31752)

2021-11-15 22:13:18 -06:00

touch-bar-color-picker.md

docs: type names changed from wrapper to primitive (#31752)

2021-11-15 22:13:18 -06:00

touch-bar-group.md

fix: ensure the typescript definitions only export correct value types (#28712)

2021-06-15 13:50:31 -07:00

touch-bar-label.md

docs: type names changed from wrapper to primitive (#31752)

2021-11-15 22:13:18 -06:00

touch-bar-other-items-proxy.md

docs: unify [!NOTE] structure (#46893)

2025-05-09 14:36:42 -07:00

touch-bar-popover.md

docs: type names changed from wrapper to primitive (#31752)

2021-11-15 22:13:18 -06:00

touch-bar-scrubber.md

fix: documentation spelling errors (#43366)

2024-08-22 15:44:55 +02:00

touch-bar-segmented-control.md

docs: type names changed from wrapper to primitive (#31752)

2021-11-15 22:13:18 -06:00

touch-bar-slider.md

docs: type names changed from wrapper to primitive (#31752)

2021-11-15 22:13:18 -06:00

touch-bar-spacer.md

docs: type names changed from wrapper to primitive (#31752)

2021-11-15 22:13:18 -06:00

touch-bar.md

docs: remove documentation link to discontinued Touch Bar Simulator (#49899)

2026-02-23 15:04:31 -05:00

tray.md

feat: allow macOS tray to maintain position (#47838)

2025-08-07 19:25:50 +02:00

utility-process.md

feat: add session support to requests from utility process (#51279)

2026-04-30 15:03:20 -04:00

view.md

feat: Add view.setBackgroundBlur (#51076)

2026-04-30 12:52:11 -04:00

web-contents-view.md

docs: no class inheritance (#47403)

2025-06-10 10:00:06 +02:00

web-contents.md

docs: add further disposition description (#50246)

2026-04-28 12:03:49 -04:00

web-frame-main.md

feat: add copyVideoFrameAt and saveVideoFrameAs methods on webContents (#48149)

2026-03-20 15:32:09 -04:00

web-frame.md

docs: remove stale example and standardize DevTools capitalization (#49321)

2026-01-14 10:35:53 +01:00

web-request.md

feat: add excludeUrls and modify urls in WebRequestFilter for better URL filtering (#44692)

2025-02-17 12:40:47 -08:00

web-utils.md

docs: recommend calling renderer process modules from preload script (#48427)

2025-10-04 18:44:10 +02:00

webview-tag.md

feat: allow defaulting to printer default page size (#49523)

2026-02-13 07:40:14 -05:00

window-open.md

fix: restrict window.open features to allowlisted BrowserWindow options (#50902)

2026-04-11 03:43:55 -04:00