PresentationRequest

A PresentationRequest object is used to initiate or reconnect to a presentation made by a controlling browsing context. The PresentationRequest object MUST be implemented in a controlling browsing context provided by a controlling user agent.

When a PresentationRequest is constructed, the given urls MUST be used as the list of presentation request URLs which are each a possible presentation URL for the PresentationRequest instance.

Constructor

PresentationRequest(): Creates a PresentationRequest.

Properties

None

Event handlers

PresentationRequest.onconnectionavailable: Fires on a successful call to PresentationRequest.start() or PresentationRequest.join(). This method provides a object with a reference to the created or joined object.

Methods

PresentationRequest.start(): Returns a Promise that resolves with a PresentationConnection after the user agent prompts the user to select a display and grant permission to use that display.
PresentationRequest.reconnect(): When the reconnect(presentationId) method is called on a PresentationRequest presentationRequest, the user agent MUST run the following steps to reconnect to a presentation.
PresentationRequest.getAvailability(): When the getAvailability() method is called, the user agent MUST run the steps as the link.

Specifications

Specification	Status	Comment
Presentation API The definition of 'PresentationRequest interface' in that specification.	Candidate Recommendation	Initial definition.

Browser Compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`PresentationRequest` Experimental	Chrome Full support 48	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera Full support 35	Safari ?	WebView Android No support No	Chrome Android Full support 48	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 35	Safari iOS ?	Samsung Internet Android ?
Secure context required Experimental	Chrome Full support 61	Edge ?	Firefox ?	IE ?	Opera Full support 48	Safari ?	WebView Android No support No	Chrome Android Full support 61	Edge Mobile ?	Firefox Android ?	Opera Android Full support 48	Safari iOS ?	Samsung Internet Android ?
`PresentationRequest()` constructor Experimental	Chrome Full support 48	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera Full support 35	Safari ?	WebView Android No support No	Chrome Android Full support 48	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 35	Safari iOS ?	Samsung Internet Android ?
`getAvailability` Experimental	Chrome Full support 48	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera Full support 35	Safari ?	WebView Android No support No	Chrome Android Full support 48	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 35	Safari iOS ?	Samsung Internet Android ?
`onconnectionavailable` Experimental	Chrome Full support 48	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera Full support 35	Safari ?	WebView Android No support No	Chrome Android Full support 48	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 35	Safari iOS ?	Samsung Internet Android ?
`reconnect` Experimental	Chrome Full support 48	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera Full support 35	Safari ?	WebView Android No support No	Chrome Android Full support 48	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 35	Safari iOS ?	Samsung Internet Android ?
`start` Experimental	Chrome Full support 48	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera Full support 35	Safari ?	WebView Android No support No	Chrome Android Full support 48	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 35	Safari iOS ?	Samsung Internet Android ?
`startWithDevice` Experimental	Chrome Full support 48	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera Full support 35	Safari ?	WebView Android No support No	Chrome Android Full support 48	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.controller.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android Full support 35	Safari iOS ?	Samsung Internet Android ?

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Experimental. Expect behavior to change in the future.: Experimental. Expect behavior to change in the future.
User must explicitly enable this feature.: User must explicitly enable this feature.