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

{{domxref("ReadableStreamDefaultReader")}} インターフェイスの read() メソッドは、ストリームの内部キュー内の次のチャンクへのアクセスを提供する promise を返します。

+ +

構文

+ +
var promise = readableStreamDefaultReader.read();
+ +

パラメーター

+ +

なし。

+ +

戻り値

+ +

{{jsxref("Promise")}}。ストリームの状態に応じて結果を充足/拒否します。 異なる可能性は次のとおりです。

+ + + +

例外

+ +
+
TypeError
+
ソースオブジェクトが ReadableStreamDefaultReader ではないか、ストリームに所有者がいません。
+
+ +

例

+ +

例 1 - 簡単な例

+ +

この例は、基本的な API の使用方法を示していますが、例えば、行の境界で終了しないストリームチャンクなどの複雑な問題には対処しません。

+ +

この例では、stream は以前に作成したカスタムの ReadableStream です。 getReader() を使用して作成した {{domxref("ReadableStreamDefaultReader")}} を使用して読み取ります（完全なコードについては、単純なランダムストリームの例を参照）。 各チャンクを順番に読み取り、ストリームの読み取りが完了するまで UTF-8 のバイトの配列として UI に出力します。 ストリームの読み取りが完了すると、再帰関数から戻り、ストリーム全体を UI の別の部分に出力します。

+ +
function fetchStream() {
+  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");
+      para.textContent = result;
+      return;
+    }
+
+    // フェッチしたストリームの値は Uint8Array です
+    charsReceived += value.length;
+    const chunk = value;
+    let listItem = document.createElement('li');
+    listItem.textContent = 'Received ' + charsReceived + ' characters so far. Current chunk = ' + chunk;
+    list2.appendChild(listItem);
+
+    result += chunk;
+
+    // さらに読み、この関数を再度呼び出します
+    return reader.read().then(processText);
+  });
+}
+ +

例 2 - テキストを1行ずつ処理する

+ +

この例は、テキストファイルをフェッチし、テキスト行のストリームとして処理する方法を示しています。 行の境界で終了せず、Uint8Array から文字列に変換するストリームチャンクを処理します。

+ +
async function* makeTextFileLineIterator(fileURL) {
+  const utf8Decoder = new TextDecoder("utf-8");
+  let response = await fetch(fileURL);
+  let reader = response.body.getReader();
+  let {value: chunk, done: readerDone} = await reader.read();
+  chunk = chunk ? utf8Decoder.decode(chunk) : "";
+
+  let re = /\n|\r|\r\n/gm;
+  let startIndex = 0;
+  let result;
+
+  for (;;) {
+    let result = re.exec(chunk);
+    if (!result) {
+      if (readerDone) {
+        break;
+      }
+      let remainder = chunk.substr(startIndex);
+      ({value: chunk, done: readerDone} = await reader.read());
+      chunk = remainder + (chunk ? utf8Decoder.decode(chunk) : "");
+      startIndex = re.lastIndex = 0;
+      continue;
+    }
+    yield chunk.substring(startIndex, result.index);
+    startIndex = re.lastIndex;
+  }
+  if (startIndex < chunk.length) {
+    // 最後の行は改行文字で終わっていません
+    yield chunk.substr(startIndex);
+  }
+}
+
+for await (let line of makeTextFileLineIterator(urlOfFile)) {
+  processLine(line);
+}
+ +

仕様

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

ブラウザーの互換性

+ + + +

{{Compat("api.ReadableStreamDefaultReader.read")}}

-- cgit v1.2.3-54-g00ecf