exitPictureInPicture

exitPictureInPicture refers to the Web Picture-in-Picture API function document.exitPictureInPicture(), used to exit a media element that is currently displayed in Picture-in-Picture (PiP) mode. When invoked, the PiP window closes and the media element returns to its normal placement in the page if applicable. The function is called on the global Document object.

The return value is a Promise that resolves when the exit operation completes. It may reject if there is no active PiP session or if the exit operation fails for another reason. Developers typically handle this asynchronously with then/catch or by using await.

Usage typically follows a request to enter PiP. You can check whether PiP is active by examining document.pictureInPictureElement. To exit PiP, call document.exitPictureInPicture(), for example: document.exitPictureInPicture().then(() => { console.log('Exited Picture-in-Picture'); }).catch(error => { console.error(error); });

Notes and compatibility: Exit PiP is supported by modern browsers that implement the Picture-in-Picture API, though exact support can vary by platform and browser version. Some browsers enforce restrictions related to user gestures for PiP entry; exiting PiP is generally allowed, but behavior can differ in edge cases. Developers should test across target environments and handle potential errors from the returned Promise.

See also: the corresponding videoElement.requestPictureInPicture() method, the pictureInPictureElement property, and related events such as leavepictureinpicture.