XMLHttpRequest: phương thức abort()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Note: This feature is available in Web Workers, except for Service Workers.

Phương thức XMLHttpRequest.abort() hủy bỏ yêu cầu nếu nó đã được gửi. Khi một yêu cầu bị hủy, readyState của nó được thay đổi thành XMLHttpRequest.UNSENT (0) và mã status của yêu cầu được đặt thành 0.

Nếu yêu cầu vẫn đang tiến hành (readyState không phải là XMLHttpRequest.DONE hoặc XMLHttpRequest.UNSENT), một sự kiện readystatechange, abort, và một sự kiện loadend được dispatch, theo thứ tự đó. Đối với yêu cầu đồng bộ, không có sự kiện nào được dispatch và một lỗi sẽ được ném thay thế.

Cú pháp

js
abort()

Tham số

Không có.

Giá trị trả về

Không có (undefined).

Ví dụ

Ví dụ này bắt đầu tải nội dung từ trang chủ MDN, sau đó do một số điều kiện, hủy quá trình truyền bằng cách gọi abort().

js
const xhr = new XMLHttpRequest();
const method = "GET";
const url = "https://mdn.go-mizu.dev/";
xhr.open(method, url, true);

xhr.send();

if (OH_NOES_WE_NEED_TO_CANCEL_RIGHT_NOW_OR_ELSE) {
  xhr.abort();
}

Các đặc tả kỹ thuật

Specification
XMLHttpRequest
# the-abort()-method

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

Xem thêm