---
title: SourceBuffer.removeAsync()
slug: Web/API/SourceBuffer/removeAsync
tags:
  - API
  - Audio
  - MSE
  - Media
  - Media Source Extensions
  - Method
  - Non-standard
  - Reference
  - SourceBuffer
  - Video
  - removeAsync
translation_of: Web/API/SourceBuffer/removeAsync
---
<div>{{APIRef("Media Source Extensions")}}{{non-standard_header}}{{SeeCompatTable}}</div>

<p><span class="seoSummary">{{domxref("SourceBuffer")}} インターフェイスの <strong><code>removeAsync()</code></strong> メソッドは、特定の時間範囲内で見つかった <code>SourceBuffer</code> のメディアセグメントから非同期的に削除するプロセスを開始します。</span> 指定された時間範囲のバッファが削除されたときに満たされる {{jsxref("Promise")}} が返されます。</p>

<p>このメソッドは、{{domxref("SourceBuffer.updating", "updating")}} が <code>false</code> の場合にのみ呼び出すことができます。 そうでない場合は、代わりに {{domxref("SourceBuffer.abort", "abort()")}} を呼び出します。</p>

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

<pre class="syntaxbox"><em>removePromise</em> = <em>sourceBuffer</em>.removeAsync(<em>start</em>, <em>end</em>);</pre>

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

<dl>
 <dt><code>start</code></dt>
 <dd>時間範囲の始まりを秒単位で表す double 型。</dd>
 <dt><code>end</code></dt>
 <dd>時間範囲の終わりを秒単位で表す double 型。</dd>
</dl>

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

<p>指定された時間範囲のバッファが <code>SourceBuffer</code> から削除されると、完了ハンドラが実行される {{jsxref("Promise")}}。</p>

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

<p>この例では、指定された <code>SourceBuffer</code> の内容を単純にクリアする非同期関数 <code>emptySourceBuffer()</code> を定義します。</p>

<pre class="brush: js">async function emptySourceBuffer(msBuffer) {
  await msBuffer.removeAsync(0, Infinity).catch(function(e) {
    handleException(e);
  }
}
</pre>

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

<p>現在、MSE 仕様の一部ではありません。</p>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">仕様</th>
   <th scope="col">状態</th>
   <th scope="col">コメント</th>
  </tr>
  <tr>
   <td>{{SpecName('Media Source Extensions')}}</td>
   <td>{{Spec2('Media Source Extensions')}}</td>
   <td>初期定義</td>
  </tr>
 </tbody>
</table>

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

<div>


<p>{{Compat("api.SourceBuffer.removeAsync")}}</p>
</div>

<h2 id="See_also" name="See_also">関連情報</h2>

<ul>
 <li><a href="/ja/docs/Web/API/Media_Source_Extensions_API">Media Source Extensions API</a></li>
 <li>{{domxref("SourceBuffer.remove()")}}</li>
 <li>{{domxref("MediaSource")}}</li>
 <li>{{domxref("SourceBufferList")}}</li>
</ul>