Skip to content

Conversation

@chrisdavidmills
Copy link
Contributor

Description

Chrome/Edge desktop 141 add support for the getDisplayMedia() windowAudio option. See https://chromestatus.com/feature/5072779506089984.

This PR adds a mention of it in the documentation. Note that in testing, the window value didn't seem to work. See also the compat data PR: mdn/browser-compat-data#28130

Motivation

Additional details

Related issues and pull requests

@chrisdavidmills chrisdavidmills requested a review from a team as a code owner October 8, 2025 17:52
@chrisdavidmills chrisdavidmills requested review from wbamberg and removed request for a team October 8, 2025 17:52
@github-actions github-actions bot added the Content:WebAPI Web API docs label Oct 8, 2025
@chrisdavidmills chrisdavidmills changed the title add getDisplayMedia() windowAudio option Technical review: add getDisplayMedia() windowAudio option Oct 8, 2025
@github-actions github-actions bot added the size/s [PR only] 6-50 LoC changed label Oct 8, 2025
@github-actions
Copy link
Contributor

github-actions bot commented Oct 8, 2025

Preview URLs

(comment last updated: 2025-10-09 10:54:36)

Copy link
Contributor

@beaufortfrancois beaufortfrancois left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM with nits

- `windowAudio` {{Experimental_Inline}} {{optional_inline}}
- : An enumerated value that hints to the browser what audio sharing option the user should be presented with alongside `window` sharing options. Possible values are:
- `exclude`: Hints that audio should not be shareable when a window sharing option is chosen.
- `window`: Hints that when a window sharing option is chosen, only audio originating from that window should be shared.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You may want to add a note saying it's working in Chrome for Windows OS only IIRC. @guidou would know more.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah, OK. This detail would be better added to the compat data. I'll fire up my Windows testing machine and test it out there.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for helping me figure this out!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hrm, I've tested it on Windows (in Chrome and Edge, Stable and Canary), and it doesn't seem to work there either. I'll leave the compat data as-is for now.

@chrisdavidmills chrisdavidmills changed the title Technical review: add getDisplayMedia() windowAudio option Editorial review: add getDisplayMedia() windowAudio option Oct 9, 2025
Copy link
Member

@Elchi3 Elchi3 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@chrisdavidmills chrisdavidmills merged commit 6e7d87b into mdn:main Oct 9, 2025
8 checks passed
@chrisdavidmills chrisdavidmills deleted the getDisplayMedia-windowAudio-option branch October 9, 2025 10:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants