12. Event summary

This section is non-normative.

The following events fire on RTCDataChannel objects:

Event name	Interface	Fired when…
`open`	`Event`	The `RTCDataChannel` object’s underlying data transport has been established (or re-established).
`message`	`MessageEvent` [html]	A message was successfully received.
`bufferedamountlow`	`Event`	The `RTCDataChannel` object’s `bufferedAmount` decreases from above its `bufferedAmountLowThreshold` to less than or equal to its `bufferedAmountLowThreshold`.
`error`	`RTCErrorEvent`	An error occurred on the data channel.
`closing`	`Event`	The `RTCDataChannel` object transitions to the “`closing`“ state
`close`	`Event`	The `RTCDataChannel` object’s underlying data transport has been closed.

The following events fire on RTCPeerConnection objects:

Event name	Interface	Fired when…
`track`	`RTCTrackEvent`	New incoming media has been negotiated for a specific `RTCRtpReceiver`, and that receiver’s `track` has been added to any associated remote `MediaStream`s.
`negotiationneeded`	`Event`	The browser wishes to inform the application that session negotiation needs to be done (i.e. a createOffer call followed by setLocalDescription).
`signalingstatechange`	`Event`	The signaling state has changed. This state change is the result of either `setLocalDescription` or `setRemoteDescription` being invoked.
`iceconnectionstatechange`	`Event`	The `RTCPeerConnection`‘s ICE connection state has changed.
`icegatheringstatechange`	`Event`	The `RTCPeerConnection`‘s ICE gathering state has changed.
`icecandidate`	`RTCPeerConnectionIceEvent`	A new `RTCIceCandidate` is made available to the script.
`connectionstatechange`	`Event`	The `RTCPeerConnection`.`connectionState` has changed.
`icecandidateerror`	`RTCPeerConnectionIceErrorEvent`	A failure occured when gathering ICE candidates.
datachannel	`RTCDataChannelEvent`	A new `RTCDataChannel` is dispatched to the script in response to the other peer creating a channel.

The following events fire on RTCDTMFSender objects:

Event name	Interface	Fired when…
`tonechange`	`RTCDTMFToneChangeEvent`	The `RTCDTMFSender` object has either just begun playout of a tone (returned as the `tone` attribute) or just ended the playout of tones in the `toneBuffer` (returned as an empty value in the `tone` attribute).

The following events fire on RTCIceTransport objects:

Event name	Interface	Fired when…
`statechange`	`Event`	The `RTCIceTransport` state changes.
`gatheringstatechange`	`Event`	The `RTCIceTransport` gathering state changes.
`selectedcandidatepairchange`	`Event`	The `RTCIceTransport`‘s selected candidate pair changes.

The following events fire on RTCDtlsTransport objects:

Event name	Interface	Fired when…
`statechange`	`Event`	The `RTCDtlsTransport` state changes.
`error`	`RTCErrorEvent`	An error occurred on the `RTCDtlsTransport` (either “`dtls-failure`“ or “`fingerprint-failure`“).

The following events fire on RTCSctpTransport objects:

Event name	Interface	Fired when…
`statechange`	`Event`	The `RTCSctpTransport` state changes.