ReadableStreamBYOBReader: phương thức releaseLock()

Baseline 2026 *
Newly available

Since March 2026, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

* Some parts of this feature may have varying levels of support.

Note: This feature is available in Web Workers.

Phương thức releaseLock() của giao diện ReadableStreamBYOBReader giải phóng khóa của reader trên stream. Sau khi khóa được giải phóng, reader không còn hoạt động nữa.

Reader sẽ xuất hiện lỗi nếu stream liên quan gặp lỗi khi khóa được giải phóng; ngược lại, reader sẽ xuất hiện trạng thái đóng.

Nếu khóa của reader được giải phóng trong khi vẫn còn các yêu cầu đọc đang chờ, các promise được trả về bởi phương thức ReadableStreamBYOBReader.read() của reader sẽ bị từ chối ngay lập tức với TypeError. Các chunk chưa đọc vẫn còn trong hàng đợi nội bộ của stream và có thể được đọc sau bằng cách lấy một reader mới.

Cú pháp

js
releaseLock()

Tham số

Không có.

Giá trị trả về

Không có (undefined).

Ngoại lệ

TypeError

Được ném ra nếu đối tượng nguồn không phải là ReadableStreamBYOBReader.

Ví dụ

Ví dụ đơn giản dưới đây được hiển thị. Khóa được tạo ngay khi reader được tạo trên stream.

js
const reader = stream.getReader({ mode: "byob" });
reader.releaseLock();

Thông số kỹ thuật

Thông số kỹ thuật
Streams
# ref-for-byob-reader-release-lock②

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

Xem thêm