ReadableStreamBYOBRequest

なし。 ReadableStreamBYOBRequest インスタンスは ReadableByteStreamController によって必要に応じて作成されます。

ReadableStreamBYOBRequest.view 読取専用

現在のビューを返します。 ReadableStreamBYOBRequest.respond() が呼び出されたときにコンシューマーに移譲されるバッファーに関するビューです。

ReadableStreamBYOBRequest.respond()

関連付けられた読み取り可能なバイトストリームに、指定したバイト数が現在の view に書き込まれたことを通知し、コンシューマーからの待機中のリクエストを解決させます。 このメソッドが呼び出された後、viewは移譲され、変更できなくなることに注意してください。

ReadableStreamBYOBRequest.respondWithNewView()

引数として渡された、読み取り可能なバイトストリームのコンシューマーに転送される、関連付けられた読み取り可能なストリームビューへ通知します。 この新しいビューは、元の view と同じバッファーを使用し、同じオフセットから始まり、同じ長さかそれ以下でなければなりません。 このメソッドが呼び出された後、 view は移譲され、変更できなくなることに注意してください。

以下のコードは、読み取り可能なバイトストリーム > 読み取り可能なソケットプッシュバイトストリームの作成のライブ例から引用したものです。

データを移譲するプッシュ基盤バイトソースは、最初に controller.byobRequest が null でないことを調べる必要があります。 このチェックが必要なのは、自動チャンク割り当てが有効でなく、既定のリーダーで使用する場合のみです。

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

ReadableStreamBYOBRequest にデータを読み込んでそれを移譲するには 2 つの方法があります。 最初の方法は ReadableStreamBYOBRequest.view プロパティにデータを書き込んでから ReadableStreamBYOBRequest.respond() を呼び出して移譲するデータ量を示す方法です。 処理後、 byobRequest.view を切り離し、リクエストを破棄すべきです。

下記のコードはこの用途を示すもので、データをビューにコピーするために readInto() メソッドを使用しています。

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

他にも、 ReadableStreamBYOBRequest.respondWithNewView() を呼び出して、同じ基盤バッキングデータに自分自身でビューを渡す、という手法があります。 これは単に、実際に移譲される基盤バッファー/メモリーバッキングの範囲を指定する別の方法であることに注意してください。 上のコードと同等の respondWithNewView は次のようになります。

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);

• 読み取り可能なバイトストリームの使用