WebTransportReceiveStream: phương thức getStats()
Limited availability
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 WebTransportReceiveStream trả về bất đồng bộ một đối tượng chứa các số liệu thống kê cho luồng hiện tại.
Các số liệu thống kê bao gồm tổng số byte có thứ tự đã đến trên luồng này (bỏ qua overhead mạng, cho đến byte đầu tiên còn thiếu) và tổng số byte đã được ứng dụng đọc. Do đó, nó cung cấp thước đo tốc độ ứng dụng đang sử dụng byte từ máy chủ trên luồng cụ thể này.
Cú pháp
getStats()
Tham số
Không có.
Giá trị trả về
Một Promise phân giải thành một đối tượng chứa số liệu thống kê về luồng hiện tại. Đối tượng trả về có các thuộc tính sau:
timestamp-
Một
DOMHighResTimeStampcho biết thời điểm thu thập số liệu thống kê, tính từ ngày 1 tháng 1 năm 1970 theo UTC. bytesReceived-
Một số nguyên dương cho biết số byte đã nhận bởi luồng này, cho đến byte đầu tiên còn thiếu. Con số này không bao gồm overhead mạng và chỉ có thể tăng.
bytesRead-
Một số nguyên dương cho biết số byte mà ứng dụng đã đọc từ luồng
WebTransportReceiveStreamnày. Con số này chỉ có thể tăng và luôn nhỏ hơn hoặc bằngbytesReceived.
Ví dụ
Đoạn mã dưới đây sử dụng await để chờ Promise được trả về bởi getStats(). Khi promise được thực hiện, số byte chưa được đọc sẽ được ghi vào bảng điều khiển.
const stats = await stream.getStats();
const unConsumedBytes = stats.bytesReceived - stats.bytesRead;
console.log(`Bytes in reader queue: ${unConsumedBytes}`);
Thông số kỹ thuật
| Specification |
|---|
| WebTransport # dom-webtransportreceivestream-getstats |