WebTransport: phương thức getStats()
Khả dụng hạn chế
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Web Workers.
Phương thức getStats() của giao diện WebTransport trả về bất đồng bộ một object chứa thống kê kết nối HTTP/3.
Cú pháp
getStats()
Tham số
Không có.
Giá trị trả về
Một Promise được giải quyết thành một object chứa thống kê kết nối HTTP/3.
Object được trả về có thể có các thuộc tính/thống kê sau:
timestamp-
Một
DOMHighResTimeStampcho biết dấu thời gian tại đó thống kê được thu thập, tính từ 1/1/1970 UTC. bytesSent-
Một số nguyên dương cho biết số byte đã gửi trên kết nối QUIC, bao gồm cả truyền lại. Lưu ý rằng con số này không bao gồm dữ liệu bổ sung từ các giao thức được QUIC dùng, như UDP, hoặc bất kỳ lớp bao ngoài nào khác.
packetsSent-
Một số nguyên dương cho biết số gói tin đã gửi trên kết nối QUIC, bao gồm cả những gói được biết là đã bị mất.
packetsLost-
Một số nguyên dương cho biết số gói tin bị mất trên kết nối QUIC. Giá trị này sẽ tăng khi gói được xác định là mất, và giảm nếu sau đó chúng được nhận.
numOutgoingStreamsCreated-
Một số nguyên dương cho biết số luồng đi ra đã được tạo trên kết nối QUIC.
numIncomingStreamsCreated-
Một số nguyên dương cho biết số luồng đi vào đã được tạo trên kết nối QUIC.
bytesReceived-
Một số nguyên dương cho biết tổng số byte đã nhận trên kết nối QUIC. Con số này bao gồm dữ liệu trùng lặp từ các luồng, nhưng không bao gồm dữ liệu bổ sung cho các giao thức được QUIC dùng, như UDP, hoặc bất kỳ lớp bao ngoài nào khác.
packetsReceived-
Một số nguyên dương cho biết tổng số gói tin đã nhận trên kết nối QUIC, bao gồm cả các gói không thể xử lý.
smoothedRtt-
Một
DOMHighResTimeStampchứa thời gian khứ hồi (RTT) đã làm mượt hiện quan sát được trên kết nối, được tính như một trung bình động có trọng số theo hàm mũ của các mẫu RTT từ đầu cuối sau khi tính đến độ trễ xác nhận. rttVariation-
Một
DOMHighResTimeStampchứa độ biến thiên trung bình của các mẫu thời gian khứ hồi hiện quan sát được trên kết nối. minRtt-
Một
DOMHighResTimeStampchứa thời gian khứ hồi tối thiểu quan sát được trên toàn bộ kết nối. datagrams-
Một object chứa thống kê cho việc truyền datagram qua kết nối. Object này có các thuộc tính sau:
timestamp-
Một
DOMHighResTimeStampcho biết dấu thời gian tại đó thống kê được thu thập, tính từ 1/1/1970 UTC. expiredOutgoing-
Một số nguyên dương cho biết số datagram bị loại khỏi hàng đợi gửi vì đã hết hạn. Lưu ý rằng tuổi tối đa trước khi một datagram trong hàng đợi gửi hết hạn có thể được tìm thấy trong
outgoingMaxAge. droppedIncoming-
Một số nguyên dương cho biết số datagram đến bị bỏ. Datagram đến bị bỏ nếu ứng dụng không đọc chúng trước khi datagram mới làm tràn hàng đợi nhận của
readablestream. lostOutgoing-
Một số nguyên dương cho biết số datagram đã gửi bị xác định là mất. Lưu ý rằng một datagram có thể bị xem là mất nếu, ví dụ, không có xác nhận nào đến trong một khoảng thời gian chờ, hoặc một xác nhận cho datagram sau đó đã được nhận trước.
Ví dụ
Ví dụ dưới đây dùng await để chờ promise do getStats() trả về.
Khi promise được giải quyết, kết quả của thuộc tính bytesSent trong object thống kê được ghi ra console.
const stats = await transport.getStats();
console.log(`Bytes đã gửi: ${stats.bytesSent}`);
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| WebTransport # dom-webtransport-getstats |