ShadowRoot: pictureInPictureElement property

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

The pictureInPictureElement read-only property of the ShadowRoot interface returns the Element that is currently being presented in picture-in-picture mode in this shadow tree, or null if picture-in-picture mode is not currently in use.

Value

A reference to the Element object that's currently in picture-in-picture mode.

Returns null if the shadow tree has no associated element in picture-in-picture mode. For example, there's no picture-in-picture element, or the element is not in the shadow tree.

Examples

js
let customElem = document.querySelector("my-shadow-dom-element");
let shadow = customElem.shadowRoot;
let pipElem = shadow.pictureInPictureElement;

Specifications

Specification
Picture-in-Picture
# ref-for-dom-documentorshadowroot-pictureinpictureelement①⑤

Browser compatibility

BCD tables only load in the browser

See also