DocumentPictureInPicture: window 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 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 # dom-documentpictureinpicture-window |
Browser compatibility
BCD tables only load in the browser