When the reconnect(presentationId) method is called on a PresentationRequest presentationRequest, the user agent MUST run the following steps to reconnect to a presentation:
- Input
- presentationRequest, the
PresentationRequestobject thatreconnect() - presentationId, a valid presentation identifier
- Output
- P, a Promise
- Using the document's settings object run the prohibits mixed security contexts algorithm.
- If the result of the algorithm is
"Prohibits Mixed Security Contexts"and the presentation request URL of presentationRequest is an a priori unauthenticated URL, then return a Promise rejected with aSecurityErrorand abort these steps. - If the document object's active sandboxing flag set has the sandboxed presentation browsing context flag set, then return a Promise rejected with a
SecurityErrorand abort these steps. - Let P be a new Promise.
- Return P but continue running these steps in parallel.
- Search the set of controlled presentations for a
PresentationConnectionthat meets the following criteria: its controlling browsing context is the current browsing context, its presentation connection state is notterminated, its presentation URL is equal to one of the presentation request URLs of presentationRequest and its presentation identifier is equal to presentationId. - If such a
PresentationConnectionexists, run the following steps:- Let S be that
PresentationConnection. - Resolve P with S.
- If the presentation connection state of S is
connectingorconnected, then abort all remaining steps. - Set the presentation connection state of S to
connecting. - Establish a presentation connection with S.
- Abort all remaining steps.
- Let S be that
- Search the set of controlled presentations for the first
PresentationConnectionthat meets the following criteria: its presentation connection state is notterminated, its presentation URL is equal to one of the presentation request URLs of presentationRequest, and its presentation identifier is equal to presentationId. - If such a
PresentationConnectionexists, let E be thatPresentationConnection, and run the following steps:- Create a new
PresentationConnectionS. - Set the presentation identifier of S to presentationId.
- Set the presentation URL of S to the presentation URL of E.
- Set the presentation connection state of S to
connecting. - Add S to the set of controlled presentations.
- Resolve P with S.
- Queue a task to fire a trusted event with the name
connectionavailable, that uses thePresentationConnectionAvailableEventinterface with theconnectionattribute initialized to S, at presentationRequest. The event must not bubble and cancelable and should have no default action. - Establish a presentation connection with S.
- Abort all remaining steps.
- Create a new
- Reject P with a
NotFoundErrorexception.