coderef

Element captureLimited availability

The restrictTo() method on screen capture media tracks limits capture to a specific element, excluding content which might occlude the element itself, such as video conferencing controls.

Not yet supported in all major browsers — check the table and provide a fallback.

Browser support

DesktopChrome
1–131Not supported
132+Supportedsince Jan 14, 2025
Current: 155
Edge
12–131Not supported
132+Supportedsince Jan 17, 2025
Current: 154
Firefox
✕Not supportedup to 157
Current: 157
Safari
✕Not supportedup to 27
Current: 27
MobileChrome Android
✕Not supportedup to 155
Current: 155
Firefox Android
✕Not supportedup to 157
Current: 157
Safari iOS
✕Not supportedup to 27
Current: 27

How to use

Not supported in Firefox, Safari, Chrome Android, Firefox Android, Safari iOS. Use feature detection below and provide a fallback (or a polyfill) for those browsers.

Example

Full syntax and examples are on MDN: restrictTo.

Feature detection

JS · check before using
if ("BrowserCaptureMediaStreamTrack" in globalThis && "restrictTo" in BrowserCaptureMediaStreamTrack.prototype) {
  // BrowserCaptureMediaStreamTrack.restrictTo is available
}

Sub-features

Support for each part of the feature (3). The overall table above shows when the whole feature works.

Sub-featureChromeEdgeFirefoxSafariChrome AndroidFirefox AndroidSafari iOS
BrowserCaptureMediaStreamTrack.restrictTo132132✕✕✕✕✕
RestrictionTarget132132✕✕✕✕✕
RestrictionTarget.fromElement_static132132✕✕✕✕✕