WebTransportSendStream: Methode getStats()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
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 des WebTransportSendStream-Interfaces gibt asynchron ein Objekt zurück, das Statistiken für den aktuellen Stream enthält.
Die Statistiken umfassen die Gesamtanzahl der in den Stream geschriebenen Bytes, die Anzahl, die gesendet wurden (ohne Netzwerk-Overhead zu berücksichtigen), und die Anzahl der Bytes, die mindestens einmal gesetzt wurden, sowie die Anzahl, die bestätigt wurden (bis zum ersten sequentiell geordneten nicht bestätigten Byte). Dies bietet somit ein Maß dafür, wie schnell die Anwendung Bytes an den Server in diesem speziellen Stream sendet.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise, der sich zu einem Objekt auflöst, das Statistiken über den aktuellen Stream enthält.
Das zurückgegebene Objekt hat die folgenden Eigenschaften:
bytesAcknowledged-
Eine positive ganze Zahl, die die Anzahl der Bytes angibt, die in diesen Stream geschrieben wurden und die als empfangen vom Server bestätigt wurden, unter Verwendung des QUIC-ACK-Mechanismus. Nur sequentielle Bytes bis, aber nicht einschließlich, des ersten nicht bestätigten Bytes werden gezählt. Diese Zahl kann nur steigen und ist immer kleiner oder gleich
bytesSent. Wenn die Verbindung über HTTP/2 erfolgt, wird der WertbytesSententsprechen. bytesSent-
Eine positive ganze Zahl, 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 steigen und ist immer kleiner oder gleich
bytesWritten. Beachten Sie, dass diese Zahl keine Bytes zählt, die als Netzwerk-Overhead (wie Paket-Header) gesendet werden. bytesWritten-
Eine positive ganze Zahl, die die Anzahl der Bytes angibt, die erfolgreich in diesen Stream geschrieben wurden. Diese Zahl kann nur steigen.
Beispiele
Der folgende Codeausschnitt verwendet await, um auf das Promise zu warten, das von getStats() zurückgegeben wird.
Wenn das Promise erfüllt ist, wird das Ergebnis für die Anzahl der Bytes, die gesendet, aber nicht bestätigt wurden, in der Konsole protokolliert.
const stats = await stream.getStats();
const bytesNotReceived = stats.bytesWritten - stats.bytesAcknowledged;
console.log(`Bytes still successfully sent: ${bytesNotReceived}`);
Spezifikationen
| Specification |
|---|
| WebTransport # dom-webtransportsendstream-getstats |