{"json_modified": "2016-05-11T18:54:25.181739", "uuid": "2e48e0f2-2e4d-4c72-a63d-9a64702a6a78", "title": "RTCPeerConnection.onsignalingstatechange", "url": "/en-US/docs/Web/API/RTCPeerConnection/onsignalingstatechange", "tags": ["Event Handler", "Property", "WebRTC", "Reference", "RTCPeerConnection", "Experimental", "onsignalingstatechange"], "translations": [], "modified": "2016-05-11T18:54:25", "label": "RTCPeerConnection.onsignalingstatechange", "localization_tags": [], "locale": "en-US", "id": 124477, "last_edit": "2016-05-11T18:54:20", "summary": "The <code><strong>RTCPeerConnection.onsignalingstatechange</strong></code> property is an <a href=\"/en-US/docs/Web/API/EventHandler\" title=\"A possible way to get notified of Events of a particular type (such as click) for a given object is to specify an&#xA0;event handler using:\"><code>EventHandler</code></a> which specifies a function to be called when the <code><a href=\"/en-US/docs/Web/Events/signalingstatechange\" title=\"/en-US/docs/Web/Events/signalingstatechange\">signalingstatechange</a></code> event occurs on an <a href=\"/en-US/docs/Web/API/RTCPeerConnection\" title=\"The RTCPeerConnection interface represents a WebRTC connection between the local computer and a remote peer. It provides methods to connect to a remote peer, maintain and monitor the connection, and close the connection once it's no longer needed.\"><code>RTCPeerConnection</code></a> interface. The function receives as input the event object, of type <a href=\"/en-US/docs/Web/API/Event\" title=\"The Event interface represents any event of the DOM. It contains common properties and methods to any event.\"><code>Event</code></a>; this event is sent when the value of <a href=\"/en-US/docs/Web/API/RTCPeerConnection/signalingState\" title=\"The read-only signalingState property on the RTCPeerConnection interface returns one of the string values specified by the RTCSignalingState enum; these values describe the state of the signaling process on the local end of the connection while connecting or reconnecting to another peer. See &quot;Signaling&quot; in Lifetime of a WebRTC session for more details about the signaling process.\"><code>RTCPeerConnection.signalingState</code></a> changes, as the result of a call to either <a href=\"/en-US/docs/Web/API/RTCPeerConnection/setLocalDescription\" title=\"The RTCPeerConnection.setLocalDescription() method changes the local description associated with the connection. This description specifies the properties of the local end of the connection, including the media format. The actual connection is affected by this change, so it must be able to support both the old and new descriptions in order for the change to actually take place. The method takes a single parameter&#x2014;the session description&#x2014;and it returns a Promise which is fulfilled once the description has been changed, asynchronously.\"><code>setLocalDescription()</code></a> or <a href=\"/en-US/docs/Web/API/RTCPeerConnection/setRemoteDescription\" title=\"The RTCPeerConnection.setRemoteDescription() method changes the remote description associated with the connection. This description specifies the properties of the remote end of the connection, including the media format. The actual connection is affected by this change, so it must be able to support both the old and new descriptions in order for the change to actually take place. The method takes a single parameter&#x2014;the session description&#x2014;and it returns a Promise which is fulfilled once the description has been changed, asynchronously.\"><code>setRemoteDescription()</code></a>.", "sections": [{"id": "Quick_Links", "title": null}, {"id": "Syntax", "title": "Syntax"}, {"id": "Value", "title": "Value"}, {"id": "Example", "title": "Example"}, {"id": "Specifications", "title": "Specifications"}, {"id": "Browser_compatibility", "title": "Browser compatibility"}, {"id": "See_also", "title": "See also"}], "slug": "Web/API/RTCPeerConnection/onsignalingstatechange", "review_tags": ["technical"]}