Baseline 2024
Newly available
A gatheringstatechange
event is sent to an RTCIceTransport
when its ICE candidate gathering state changes.
The gathering state, whose actual status can be found in the transport object's gatheringState
property, indicates whether or not the ICE agent has begun gathering candidates on this transport, and if so, if it has finished doing so.
This event is not cancelable and does not bubble.
SyntaxUse the event name in methods like addEventListener()
, or set an event handler property.
addEventListener("gatheringstatechange", (event) => { })
ongatheringstatechange = (event) => { }
Event type
A generic Event
.
This example creates a handler for gatheringstatechange
events on each RTCRtpSender
associated with a given RTCPeerConnection
. Here, the addEventListener()
method is called to add a listener for gatheringstatechange
events:
pc.getSenders().forEach((sender) => {
sender.transport.iceTransport.addEventListener(
"gatheringstatechange",
(ev) => {
let transport = ev.target;
if (transport.gatheringState === "complete") {
/* this transport has finished gathering candidates,
but others may still be working on it */
}
},
false,
);
});
Likewise, you can use the ongatheringstatechange
event handler property:
pc.getSenders().forEach((sender) => {
sender.transport.iceTransport.ongatheringstatechange = (ev) => {
let transport = ev.target;
if (transport.gatheringState === "complete") {
/* this transport has finished gathering candidates,
but others may still be working on it */
}
};
});
Specifications Browser compatibility See also
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.3