WebTransportReceiveStream: getStats()-Methode
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, bevor Sie diese produktiv verwenden.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die getStats()
-Methode der WebTransportReceiveStream
-Schnittstelle gibt asynchron ein Objekt mit Statistiken für den aktuellen Stream zurück.
Zu den Statistiken gehören die Gesamtzahl der geordneten Bytes, die auf diesem Stream angekommen sind (ohne Berücksichtigung des Netzwerk-Overheads, bis zum ersten fehlenden Byte) und die Gesamtzahl, die von der Anwendung gelesen wurden. Sie bietet somit ein Maß dafür, wie schnell die Anwendung Bytes vom Server auf diesem bestimmten Stream konsumiert.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise
, das sich zu einem Objekt auflöst, das Statistiken über den aktuellen Stream enthält. Das zurückgegebene Objekt hat die folgenden Eigenschaften:
timestamp
-
Ein
DOMHighResTimeStamp
, das den Zeitpunkt angibt, zu dem die Statistiken erfasst wurden, relativ zum 1. Januar 1970, UTC. bytesReceived
-
Eine positive ganze Zahl, die die Anzahl der Bytes angibt, die von diesem Stream bis zum ersten fehlenden Byte empfangen wurden. Die Zahl umfasst keinen Netzwerk-Overhead und kann nur steigen.
bytesRead
-
Eine positive ganze Zahl, die die Anzahl der Bytes angibt, die die Anwendung aus diesem
WebTransportReceiveStream
-Stream gelesen hat. Diese Zahl kann nur steigen und ist immer kleiner oder gleichbytesReceived
.
Beispiele
Der folgende Codeausschnitt verwendet await
, um auf das von getStats()
zurückgegebene Promise
zu warten. Wenn das Versprechen erfüllt wird, wird die Anzahl der Bytes, die noch nicht gelesen wurden, in die Konsole protokolliert.
const stats = await stream.getStats();
const unConsumedBytes = stats.bytesReceived - stats.bytesRead;
console.log(`Bytes in reader queue: ${unConsumedBytes}`);
Spezifikationen
Specification |
---|
WebTransport # dom-webtransportreceivestream-getstats |
Browser-Kompatibilität
BCD tables only load in the browser