Region captureLimited availability
When using navigator.mediaDevices.getDisplayMedia() to capture a browser tab as a video stream, the region capture API allows you to crop the video to the bounding box of a given element. In contrast to the element capture API, any content that overlays that element is also captured.
Not yet supported in all major browsers — check the table and provide a fallback.
Browser support
DesktopChrome
1–103Not supported
104+Supportedsince Aug 2, 2022
Current: 155Edge
12–103Not supported
104+Supportedsince Aug 5, 2022
Current: 154Firefox
✕Not supportedup to 157
Current: 157Safari
✕Not supportedup to 27
Current: 27MobileChrome Android
✕Not supportedup to 155
Current: 155Firefox Android
✕Not supportedup to 157
Current: 157Safari iOS
✕Not supportedup to 27
Current: 27How 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: BrowserCaptureMediaStreamTrack.
Feature detection
JS · check before using
if ("BrowserCaptureMediaStreamTrack" in globalThis) {
// BrowserCaptureMediaStreamTrack is available
} else {
// load a polyfill or use a fallback
}Specification
Sub-features
Support for each part of the feature (5). The overall table above shows when the whole feature works.
| Sub-feature | Chrome | Edge | Firefox | Safari | Chrome Android | Firefox Android | Safari iOS |
|---|---|---|---|---|---|---|---|
| BrowserCaptureMediaStreamTrack | 104 | 104 | ✕ | ✕ | 121 | ✕ | ✕ |
| BrowserCaptureMediaStreamTrack.clone | 104 | 104 | ✕ | ✕ | 121 | ✕ | ✕ |
| BrowserCaptureMediaStreamTrack.cropTo | 104 | 104 | ✕ | ✕ | ✕ | ✕ | ✕ |
| CropTarget | 104 | 104 | ✕ | ✕ | ✕ | ✕ | ✕ |
| CropTarget.fromElement_static | 104 | 104 | ✕ | ✕ | ✕ | ✕ | ✕ |