DocumentPictureInPicture: window property

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

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

js

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

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

Browser compatibility

BCD tables only load in the browser

See also