WebTransportReceiveStream: 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 WebTransportReceiveStream-Schnittstelle gibt asynchron ein Objekt mit Statistiken für den aktuellen Stream zurück.
Die Statistiken beinhalten die Gesamtzahl der geordneten Bytes, die auf diesem Stream eingetroffen sind (ohne Netzwerk-Overhead, bis zum ersten fehlenden Byte) und die Gesamtzahl, die von der Anwendung gelesen wurde. Dadurch wird gemessen, wie schnell die Anwendung Bytes von dem Server auf diesem speziellen Stream konsumiert.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise, das sich in ein Objekt auflöst, das Statistiken über den aktuellen Stream enthält. Das zurückgegebene Objekt hat folgende 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 bis zum ersten fehlenden Byte von diesem Stream empfangen wurden. Die Zahl beinhaltet 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 als oder gleichbytesReceived.
Beispiele
Der folgende Codeausschnitt verwendet await, um auf das Promise zu warten, das von getStats() zurückgegeben wird. Wenn das Versprechen erfüllt ist, wird die Anzahl der Bytes, die noch nicht gelesen wurden, in der 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 |