WebTransportSendStream: Methode getStats()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
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.
Die getStats()-Methode der Schnittstelle WebTransportSendStream gibt asynchron ein Objekt zurück, das Statistiken für den aktuellen Stream enthält.
Die Statistiken umfassen die Gesamtzahl der in den Stream geschriebenen Bytes, die Anzahl der gesendeten Bytes (ohne Paket-Overhead) und die Anzahl der Bytes, die mindestens einmal gesendet wurden, sowie die Anzahl der bestätigten Bytes (bis zum ersten in Reihenfolge nicht bestätigten Byte). Sie bietet daher eine Messung, wie schnell die Anwendung Bytes zu diesem bestimmten Stream an den Server sendet.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise, das zu einem Objekt aufgelöst wird, das Statistiken über den aktuellen Stream enthält.
Das zurückgegebene Objekt hat die folgenden Eigenschaften:
bytesAcknowledged-
Eine positive Ganzzahl, die die Anzahl der Bytes angibt, die in diesen Stream geschrieben wurden und die vom Server als empfangen bestätigt wurden, unter Verwendung von QUICs ACK-Mechanismus. Nur sequentielle Bytes bis, aber ohne das erste nicht bestätigte Byte, werden gezählt. Diese Zahl kann nur zunehmen und ist immer kleiner oder gleich
bytesSent. Wenn die Verbindung über HTTP/2 läuft, entspricht der WertbytesSent. bytesSent-
Eine positive Ganzzahl, die die Anzahl der Bytes angibt, die in diesen Stream geschrieben und mindestens einmal gesendet wurden (aber nicht unbedingt bestätigt). Diese Zahl kann nur zunehmen und ist immer kleiner oder gleich
bytesWritten. Beachten Sie, dass diese Zählung keine als Netzwerk-Overhead gesendeten Bytes (wie Paket-Header) beinhaltet. bytesWritten-
Eine positive Ganzzahl, die die Anzahl der erfolgreich in diesen Stream geschriebenen Bytes angibt. Diese Zahl kann nur zunehmen.
Beispiele
Der untenstehende Codeausschnitt verwendet await, um auf das vom getStats() zurückgegebene Promise zu warten.
Wenn das Promise erfüllt wird, wird die Anzahl der gesendeten, aber nicht bestätigten Bytes im Konsolenprotokoll aufgezeichnet.
const stats = await stream.getStats();
const bytesNotReceived = stats.bytesWritten - stats.bytesAcknowledged;
console.log(`Bytes still successfully sent: ${bytesNotReceived}`);
Spezifikationen
| Specification |
|---|
| WebTransport # dom-webtransportsendstream-getstats |