DasRTCDataChannelStats-Wörterbuch derWebRTC API liefert Statistiken, die mit einemRTCDataChannel-Objekt auf der Verbindung in Zusammenhang stehen.

Der Bericht kann erhalten werden, indem derRTCStatsReport itereiert wird, der vonRTCPeerConnection.getStats() zurückgegeben wird, bis Sie einen Eintrag mit demtypedata-channel finden.

Die Datenkanalstatistiken können einem bestimmten Kanal zugeordnet werden, indem diedataChannelIdentifier-Eigenschaft mit einer passendenRTCDataChannel.id verglichen wird.

Instanz-Eigenschaften

bytesSentOptional

Ein positiver Ganzzahlwert, der die Gesamtanzahl der Nutzlast-Bytes angibt, die über den zugehörigenRTCDataChannel gesendet wurden.

bytesReceivedOptional

Ein positiver Ganzzahlwert, der die Gesamtanzahl der Nutzlast-Bytes angibt, die über den zugehörigenRTCDataChannel empfangen wurden.

dataChannelIdentifierOptional

Ein positiver Ganzzahlwert, der dieid des zugehörigenRTCDataChannel enthält.

labelOptional

Ein String, der daslabel des zugehörigenRTCDataChannel enthält.

messagesReceivedOptional

Ein positiver Ganzzahlwert, der die Gesamtanzahl dermessage events angibt, die für empfangene Nachrichten auf dem zugehörigenRTCDataChannel ausgelöst wurden.

messagesSentOptional

Ein positiver Ganzzahlwert, der die Gesamtanzahl dermessage events angibt, die für gesendete Nachrichten auf dem Kanal ausgelöst wurden.

protocolOptional

Ein String, der dasprotocol des zugehörigenRTCDataChannel enthält.

state

DerreadyState des zugehörigenRTCDataChannel.

Gemeinsame Instanz-Eigenschaften

Die folgenden Eigenschaften sind allen WebRTC-Statistikobjekten gemeinsam (sieheRTCStatsReport für weitere Informationen).

id

Ein String, der das Objekt eindeutig identifiziert, das überwacht wird, um diesen Satz von Statistiken zu erzeugen.

timestamp

EinDOMHighResTimeStamp-Objekt, das den Zeitpunkt angibt, zu dem die Probe für dieses Statistikobjekt entnommen wurde.

type

Ein String mit dem Wert"data-channel", der den Typ der Statistiken angibt, den das Objekt enthält.

Beispiele

Gegeben sei eine VariablemyPeerConnection, die eine Instanz vonRTCPeerConnection ist. Der nachfolgende Code verwendetawait, um auf den Statistikbericht zu warten, und durchläuft ihn dann mitRTCStatsReport.forEach().Er filtert die Wörterbücher heraus, die nur Berichte vom Typdata-channel haben, und protokolliert das Ergebnis.

const stats = await myPeerConnection.getStats();stats.forEach((report) => {  if (report.type === "data-channel") {    // Log the channel information    console.log(report);  }});

Spezifikationen

Browser-Kompatibilität