W3cubDocs

/Web APIs

DocumentPictureInPicture

Limited availability

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

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

The DocumentPictureInPicture interface of the Document Picture-in-Picture API is the entry point for creating and handling document picture-in-picture windows.

It is accessed via the Window.documentPictureInPicture property.

Instance properties

Inherits properties from its parent, EventTarget.

window Read only Experimental: Returns a Window instance representing the browsing context inside the Picture-in-Picture window.

Instance methods

Inherits methods from its parent, EventTarget.

requestWindow() Experimental: Opens the Picture-in-Picture window for the current main browsing context. Returns a Promise that fulfills with a Window instance representing the browsing context inside the Picture-in-Picture window.

Events

Inherits events from its parent, EventTarget.

enter Experimental: Fired when the Picture-in-Picture window is successfully opened.

Examples

const videoPlayer = document.getElementById("player");

// …

// Open a Picture-in-Picture window.
const pipWindow = await window.documentPictureInPicture.requestWindow({
  width: videoPlayer.clientWidth,
  height: videoPlayer.clientHeight,
});

// …

See Document Picture-in-Picture API Example for a full working demo (see the full source code also).

Specifications

Specification
Document Picture-in-Picture Specification> # documentpictureinpicture>

Browser compatibility

	Desktop					Mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet	WebView Android	WebView on iOS
`DocumentPictureInPicture`	116	116	No	102	No	No	No	No	No	No	No	No
`enter_event`	116	116	No	102	No	No	No	No	No	No	No	No
`requestWindow`	116	116	No	102	No	No	No	No	No	No	No	No
`window`	116	116	No	102	No	No	No	No	No	No	No	No