Document.exitPictureInPicture()
The Document
method
exitPictureInPicture()
requests that a video contained
in this document, which is currently floating, be taken out of picture-in-picture
mode, restoring the previous state of the screen. This usually reverses the
effects of a previous call to HTMLVideoElement.requestPictureInPicture()
.
Syntax
exitPromise = document.exitPictureInPicture();
Parameters
None.
Return value
A Promise
, which is resolved once the user agent has
finished exiting picture-in-picture mode. If an error occurs while attempting to exit
fullscreen mode, the catch()
handler for the promise is called.
Examples
This example causes the current document to exit picture-in-picture mode whenever the mouse button is clicked within it.
document.onclick = function (event) {
if (document.pictureInPictureElement) {
document.exitPictureInPicture()
.then(() => console.log("Document Exited from Picture-in-Picture mode"))
.catch((err) => console.error(err))
} else {
video.requestPictureInPicture();
}
}
Specifications
Specification |
---|
Picture-in-Picture # ref-for-dom-document-exitpictureinpicture |
Browser compatibility
BCD tables only load in the browser