WebTransportSendGroup: getStats() Methode
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die getStats() Methode der WebTransportSendGroup-Schnittstelle gibt ein Promise zurück, das sich zu einem Objekt auflöst, das Statistiken enthält, die über alle derzeit mit dieser Gruppe verbundenen WebTransportSendStream- und WebTransportDatagramsWritable-Objekte aggregiert werden.
Das heißt, jeder Stream und jedes Datagramm, dessen sendGroup auf diese WebTransportSendGroup gesetzt ist.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise, das sich zu einem Objekt auflöst, das aggregierte Statistiken für die Mitglieder der Gruppe enthält.
Das zurückgegebene Objekt hat die folgenden Eigenschaften:
bytesAcknowledged-
Eine positive Ganzzahl, die die Anzahl der Bytes angibt, die an die Mitglieder der Gruppe geschrieben, gesendet und vom Server als empfangen bestätigt wurden, unter Verwendung des QUIC-ACK-Mechanismus. Nur aufeinanderfolgende Bytes bis, aber nicht einschließlich, dem ersten nicht bestätigten Byte jedes Mitglieds werden gezählt. Diese Zahl kann nur steigen und ist immer kleiner oder gleich
bytesSent. bytesSent-
Eine positive Ganzzahl, die angibt, wie viele Bytes mindestens einmal (aber nicht unbedingt bestätigt) an die Mitglieder der Gruppe gesendet wurden. Diese Zahl kann nur steigen und ist immer kleiner oder gleich
bytesWritten. Beachten Sie, dass diese Zählung keine Bytes umfasst, die als Netzwerk-Overhead gesendet wurden (wie Paket-Header). bytesWritten-
Eine positive Ganzzahl, die die Anzahl der Bytes angibt, die erfolgreich an die Mitglieder der Gruppe geschrieben wurden. Diese Zahl kann nur steigen.
Beispiele
Grundlegende Verwendung
Der folgende Codeausschnitt verwendet await, um auf das von getStats() zurückgegebene Promise zu warten, und gibt dann die Anzahl der Bytes aus, die über die Mitglieder der Gruppe gesendet, aber noch nicht bestätigt wurden:
const stats = await sendGroup.getStats();
const bytesNotAcknowledged = stats.bytesSent - stats.bytesAcknowledged;
console.log(`Bytes sent but not yet acknowledged: ${bytesNotAcknowledged}`);
Spezifikationen
| Spezifikation |
|---|
| WebTransport # dom-webtransportsendgroup-getstats |