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
PresentationConnectionobject is created, itsbinaryTypeIDL attribute MUST be set to the string "arraybuffer". PresentationConnection.idRead only- Provides the presentation connection identifier.
PresentationConnection.stateRead only- Returns the presentation connection's current state.
PresentationConnection.urlRead 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
PresentationConnectionCloseEventtoPresentationConnection.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
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Feature | Chrome | Edge | Firefox | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|---|
| Basic support | 48 | ? | 511 | ? | ? | ? |
binaryType | ? | ? | 511 | ? | ? | ? |
close | 49 | ? | 511 | ? | ? | ? |
id | 48 | ? | 511 | ? | ? | ? |
onclose | 50 | ? | 511 | ? | ? | ? |
onconnect | 50 | ? | 511 | ? | ? | ? |
onmessage | ? | ? | 511 | ? | ? | ? |
onterminate | 50 | ? | 511 | ? | ? | ? |
send | 48 | ? | 511 | ? | ? | ? |
state | 48 | ? | 511 | ? | ? | ? |
terminate | ? | ? | 511 | ? | ? | ? |
url | 57 | ? | 511 | ? | ? | ? |
| Feature | Android webview | Chrome for Android | Edge mobile | Firefox for Android | Opera Android | iOS Safari | Samsung Internet |
|---|---|---|---|---|---|---|---|
| Basic support | No | 48 | ? | 511 | ? | ? | ? |
binaryType | ? | ? | ? | 511 | ? | ? | ? |
close | No | 49 | ? | 511 | ? | ? | ? |
id | No | 48 | ? | 511 | ? | ? | ? |
onclose | No | 50 | ? | 511 | ? | ? | ? |
onconnect | No | 50 | ? | 511 | ? | ? | ? |
onmessage | ? | ? | ? | 511 | ? | ? | ? |
onterminate | No | 50 | ? | 511 | ? | ? | ? |
send | No | 48 | ? | 511 | ? | ? | ? |
state | No | 48 | ? | 511 | ? | ? | ? |
terminate | ? | ? | ? | 511 | ? | ? | ? |
url | No | 57 | ? | 511 | ? | ? | ? |
1. 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.