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 full-screen 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

Browser compatibility

See also

• HTMLVideoElement.requestPictureInPicture()
• HTMLVideoElement.autoPictureInPicture
• HTMLVideoElement.disablePictureInPicture
• Document.pictureInPictureEnabled
• Document.pictureInPictureElement
• :picture-in-picture