Document.pictureInPictureEnabled

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 Feature-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.

Syntax

let isPictureInPictureAvailable = document.pictureInPictureEnabled;

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.requestFullscreen(). 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, in order to avoid making the call if the feature is not available.

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
No
No
No
13.4
No

See also

© 2005–2021 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