W3cubDocs

/Web APIs

Document: pictureInPictureEnabled property

The read-only pictureInPictureEnabled property of the Document interface indicates whether or not picture-in-picture mode is available.

Picture-in-Picture mode is available by default unless specified otherwise by a Permissions-Policy.

Although this property is read-only, it will not throw if it is modified (even in strict mode); the setter is a no-operation and will be ignored.

Value

A boolean value, which is true if a video can enter picture-in-picture and be displayed in a floating window by calling HTMLVideoElement.requestPictureInPicture(). If picture-in-picture mode isn't available, this value is false.

Examples

In this example, before attempting to enter picture-in-picture mode for a <video> element the value of pictureInPictureEnabled is checked, to avoid making the call if the feature is not available.

js

function requestPictureInPicture() {
  if (document.pictureInPictureEnabled) {
    videoElement.requestPictureInPicture();
  } else {
    console.log("Your browser cannot use picture-in-picture right now");
  }
}

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
pictureInPictureEnabled 69 79 No No 56 13.1 No 105 No 72 13.4 20.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/pictureInPictureEnabled