XMLHttpRequestEventTarget: timeout event

Cú pháp

Dùng tên sự kiện trong các phương thức như addEventListener(), hoặc đặt một thuộc tính xử lý sự kiện.

addEventListener("timeout", (event) => { })

ontimeout = (event) => { }

Kiểu sự kiện

Một ProgressEvent. Kế thừa từ Event.

Thuộc tính sự kiện

Ngoài các thuộc tính được liệt kê bên dưới, các thuộc tính từ giao diện cha là Event cũng có sẵn.

lengthComputable Read only

Cờ boolean cho biết tổng lượng công việc cần làm và lượng công việc đã hoàn thành bởi tiến trình nền có thể tính được hay không. Nói cách khác, nó cho biết mức tiến triển có đo được hay không.

loaded Read only

Giá trị số nguyên không dấu 64 bit cho biết lượng công việc mà tiến trình nền đã thực hiện. Tỷ lệ công việc đã làm có thể được tính bằng cách chia giá trị thuộc tính này cho total. Khi tải một tài nguyên bằng HTTP, giá trị này chỉ tính phần thân của thông điệp HTTP, không gồm header và phần phụ trội khác.

total Read only

Giá trị số nguyên không dấu 64 bit biểu thị tổng lượng công việc mà tiến trình nền đang thực hiện. Khi tải một tài nguyên bằng HTTP, đây là Content-Length (kích thước phần thân của thông điệp), không gồm các header và phần phụ trội khác.

Ví dụ

Dùng với XMLHttpRequest

const client = new XMLHttpRequest();
client.open("GET", "http://www.example.org/example.txt");
client.ontimeout = () => {
  console.error("Timeout!!");
};

client.send();

Bạn cũng có thể thiết lập bộ xử lý sự kiện bằng phương thức addEventListener():

client.addEventListener("timeout", () => {
  console.error("Timeout!!");
});

Dùng với XMLHttpRequestUpload

Bạn có thể dùng sự kiện timeout để phát hiện một lượt tải lên bị dừng vì quá chậm. Để xem ví dụ mã đầy đủ tải lên tệp và hiển thị thanh tiến trình, hãy xem trang XMLHttpRequestUpload chính.

Thời gian chờ được đặt trên đối tượng XMLHttpRequest bằng thuộc tính XMLHttpRequest.timeout.

// Trong trường hợp timeout, chúng ta ẩn thanh tiến trình
// Lưu ý rằng sự kiện này cũng có thể được lắng nghe trên đối tượng xhr
function errorAction(event) {
  progressBar.classList.remove("visible");
  log.textContent = `Upload failed: ${event.type}`;
}
xhr.upload.addEventListener("timeout", errorAction);

Thông số kỹ thuật

Tương thích trình duyệt

api.XMLHttpRequest.timeout_event

api.XMLHttpRequestUpload.timeout_event

Xem thêm

• Các sự kiện liên quan: loadstart, load, loadend, progress, error, abort
• Giám sát tiến trình