Window: documentPictureInPicture property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

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

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The documentPictureInPicture read-only property of the Window interface returns a reference to the DocumentPictureInPicture object for the current document context.

Value

A DocumentPictureInPicture object instance.

Examples

js
const videoPlayer = document.getElementById("player");

// ...

// Open a Picture-in-Picture window.
await window.documentPictureInPicture.requestWindow({
  width: videoPlayer.clientWidth,
  height: videoPlayer.clientHeight,
});

// ...

Specifications

Specification
Document Picture-in-Picture Specification
# dom-window-documentpictureinpicture

Browser compatibility

BCD tables only load in the browser

See also