AbortSignal: phương thức tĩnh abort()

Baseline Widely available

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

Note: This feature is available in Web Workers.

Phương thức tĩnh AbortSignal.abort() trả về một AbortSignal đã được đặt sẵn ở trạng thái bị hủy, và tín hiệu này sẽ không kích hoạt sự kiện abort.

Đây là cách viết rút gọn của đoạn mã sau:

js
const controller = new AbortController();
controller.abort();
return controller.signal;

Ví dụ, bạn có thể truyền tín hiệu này vào một phương thức fetch để chạy logic hủy của nó. Điều này có thể hữu ích khi mã được tổ chức theo cách mà logic hủy vẫn nên được chạy ngay cả khi thao tác fetch dự định chưa bắt đầu.

Note: Phương thức này có mục đích tương tự Promise.reject.

Cú pháp

js
AbortSignal.abort()
AbortSignal.abort(reason)

Tham số

reason

Lý do khiến thao tác bị hủy, có thể là bất kỳ giá trị JavaScript nào. Nếu không được chỉ định, lý do sẽ được đặt thành DOMException "AbortError".

Giá trị trả về

Một thể hiện AbortSignal với thuộc tính AbortSignal.aborted được đặt thành true, và AbortSignal.reason được đặt thành giá trị lý do đã chỉ định hoặc giá trị mặc định.

Thông số kỹ thuật

Thông số kỹ thuật
DOM
# ref-for-dom-abortsignal-abort①

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