CaptureController: zoomLevel property

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The zoomLevel read-only property of the CaptureController interface returns the captured display surface's current zoom percentage.

Value

A number representing the current zoom percentage of the captured display surface.

Examples

Basic zoomLevel usage

In our live demo, shown in Using the Captured Surface Control API, we use the zoomLevel property inside an event handler function for the controller's zoomlevelchange event. When the event fires, the updated zoomLevel percentage is written to an <output> element.

js
// Create controller and start capture
const controller = new CaptureController();
videoElem.srcObject = await navigator.mediaDevices.getDisplayMedia({
  controller,
});

// ...

controller.addEventListener(
  "zoomlevelchange",
  () => (outputElem.textContent = `${controller.zoomLevel}%`),
);

See Using the Captured Surface Control API for a full working example.

Specifications

Specification
Captured Surface Control
# dom-capturecontroller-zoomlevel

Browser compatibility

See also