WebTransportSendStream: getStats() Methode
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 WebTransportSendStream-Schnittstelle gibt asynchron ein Objekt zurück, das Statistiken für den aktuellen Stream enthält.
Die Statistiken umfassen die Gesamtanzahl der Bytes, die in den Stream geschrieben wurden, die Anzahl der gesendeten Bytes (ohne Paket-Overhead) sowie die Anzahl der Bytes, die mindestens einmal gesetzt wurden, und die Anzahl der bestätigten Bytes (bis zum ersten sequenziell geordneten, nicht bestätigten Byte). Daher bietet sie eine Maßnahme dafür, wie schnell die Anwendung Bytes über diesen bestimmten Stream an den Server sendet.
Syntax
getStats()
Parameter
Keine.
Rückgabewert
Ein Promise, das zu einem Objekt aufgelöst wird, das Statistiken über den aktuellen Stream enthält.
Das zurückgegebene Objekt hat die folgenden Eigenschaften:
bytesAcknowledged-
Eine positive ganze Zahl, die die Anzahl der Bytes angibt, die in diesen Stream geschrieben, gesendet und vom Server als empfangen bestätigt wurden, unter Verwendung von QUICs ACK-Mechanismus. Es werden nur sequenzielle Bytes bis einschließlich des ersten nicht bestätigten Bytes gezählt. Diese Zahl kann nur steigen und ist immer kleiner oder gleich
bytesSent. Wenn die Verbindung über HTTP/2 erfolgt, entspricht der WertbytesSent. bytesSent-
Eine positive ganze Zahl, die die Anzahl der Bytes angibt, die in diesen Stream geschrieben und mindestens einmal gesendet wurden (aber nicht unbedingt bestätigt). Diese Zahl kann nur steigen und ist immer kleiner oder gleich
bytesWritten. Beachten Sie, dass diese Zählung keine Bytes umfasst, die als Netzwerk-Overhead gesendet werden (z. B. Paket-Header). bytesWritten-
Eine positive ganze Zahl, die die Anzahl der Bytes angibt, die erfolgreich in diesen Stream geschrieben wurden. Diese Zahl kann nur steigen.
Beispiele
Der folgende Code-Schnipsel 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 Anzahl der gesendeten, aber nicht bestätigten Bytes in die Konsole protokolliert.
const stats = await stream.getStats();
const bytesNotReceived = stats.bytesWritten - stats.bytesAcknowledged;
console.log(`Bytes still successfully sent: ${bytesNotReceived}`);
Spezifikationen
| Specification |
|---|
| WebTransport # dom-webtransportsendstream-getstats |
Browser-Kompatibilität
BCD tables only load in the browser