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
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic support
Experimental
Chrome Full support 48Edge ? 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 35Safari ? WebView Android Full support 48Chrome Android Full support 48Edge 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 35Safari iOS ? Samsung Internet Android ?
Secure context required (HTTPS)
Experimental
Chrome Full support 61Edge ? Firefox ? IE ? Opera Full support 48Safari ? WebView Android Full support 61Chrome Android Full support 61Edge Mobile ? Firefox Android ? Opera Android Full support 48Safari iOS ? Samsung Internet Android ?
PresentationRequest() constructor
Experimental
Chrome Full support 48Edge ? 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 35Safari ? WebView Android Full support 48Chrome Android Full support 48Edge 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 35Safari iOS ? Samsung Internet Android ?
getAvailability
Experimental
Chrome Full support 48Edge ? 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 35Safari ? WebView Android Full support 48Chrome Android Full support 48Edge 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 35Safari iOS ? Samsung Internet Android ?
onconnectionavailable
Experimental
Chrome Full support 48Edge ? 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 35Safari ? WebView Android Full support 48Chrome Android Full support 48Edge 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 35Safari iOS ? Samsung Internet Android ?
reconnect
Experimental
Chrome Full support 48Edge ? 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 35Safari ? WebView Android Full support 48Chrome Android Full support 48Edge 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 35Safari iOS ? Samsung Internet Android ?
start
Experimental
Chrome Full support 48Edge ? 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 35Safari ? WebView Android Full support 48Chrome Android Full support 48Edge 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 35Safari iOS ? Samsung Internet Android ?
startWithDevice
Experimental
Chrome Full support 48Edge ? 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 35Safari ? WebView Android Full support 48Chrome Android Full support 48Edge 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 35Safari iOS ? Samsung Internet Android ?

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.

Document Tags and Contributors

Contributors to this page: lucian95, jpmedley, MashKao, rolfedh
Last updated by: lucian95,