PresentationConnection

The PresentationConnection interface of the Presentation API provides methods and properties for managing a single presentation. Each presentation connection is represented by a PresentationConnection object. Both the controlling user agent and receiving user agent MUST implement PresentationConnection.

Properties

PresentationConnection.binaryType: Returns either blob or arrayBuffer. When a PresentationConnection object is created, its binaryType IDL attribute MUST be set to the string " arraybuffer".
PresentationConnection.id Read only: Provides the presentation connection identifier.
PresentationConnection.state Read only: Returns the presentation connection's current state.
PresentationConnection.url Read only: Returns the URL used to create or reconnect to the presentation.

Event handlers

PresentationConnection.onclose: Fired when there is a call to PresentationConnection.close().
PresentationConnection.onconnect: Fired when a presentation connection is established.
PresentationConnection.onmessage: Fired when there is a call to PresentationConnection.send().
PresentationConnection.onterminated: Fired when there is a call to PresentationConnection.terminate().

Methods

PresentationConnection.close(): Closes the current connection and sends a PresentationConnectionCloseEvent to PresentationConnection.onclosed.
PresentationConnection.send(): Sends either binary or text data between a controlling browsing context and a presenting browsing context.
PresentationConnection.terminate(): Terminates the current connection and fires PresentationConnection.onterminated.

Specifications

Specification	Status	Comment
Presentation API The definition of 'PresentationConnection 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
Basic support 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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`binaryType` Experimental	Chrome ?	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android ?	Chrome Android ?	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`close` Experimental	Chrome Full support 49	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android No support No	Chrome Android Full support 49	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`id` 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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`onclose` Experimental	Chrome Full support 50	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android No support No	Chrome Android Full support 50	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`onconnect` Experimental	Chrome Full support 50	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android No support No	Chrome Android Full support 50	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`onmessage` Experimental	Chrome ?	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android ?	Chrome Android ?	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`onterminate` Experimental	Chrome Full support 50	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android No support No	Chrome Android Full support 50	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`send` 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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`state` 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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	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.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`terminate` Experimental	Chrome ?	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android ?	Chrome Android ?	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	Safari iOS ?	Samsung Internet Android ?
`url` Experimental	Chrome Full support 57	Edge ?	Firefox Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE ?	Opera ?	Safari ?	WebView Android No support No	Chrome Android Full support 57	Edge Mobile ?	Firefox Android Full support 51 Disabled Full support 51 Disabled Disabled From version 51: this feature is behind the `dom.presentation.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	Opera Android ?	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.