Skip to content

fix: restore AXDocument accessibility attribute for representedFilename on macOS#49418

Merged
codebytere merged 1 commit into39-x-yfrom
trop/39-x-y-bp-fix-restore-axdocument-accessibility-attribute-for-representedfilename-on-macos-1768555656170
Jan 19, 2026
Merged

fix: restore AXDocument accessibility attribute for representedFilename on macOS#49418
codebytere merged 1 commit into39-x-yfrom
trop/39-x-y-bp-fix-restore-axdocument-accessibility-attribute-for-representedfilename-on-macos-1768555656170

Conversation

@trop
Copy link
Copy Markdown
Contributor

@trop trop bot commented Jan 16, 2026

Backport of #49346

See that PR for details.

Notes: Fixed setRepresentedFilename() not setting AXDocument accessibility attribute on macOS.

…me on macOS

Starting from Chromium 134.0.6989.0 (Electron 35.0.0-beta.5), the
NativeWidgetMacNSWindow class overrides accessibilityDocument to return
the web content URL from the accessibility tree, but doesn't fall back
to NSWindow's default behavior when that URL is empty.

This broke Electron's setRepresentedFilename() API - the file path was
still set on the NSWindow, but no longer exposed via the AXDocument
accessibility attribute that screen readers use.

This fix adds an accessibilityDocument override in ElectronNSWindow that
checks representedFilename first, falling back to Chromium's behavior
for web content URLs.

Fixes: https://github.com/electron/electron/issues/XXXXX

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Co-authored-by: Daniel Gräfe <Daniel.Alm@ForumD.net>
@trop trop bot requested a review from a team January 16, 2026 09:27
@trop trop bot added 39-x-y backport This is a backport PR semver/patch backwards-compatible bug fixes labels Jan 16, 2026
@codebytere codebytere merged commit a4eb213 into 39-x-y Jan 19, 2026
106 of 108 checks passed
@codebytere codebytere deleted the trop/39-x-y-bp-fix-restore-axdocument-accessibility-attribute-for-representedfilename-on-macos-1768555656170 branch January 19, 2026 14:02
@release-clerk
Copy link
Copy Markdown

release-clerk bot commented Jan 19, 2026

Release Notes Persisted

Fixed setRepresentedFilename() not setting AXDocument accessibility attribute on macOS.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

39-x-y backport This is a backport PR semver/patch backwards-compatible bug fixes

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant