ReadableByteStreamController

Giao diện ReadableByteStreamController của Streams API đại diện cho controller của một readable byte stream. Nó cho phép kiểm soát trạng thái và hàng đợi nội bộ của ReadableStream với nguồn byte bên dưới, đồng thời cho phép truyền zero-copy hiệu quả từ nguồn bên dưới đến consumer khi hàng đợi nội bộ của stream rỗng.

Một đối tượng của loại controller này được tạo nếu một đối tượng underlyingSource với thuộc tính type="bytes" được truyền làm đối số cho hàm khởi tạo ReadableStream(). Đối tượng underlyingSource cũng có thể định nghĩa các hàm callback start() và pull(). Các hàm này được gọi với controller làm tham số, để thiết lập nguồn bên dưới và yêu cầu dữ liệu khi cần.

Nguồn bên dưới dùng controller để cung cấp dữ liệu cho stream thông qua thuộc tính byobRequest hoặc phương thức enqueue(). byobRequest là đối tượng ReadableStreamBYOBRequest đại diện cho yêu cầu đang chờ từ consumer để thực hiện truyền zero-copy trực tiếp đến consumer. byobRequest phải được dùng để sao chép dữ liệu nếu nó tồn tại (đừng dùng enqueue() trong trường hợp này)! Nếu nguồn bên dưới cần truyền dữ liệu cho stream và byobRequest là null, nguồn có thể gọi enqueue() để thêm dữ liệu vào các hàng đợi nội bộ của stream.

Lưu ý rằng byobRequest chỉ được tạo trong "chế độ BYOB" khi có yêu cầu từ reader và hàng đợi nội bộ của stream rỗng. "Chế độ BYOB" được bật khi dùng ReadableStreamBYOBReader (thường được tạo bằng cách gọi ReadableStream.getReader() với đối số { mode: 'byob' }). Nó cũng được bật khi dùng reader mặc định và autoAllocateChunkSize được chỉ định trong hàm khởi tạo ReadableStream().

Nguồn byte bên dưới cũng có thể dùng controller để đóng() stream khi tất cả dữ liệu đã được gửi và báo cáo lỗi từ nguồn bên dưới bằng error(). Thuộc tính desiredSize của controller được dùng để áp dụng "backpressure", thông báo cho nguồn bên dưới về kích thước của hàng đợi nội bộ (các giá trị nhỏ chỉ ra rằng hàng đợi đang đầy, gợi ý cho nguồn bên dưới rằng nên tạm dừng hoặc giới hạn lượng dữ liệu đầu vào).