RTCIceCandidateStats.deleted

The RTCIceCandidateStats dictionary's deleted property indicates whether or not the candidate has been deleted or released.

Syntax

isDeleted = rtcIceCandidateStats.deleted;

Value

A Boolean value indicating whether or not the candidate has been deleted or released. If this value is true, the candidate described by the RTCIceCandidateStats object is no longer under consideration. dThe exact meaning varies depending on the type of candidate:

Local candidate

A value of true means the candidate has been deleted as described by RFC 5245: 8.3.

Host candidate

A value of true indicates that the candidate's network resources have been released. This generally mean sthat any associated socket(s) have been closed and released.

Remote (TURN) candidate

A value of true means the candidate's TURN allocation is no longer active.

The net result is the same; the candidate is no longer under consideration if this value is true.

Example

In this example, setInterval() is used to set up a function that runs periodically to display the latest statistics for candidates. Only candidates which have not been deleted are included in the output.

window.setInterval(function() {
  myPeerConnection.getStats(null).then(stats => {
    let statsOutput = "";

    stats.forEach(report => {
      if ((stats.type === "local-candidate" || stats.type === "remote.candidate") && !stats.deleted) {
        statsOutput += `<h2>Report: ${report.type}</h3>\n<strong>ID:</strong> ${report.id}<br>\n` +
                       `<strong>Timestamp:</strong> ${report.timestamp}<br>\n`;

        // Now the statistics for this report; we intentially drop the ones we
        // sorted to the top above

        Object.keys(report).forEach(statName => {
          if (statName !== "id" && statName !== "timestamp" && statName !== "type") {
            statsOutput += `<strong>${statName}:</strong> ${report[statName]}<br>\n`;
          }
        });
      }
    });

    document.querySelector(".stats-box").innerHTML = statsOutput;
  });
}, 1000);

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
deleted
No
No
No
No
?
12.1
No
No
No
?
12.2
No

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/RTCIceCandidateStats/deleted