ReadableByteStreamController: phương thức enqueue()

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.

Note: This feature is available in Web Workers.

Phương thức enqueue() của giao diện ReadableByteStreamController xếp hàng một chunk đã cho trong readable byte stream liên quan (chunk được chuyển vào các hàng đợi nội bộ của stream).

Chỉ nên dùng phương thức này để truyền dữ liệu vào hàng đợi khi byobRequest là null.

Cú pháp

enqueue(chunk)

Ngoại lệ

TypeError: Được ném ra nếu đối tượng nguồn không phải là ReadableByteStreamController, hoặc stream không thể đọc vì lý do nào đó, hoặc chunk không phải là đối tượng, hoặc array buffer nội bộ của chunk không tồn tại, có độ dài bằng không, hoặc đã bị tách ra. Nó cũng được ném ra nếu stream đã được đóng.

Ví dụ trong Sử dụng readable byte streams > Tạo readable socket push byte stream cho thấy cách bạn có thể dùng enqueue() để sao chép dữ liệu vào stream nếu không có byobRequest nào đang chờ. Nếu có byobRequest thì nên sử dụng nó!

Mã dưới đây cho thấy dữ liệu được đọc vào một ArrayBuffer bằng cách dùng phương thức socket.readInto() "giả định" và sau đó được xếp hàng (nhưng chỉ khi dữ liệu thực sự được sao chép):

const buffer = new ArrayBuffer(DEFAULT_CHUNK_SIZE);
bytesRead = socket.readInto(buffer, 0, DEFAULT_CHUNK_SIZE);
if (bytesRead === 0) {
  controller.close();
} else {
  controller.enqueue(new Uint8Array(buffer, 0, bytesRead));
}