---
title: ReadableStreamBYOBReader.read()
slug: Web/API/ReadableStreamBYOBReader/read
tags:
  - API
  - Experimental
  - Method
  - ReadableStreamBYOBReader
  - Reference
  - Streams
  - read
translation_of: Web/API/ReadableStreamBYOBReader/read
---
<div>{{draft}}{{SeeCompatTable}}{{APIRef("Streams")}}</div>

<p class="summary"><span class="seoSummary">{{domxref("ReadableStreamBYOBReader")}} インターフェイスの <strong><code>read()</code></strong> メソッドは、バイトストリームの内部キュー内の次のチャンクへのアクセスを提供する promise を返します。</span></p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="syntaxbox">var <em>promise</em> = <em>readableStreamBYOBReader</em>.read(<em>view</em>);</pre>

<h3 id="Parameters" name="Parameters">パラメーター</h3>

<dl>
 <dt>view</dt>
 <dd>読み込み先のビュー。</dd>
</dl>

<h3 id="Return_value" name="Return_value">戻り値</h3>

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

<ul>
 <li>チャンクが使用可能な場合、<code>{ value: theChunk, done: false }</code> の形式のオブジェクトで promise が満たされます。</li>
 <li>ストリームが閉じられると、<code>{ value: undefined, done: true }</code> という形式のオブジェクトで promise が満たされます。</li>
 <li>ストリームがエラーになると、関連するエラーで promise が拒否されます。</li>
</ul>

<h3 id="Exceptions" name="Exceptions">例外</h3>

<dl>
 <dt>TypeError</dt>
 <dd>ソースオブジェクトが <code>ReadableStreamBYOBReader</code> ではない、ストリームに所有者がない、ビューがオブジェクトではない、または切り離されている、またはビューの長さが 0 である。</dd>
</dl>

<h2 id="Examples" name="Examples">例</h2>

<p>未定。</p>

<h2 id="Specifications" name="Specifications">仕様</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状態</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName("Streams","#byob-reader-read","read()")}}</td>
   <td>{{Spec2('Streams')}}</td>
   <td>初期定義</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat("api.ReadableStreamBYOBReader.read")}}</p>