WritableStreamDefaultWriter: abort() method
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since May 2022.
Note: This feature is available in Web Workers.
abort() của giao diện WritableStreamDefaultWriter hủy luồng, báo hiệu rằng bộ sinh dữ liệu không còn có thể ghi thành công vào luồng nữa và luồng sẽ ngay lập tức được chuyển sang trạng thái lỗi, với mọi thao tác ghi đang chờ sẽ bị loại bỏ.
Nếu trình ghi đang hoạt động, phương thức abort() sẽ hoạt động giống như trên luồng liên kết
(WritableStream.abort()). Nếu không, nó trả về một promise bị từ chối.
Cú pháp
abort()
abort(reason)
Tham số
reasonOptional-
Một chuỗi biểu thị lý do hủy theo cách dễ đọc cho con người.
Giá trị trả về
Một Promise, được hoàn tất với undefined khi luồng bị hủy, hoặc
bị từ chối với lỗi nếu trình ghi không hoạt động hoặc luồng nhận không hợp lệ.
Ngoại lệ
TypeError-
Luồng bạn đang cố hủy không phải là
WritableStream, hoặc nó đang bị khóa.
Ví dụ
const writableStream = new WritableStream(
{
write(chunk) {
// …
},
close() {
// …
},
abort(err) {
// …
},
},
queuingStrategy,
);
// …
const writer = writableStream.getWriter();
// …
// abort the stream when desired
await writer.abort("WritableStream aborted. Reason: ...");
Thông số kỹ thuật
| Specification |
|---|
| Streams # ref-for-default-writer-abort④ |