PresentationConnection

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 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	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`PresentationConnection` 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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 48	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`binaryType` Experimental	Chrome Full support Yes	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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support Yes	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support Yes
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 49	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 48	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 50	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 50	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`onmessage` Experimental	Chrome Full support Yes	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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support Yes	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support Yes
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 50	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 48	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 48	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 5.0
`terminate` Experimental	Chrome Full support Yes	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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support Yes	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support Yes
`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 No support No	Opera Full support Yes	Safari ?	WebView Android No support No	Chrome Android Full support 57	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 Full support Yes	Safari iOS ?	Samsung Internet Android Full support 7.0

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.