mdn / mdn/content

Consider remove `MediaTrackSupportedConstraints` `MediaTrackSettings` `MediaTrackConstraints` directionary

Open
#30,961 13 comments 0 reactions 0 assignees View on GitHub
area: MediaStreams Content:WebAPI
Dominant language
Markdown
Stars
11k
Forks
23.2k
Avg merge
2d 1h
Merged PRs (30d)
325

Description

### MDN URL

https://developer.mozilla.org/en-US/docs/Web/API/Media_Capture_and_Streams_API

### What specific section or headline is this issue about?

_No response_

### What information was incorrect, unhelpful, or incomplete?

the `MediaTrackSupportedConstraints` dictionary is only used by `MediaDevices.getSupportedConstraints()`

the `MediaTrackConstraints` dictionary is used in `MediaDevices.getUserMedia()` `MediaStreamTrack.getConstraints()` `MediaStreamTrack.applyConstraints()` (and `MediaDevices.getDisplayMedia()`), and it is different from the spec defines, which should contain a `advanced` property and should inherit from `MediaTrackConstraintSet` dictionary

the `MediaTrackSettings` dictionary is only used in `MediaStreamTrack.getSettings()`

note that its compat data also need to remove

also the API GroupData need to be updated

---

the `MediaTrackCapabilities` dictionary is already removed, which is used in `InputDeviceInfo.getCapabilities()` and `MediaStreamTrack.getCapabilities()`

---

note these dictionaries is extended by [Screen Capture API](https://w3c.github.io/mediacapture-screen-share/) and [MediaStream Image Capture API](https://w3c.github.io/mediacapture-image/)

---

BCD update https://github.com/mdn/browser-compat-data/pull/21761

BCD unlink https://github.com/mdn/content/pull/32579

### What did you expect to see?

as above

### Do you have any supporting links, references, or citations?

_No response_

### Do you have anything more you want to share?

_No response_

Contributor guide

Open the contributing guide

Research direction

Start with the MDN Media Capture and Streams API page and inspect the three named dictionary entries and their references. Review the linked browser-compat-data pull request and content unlink pull request, then account for the Screen Capture and MediaStream Image Capture extensions. Done means the obsolete dictionaries, compat data, and API GroupData are updated consistently.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation, web-dev
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.