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 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.

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

js
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 gleich bytesReceived.

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.

js
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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
getStats
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support
Experimental. Expect behavior to change in the future.
User must explicitly enable this feature.