Window: documentPictureInPicture property

{{APIRef("Document Picture-in-Picture API")}}{{SeeCompatTable}}{{SecureContext_Header}}

The documentPictureInPicture read-only property of the {{domxref("Window")}} interface returns a reference to the {{domxref("DocumentPictureInPicture")}} object for the current document context.

Value

A {{domxref("DocumentPictureInPicture")}} object instance.

Examples

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

// …

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

// …

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• {{domxref("Document Picture-in-Picture API", "Document Picture-in-Picture API", "", "nocode")}}
• Using the Document Picture-in-Picture API