MDN self-hosted library · e01.org

DocumentPictureInPicture: window property

Document Picture-in-Picture API

Open notebook · 1 cells web-api-instance-property upstream source

Document Picture-in-Picture API

The window read-only property of the DocumentPictureInPicture interface returns a Window instance representing the browsing context inside the Picture-in-Picture window.

Value

A Window object instance if the Picture-in-Picture window has already been opened using DocumentPictureInPicture.requestWindow(), or null otherwise.

Examples

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

// …

await window.documentPictureInPicture.requestWindow({
  width: videoPlayer.clientWidth,
  height: videoPlayer.clientHeight,
});

// …

const pipWindow = window.documentPictureInPicture.window;
if (pipWindow) {
  // Mute video playing in the Picture-in-Picture window.
  const pipVideo = pipWindow.document.querySelector("#video");
  pipVideo.muted = true;
}

Specifications

Browser compatibility

See also