Document: pictureInPictureElement property
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
The read-onlypictureInPictureElement property of theDocumentinterface returns theElement that is currently beingpresented in picture-in-picture mode in this document, ornull ifpicture-in-picture mode is not currently in use.
Although this property is read-only, it will not throw if it is modified (even instrict mode); the setter is a no-operation and will be ignored.
Value
A reference to theElement object that's currently in picture-in-picture mode.
Returnsnull if the document has no associated element in picture-in-picture mode. For example, there's no picture-in-picture element, or the element is from an iframe.
Examples
This example presents a function,exitPictureInPicture(),which tests the value returned bypictureInPictureElement. If the documentis in picture-in-picture mode (pictureInPictureElement isn'tnull),Document.exitPictureInPicture() is run to exitpicture-in-picture mode.
function exitPictureInPicture() { if (document.pictureInPictureElement) { document.exitPictureInPicture(); }}Specifications
| Specification |
|---|
| Picture-in-Picture # dom-documentorshadowroot-pictureinpictureelement |