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.

Feature	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari
Basic support	48	?	51¹	?	35	?
Secure context required (HTTPS)	61	?	?	?	48	?
`PresentationRequest` constructor	48	?	51¹	?	35	?
`getAvailability`	48	?	51¹	?	35	?
`onconnectionavailable`	48	?	51¹	?	35	?
`reconnect`	48	?	51¹	?	35	?
`start`	48	?	51¹	?	35	?
`startWithDevice`	48	?	51¹	?	35	?

Feature	Android webview	Chrome for Android	Edge mobile	Firefox for Android	Opera Android	iOS Safari	Samsung Internet
Basic support	48	48	?	51¹	35	?	?
Secure context required (HTTPS)	61	61	?	?	48	?	?
`PresentationRequest` constructor	48	48	?	51¹	35	?	?
`getAvailability`	48	48	?	51¹	35	?	?
`onconnectionavailable`	48	48	?	51¹	35	?	?
`reconnect`	48	48	?	51¹	35	?	?
`start`	48	48	?	51¹	35	?	?
`startWithDevice`	48	48	?	51¹	35	?	?

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

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Edge Mobile	Firefox for Android	Opera for Android	iOS Safari	Samsung Internet
Basic support Experimental	Full support 48	?	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.	?	Full support 35	?	Full support 48	Full support 48	?	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.	Full support 35	?	?
Secure context required (HTTPS) Experimental	Full support 61	?	?	?	Full support 48	?	Full support 61	Full support 61	?	?	Full support 48	?	?
`PresentationRequest` constructor Experimental	Full support 48	?	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.	?	Full support 35	?	Full support 48	Full support 48	?	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.	Full support 35	?	?
`getAvailability` Experimental	Full support 48	?	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.	?	Full support 35	?	Full support 48	Full support 48	?	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.	Full support 35	?	?
`onconnectionavailable` Experimental	Full support 48	?	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.	?	Full support 35	?	Full support 48	Full support 48	?	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.	Full support 35	?	?
`reconnect` Experimental	Full support 48	?	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.	?	Full support 35	?	Full support 48	Full support 48	?	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.	Full support 35	?	?
`start` Experimental	Full support 48	?	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.	?	Full support 35	?	Full support 48	Full support 48	?	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.	Full support 35	?	?
`startWithDevice` Experimental	Full support 48	?	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.	?	Full support 35	?	Full support 48	Full support 48	?	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.	Full support 35	?	?

Legend

Full support: Full 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.