Firefox Tomorrow

web api instance property

CaptureController: zoomLevel property

View on MDN ↗

Limited availability

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

Value

A number representing the current zoom level 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 is written to an <output> element.

// 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

SpecificationsStandards references are available on the canonical MDN page.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also