From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/readablestream/tee/index.html | 99 ++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 files/ja/web/api/readablestream/tee/index.html (limited to 'files/ja/web/api/readablestream/tee') diff --git a/files/ja/web/api/readablestream/tee/index.html b/files/ja/web/api/readablestream/tee/index.html new file mode 100644 index 0000000000..5c81e27ed0 --- /dev/null +++ b/files/ja/web/api/readablestream/tee/index.html @@ -0,0 +1,99 @@ +--- +title: ReadableStream.tee() +slug: Web/API/ReadableStream/tee +tags: + - API + - Method + - ReadableStream + - Reference + - Streams + - tee +translation_of: Web/API/ReadableStream/tee +--- +
{{APIRef("Streams")}}
+ +

{{domxref("ReadableStream")}} インターフェイスの tee() メソッドは、現在の読み取り可能なストリームをティーイングし、結果の2つの分岐を新しい {{domxref("ReadableStream")}} インスタンスとして含む2要素配列を返します。

+ +

これは、2つのリーダーがストリームを同時に、おそらく異なる速度で読み取ることができるようにする場合に便利です。 例えば、サーバーから応答を取得してブラウザーにストリームしたいが、ServiceWorker キャッシュにもストリームしたい場合は、ServiceWorker でこれを行うことができます。 応答のボディを複数回使用することはできないため、これを行うには2つのコピーが必要です。

+ +

ストリームをキャンセルするには、結果の両方の分岐をキャンセルする必要があります。 ストリームをティーイングすると、通常、その間はストリームがロックされ、他のリーダーがロックできなくなります。

+ +

構文

+ +
var teedStreams = readableStream.tee();
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

2つの {{domxref("ReadableStream")}} インスタンスを含む {{jsxref("Array")}}。

+ +

例外

+ +
+
TypeError
+
ソースストリームは ReadableStream ではありません。
+
+ +

例

+ +

次の簡単な例では、以前に作成したストリームをティーイングした結果の両方のストリーム（生成された配列の2つのメンバーに含まれる）を、2つのストリームからデータを読み取り、各ストリームのチャンクを UI の異なる部分に順番に印刷する関数に渡します。 完全なコードについては、単純な tee の例を参照してください。

+ +
function teeStream() {
+  const teedOff = stream.tee();
+  fetchStream(teedOff[0], list2);
+  fetchStream(teedOff[1], list3);
+}
+
+function fetchStream(stream, list) {
+  const reader = stream.getReader();
+  let charsReceived = 0;
+
+  // read() は、値を受け取ったときに解決する promise を返します
+  reader.read().then(function processText({ done, value }) {
+    // 結果オブジェクトには2つのプロパティが含まれます。
+    // done  - ストリームがすべてのデータを既に提供している場合は true。
+    // value - 一部のデータ。 done が true の場合、常に undefined。
+    if (done) {
+      console.log("Stream complete");
+      return;
+    }
+
+    // フェッチしたストリームの値は Uint8Array です
+    charsReceived += value.length;
+    const chunk = value;
+    let listItem = document.createElement('li');
+    listItem.textContent = 'Read ' + charsReceived + ' characters so far. Current chunk = ' + chunk;
+    list.appendChild(listItem);
+
+    // さらに読み、この関数を再度呼び出します
+    return reader.read().then(processText);
+  });
+}
+ +

仕様

+ + + + + + + + + + + + + + +
仕様状態コメント
{{SpecName("Streams","#rs-tee","tee()")}}{{Spec2('Streams')}}初期定義
+ +

ブラウザーの互換性

+ + + +

{{Compat("api.ReadableStream.tee")}}

-- cgit v1.2.3-54-g00ecf