WebTransportReceiveStream: getStats()-Methode
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 der WebTransportReceiveStream-Schnittstelle gibt asynchron ein Objekt zurück, das Statistiken für den aktuellen Stream enthält.
Die Statistiken umfassen die Gesamtzahl der geordneten Bytes, die in diesem Stream angekommen sind (unter Vernachlässigung des Netzwerk-Traffics, bis zum ersten fehlenden Byte) und die Gesamtzahl, die von der Anwendung gelesen wurden. Daher bietet es eine Messung dafür, wie schnell die Anwendung Bytes von dem Server in diesem speziellen Stream konsumiert.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise, das ein Objekt enthält, das Statistiken über den aktuellen Stream zurückgibt.
Das zurückgegebene Objekt hat die folgenden Eigenschaften:
timestamp-
Ein
DOMHighResTimeStamp, der den Zeitstempel angibt, zu dem die Statistiken erfasst wurden, relativ zum 1. Jan 1970, UTC. bytesReceived-
Eine positive Ganzzahl, die die Anzahl der Bytes angibt, die von diesem Stream empfangen wurden, bis zum ersten fehlenden Byte. Die Zahl beinhaltet keinen Netzwerk-Overhead und kann nur zunehmen.
bytesRead-
Eine positive Ganzzahl, die die Anzahl der Bytes angibt, die die Anwendung von diesem
WebTransportReceiveStream-Stream gelesen hat. Diese Zahl kann nur zunehmen und ist immer kleiner oder gleichbytesReceived.
Beispiele
Das folgende Codebeispiel verwendet await, um auf das von getStats() zurückgegebene Promise zu warten.
Wenn das Versprechen erfüllt ist, wird die Anzahl der noch nicht gelesenen Bytes 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 |