ReadableByteStreamController: 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.

enqueue() は ReadableByteStreamController で、指定されたチャンクを、関連する読み取り可能なバイトストリームのキューに入れます（チャンクはストリーム内部のキューにコピーされます）。

これは、 byobRequest が null である場合にのみ、キューへのデータ移譲に使用しましょう。

構文

enqueue(chunk)

引数

chunk

キューに入れるチャンク。

返値

なし (undefined)。

例外

TypeError

ソースオブジェクトが ReadableByteStreamController ではないか、何らかの理由でストリームを読み取れないか、チャンクがオブジェクトではないか、チャンクの内部配列バッファーが存在しないか、切り離されています。ストリームが既に閉じられていたときにも発生します。

例

読み取り可能なバイトストリームの使用 > 読み取り可能なソケットプッシュバイトストリームの作成の例では、未処理の byobRequest がない場合に enqueue() を使用してデータをストリームにコピーする方法を示します。もし byobRequest があれば、それを使用しましょう。

下記のコードでは、「仮定の」 socket.readInto() メソッドを使用してデータを ArrayBuffer に読み込ませ、その後キューに入れています（ただし、実際にデータがコピーされた場合のみ）。

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

仕様書

Specification

Streams
# ref-for-rbs-controller-enqueue①

ブラウザーの互換性

Enable JavaScript to view this browser compatibility table.

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on 2023年9月28日 by MDN contributors.

View this page on GitHub • Report a problem with this content

ストリーム API
ReadableByteStreamController
インスタンスプロパティ
1. byobRequest
2. desiredSize
インスタンスメソッド
Streams に関連するページ
ガイド
1. ストリーム API の概念
2. 読み取り可能なストリームの使用
3. 読み取り可能なバイトストリームの使用
4. 書き込み可能なストリームの使用

ReadableByteStreamController: enqueue() メソッド

In this article

構文

引数

返値

例外

例

仕様書

ブラウザーの互換性

関連情報

Help improve MDN