ContextQMD
Back to Content

RestrictionTarget

files/en-us/web/api/restrictiontarget/index.md

latest1.7 KB
Original Source

{{APIRef("Screen Capture API")}}{{SeeCompatTable}}

The RestrictionTarget interface of the {{domxref("Screen Capture API", "Screen Capture API", "", "nocode")}} provides a static method, {{domxref("RestrictionTarget.fromElement_static", "fromElement()")}}, which returns a RestrictionTarget instance that can be used to restrict a captured video track to a specified DOM element.

{{InheritanceDiagram}}

Static methods

  • {{domxref("RestrictionTarget.fromElement_static", "fromElement()")}} {{Experimental_Inline}}
    • : Returns a RestrictionTarget instance that can be used to restrict a captured video track to a specified DOM element (plus its descendants).

Examples

js
// Options for getDisplayMedia()
const displayMediaOptions = {
  preferCurrentTab: true,
};

// Create restriction target from DOM element
const demoElem = document.querySelector("#demo");
const restrictionTarget = await RestrictionTarget.fromElement(demoElem);

// Capture video stream from user's webcam and isolate video track
const stream =
  await navigator.mediaDevices.getDisplayMedia(displayMediaOptions);
const [track] = stream.getVideoTracks();

// Restrict video track
await track.restrictTo(restrictionTarget);

// Broadcast restricted stream in <video> element
videoElem.srcObject = stream;

See Using the Element Capture and Region Capture APIs for in-context example code.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also