RTCPeerConnection.restartIce()

Category: JavaScript
Type: New or changed feature
Status: Enabled by default (Chrome 77)
Intent stage: Evaluate readiness to ship

Breaking change: No
Enterprise impact: None
Spec maturity: Incubation
Web Platform Tests: Yes

WPT details: https://cs.chromium.org/chromium/src/third_party/blink/web_tests/external/wpt/webrtc/RTCPeerConnection-restartIce.https.html https://wpt.fyi/results/webrtc/RTCPeerConnection-restartIce.https.html?label=master&label=experimental

Summary

Adds a method for triggering an ICE restart which causes a WebRTC connection to try to reconnect. This feature is already available in Chrome by passing the {iceRestart:true} argument to createOffer(). restartIce() is a version of this method that works regardless of signalingState.

Motivation

This is part of "Perfect Negotiation", which makes signaling in WebRTC race-free and less error-prone. For more details, see https://docs.google.com/presentation/d/1xcvf0udNeSH7s1FOY7RRqr1dEFvokZjn-MZPjwy3iXQ/edit?usp=sharing.

Standards & signals

Specification: https://w3c.github.io/webrtc-pc/#dom-rtcpeerconnection-restartice
Firefox: In development — Confirmed in a public W3C WebRTC WG meeting
Safari: No signal
Web developers: No signals
Tracking bug: https://bugs.chromium.org/p/chromium/issues/detail?id=980881

Ecosystem

Web Platform Tests: https://wpt.fyi/results/?q=webrtc%2FRTCPeerConnection-restartIce
Chrome Platform Showcase: https://chrome-platform-showcase.paulkinlan-ea.deno.net/features
GenDN reference: https://gendn.paulkinlan-ea.deno.net/features
chrome.dev demos search: https://www.google.com/search?q=site%3Achrome.dev+RTCPeerConnection.restartIce()
MDN Web Docs: https://developer.mozilla.org/en-US/search?q=RTCPeerConnection.restartIce()
Baseline status: https://webstatus.dev/?q=RTCPeerConnection.restartIce()

Explainers: https://docs.google.com/presentation/d/1xcvf0udNeSH7s1FOY7RRqr1dEFvokZjn-MZPjwy3iXQ/edit?usp=sharing

View on chromestatus.com