ReadableStreamBYOBRequest

Hàm khởi tạo

Không có. Thực thể ReadableStreamBYOBRequest được tạo tự động bởi ReadableByteStreamController khi cần.

Thuộc tính phiên bản

ReadableStreamBYOBRequest.view Read only

Trả về view hiện tại. Đây là view trên một bộ nhớ đệm sẽ được truyền cho người tiêu thụ khi ReadableStreamBYOBRequest.respond() được gọi.

Phương thức phiên bản

ReadableStreamBYOBRequest.respond()

Báo hiệu cho readable byte stream liên quan rằng số byte được chỉ định đã được ghi vào view hiện tại, từ đó khiến yêu cầu đang chờ từ người tiêu thụ được giải quyết. Lưu ý rằng sau khi phương thức này được gọi, view sẽ được truyền và không còn có thể sửa đổi.

ReadableStreamBYOBRequest.respondWithNewView()

Báo hiệu cho readable byte stream liên quan rằng view được truyền làm đối số sẽ được chuyển đến người tiêu thụ của readable byte stream. View mới này phải sử dụng cùng bộ nhớ đệm như view ban đầu, bắt đầu tại cùng offset, và có độ dài bằng hoặc nhỏ hơn. Lưu ý rằng sau khi phương thức này được gọi, view sẽ được truyền và không còn có thể sửa đổi.

Ví dụ

Code sau được lấy từ ví dụ trực tiếp trong Sử dụng readable byte streams > Tạo readable socket push byte stream.

Nguồn byte push bên dưới có dữ liệu để truyền trước tiên cần kiểm tra xem controller.byobRequest có khác null không. Nguồn byte pull chỉ cần kiểm tra này nếu tự động phân bổ chunk không được bật và nó được dùng với reader mặc định.

if (controller.byobRequest) {
  /* code to transfer data */
}

Có hai cách để đọc dữ liệu vào ReadableStreamBYOBRequest và sau đó truyền nó. Cách đầu tiên là ghi dữ liệu vào thuộc tính ReadableStreamBYOBRequest.view và sau đó gọi ReadableStreamBYOBRequest.respond() để chỉ ra lượng dữ liệu cần truyền. Sau khi thao tác này, byobRequest.view sẽ bị tách ra và yêu cầu nên bị loại bỏ.

Code bên dưới cho thấy trường hợp này bằng cách dùng phương thức giả định readInto() để sao chép dữ liệu vào view:

const v = controller.byobRequest.view;
bytesRead = socket.readInto(v.buffer, v.byteOffset, v.byteLength);
controller.byobRequest.respond(bytesRead);

Cách khác là gọi ReadableStreamBYOBRequest.respondWithNewView() truyền view của bạn trên cùng dữ liệu sao lưu bên dưới. Lưu ý rằng đây chỉ là cách khác để chỉ định phạm vi của bộ nhớ đệm/bộ nhớ sao lưu bên dưới thực sự được truyền. Tương đương respondWithNewView của code trên sẽ là:

const v = controller.byobRequest.view;
bytesRead = socket.readInto(v.buffer, v.byteOffset, v.byteLength);
const newView = new Uint8Array(v.buffer, v.byteOffset, bytesRead);
controller.byobRequest.respondWithNewView(newView);

Thông số kỹ thuật

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

Xem thêm

• Sử dụng readable byte stream