Permissions-Policy: captured-surface-control directive

{{SeeCompatTable}}

The HTTP {{HTTPHeader("Permissions-Policy")}} header captured-surface-control directive controls whether or not the document is permitted to use the Captured Surface Control API. Specifically, the {{domxref("CaptureController.forwardWheel", "forwardWheel()")}}, {{domxref("CaptureController.increaseZoomLevel", "increaseZoomLevel()")}}, {{domxref("CaptureController.decreaseZoomLevel", "decreaseZoomLevel()")}}, and {{domxref("CaptureController.resetZoomLevel", "resetZoomLevel()")}} methods are controlled by this directive.

The promise returned by the API's main methods will reject with a NotAllowedError {{DOMxRef("DOMException")}} if the permission is not allowed.

Syntax

Permissions-Policy: captured-surface-control=<allowlist>;

• <allowlist>
  • : A list of origins for which permission is granted to use the feature. See Permissions-Policy > Syntax for more details.

Default policy

The default allowlist for captured-surface-control is self.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{HTTPHeader("Permissions-Policy")}} header
• Permissions Policy
• Screen Capture API
• Using the Captured Surface Control API