WebTransport: 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 WebTransport Schnittstelle gibt asynchron ein Objekt zurück, das HTTP/3-Verbindungsstatistiken enthält.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise, das sich zu einem Objekt auflöst, das HTTP/3-Verbindungsstatistiken enthält. Das zurückgegebene Objekt kann die folgenden Eigenschaften/Statistiken haben:
timestamp-
Ein
DOMHighResTimeStamp, der den Zeitpunkt angibt, zu dem die Statistiken gesammelt wurden, relativ zum 1. Januar 1970, UTC. bytesSent-
Eine positive Ganzzahl, die die Anzahl der auf der QUIC-Verbindung gesendeten Bytes einschließlich erneuter Übertragungen angibt. Beachten Sie, dass diese Zählung keine zusätzlichen Daten aus von QUIC verwendeten Protokollen wie UDP oder anderen äußeren Rahmen enthält.
packetsSent-
Eine positive Ganzzahl, die die Anzahl der auf der QUIC-Verbindung gesendeten Pakete angibt, einschließlich derer, die als verloren bekannt sind.
packetsLost-
Eine positive Ganzzahl, die die Anzahl der auf der QUIC-Verbindung verlorenen Pakete angibt. Dieser Wert erhöht sich, wenn Pakete als verloren erklärt werden, und verringert sich, wenn sie später empfangen werden.
numOutgoingStreamsCreated-
Eine positive Ganzzahl, die die Anzahl der auf der QUIC-Verbindung erstellten ausgehenden QUIC-Streams angibt.
numIncomingStreamsCreated-
Eine positive Ganzzahl, die die Anzahl der auf der QUIC-Verbindung erstellten eingehenden QUIC-Streams angibt.
bytesReceived-
Eine positive Ganzzahl, die die Gesamtanzahl der auf der QUIC-Verbindung empfangenen Bytes angibt. Diese Zählung umfasst doppelte Daten von Streams, aber keine zusätzlichen Daten für von QUIC verwendete Protokolle wie UDP oder andere äußere Rahmen.
packetsReceived-
Eine positive Ganzzahl, die die Gesamtanzahl der auf der QUIC-Verbindung empfangenen Pakete angibt, einschließlich derer, die nicht verarbeitbar waren.
smoothedRtt-
Ein
DOMHighResTimeStamp, der die geglättete Round-Trip-Zeit (RTT) enthält, die derzeit auf der Verbindung beobachtet wird, berechnet als exponentiell gewichteter gleitender Durchschnitt der RTT-Beispiele eines Endpunkts unter Berücksichtigung von Bestätigungs-Verzögerungen. rttVariation-
Ein
DOMHighResTimeStamp, der die mittlere Variation in Round-Trip-Zeit-Beispielen enthält, die derzeit auf der Verbindung beobachtet wird. minRtt-
Ein
DOMHighResTimeStamp, der die minimale Round-Trip-Zeit auf der gesamten Verbindung enthält. datagrams-
Ein Objekt, das Statistiken zur Datagrammübertragung über die Verbindung enthält. Das Objekt hat die folgenden Eigenschaften:
timestamp-
Ein
DOMHighResTimeStamp, der den Zeitpunkt angibt, zu dem die Statistiken gesammelt wurden, relativ zum 1. Januar 1970, UTC. expiredOutgoing-
Eine positive Ganzzahl, die die Anzahl der Datagramme angibt, die aus der Sendewarteschlange entfernt wurden, weil sie abgelaufen sind. Beachten Sie, dass das maximale Alter, bevor ein Datagramm in der Sendewarteschlange abläuft, im
outgoingMaxAgezu finden ist. droppedIncoming-
Eine positive Ganzzahl, die die Anzahl der empfangenen Datagramme angibt, die verworfen wurden. Eingehende Datagramme werden verworfen, wenn die Anwendung sie nicht liest, bevor neue Datagramme die Empfangswarteschlange des
readablestream überlaufen. lostOutgoing-
Eine positive Ganzzahl, die die Anzahl der gesendeten Datagramme angibt, die als verloren erklärt wurden. Beachten Sie, dass ein Datagramm als verloren erklärt werden kann, wenn z. B. keine Bestätigung innerhalb einer Zeitüberschreitung eintraf oder eine Bestätigung für ein späteres Datagramm zuerst empfangen wurde.
Beispiele
Das folgende Beispiel verwendet await, um auf das Promise zu warten, das von getStats() zurückgegeben wird. Wenn das Versprechen erfüllt wird, wird das Ergebnis für die bytesSent Eigenschaft im Statistiken-Objekt in die Konsole protokolliert.
const stats = await transport.getStats();
console.log(`Bytes send: ${stats.bytesSent}`);
Spezifikationen
| Specification |
|---|
| WebTransport # dom-webtransport-getstats |
Browser-Kompatibilität
Loading…