---
title: AudioContext.suspend()
slug: Web/API/AudioContext/suspend
translation_of: Web/API/AudioContext/suspend
---
<p>{{ APIRef("Web Audio API") }}</p>

<p><code>suspend()</code>メソッドは、オーディオコンテキストの時間の流れを一時停止します。音声ハードウェアへのアクセスを一時的に停止し、処理に必要だったCPU/バッテリーの使用を減らすことが出来ます。これは、アプリケーションがしばらくの間オーディオを扱わない間に、音声ハードウェアに電源を供給しないようにしたいときに便利です。</p>

<p>{{domxref("OfflineAudioContext")}}でこのメソッドを呼ぶと<code>INVALID_STATE_ERR</code>例外が発生します。</p>

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

<pre class="brush: js">var audioCtx = new AudioContext();
audioCtx.suspend().then(function() { ... });
</pre>

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

<p>voidで完了する{{jsxref("Promise")}}。コンテキストが既に閉じている場合、プロミスは失敗します。</p>

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

<p>次のスニペットは<a href="https://github.com/mdn/audiocontext-states/settings">AudioContext states デモ</a>(<a href="http://mdn.github.io/audiocontext-states/">すぐ実行</a>)から取ったものです。suspend/resumeボタンをクリックすると、{{domxref("AudioContext.state")}}を問い合わせます—もし<code>running</code>ならば、<code>suspend()</code>が呼ばれます。<code>suspended</code>ならば、{{domxref("resume")}}が呼ばれます。両方ともプロミスに成功するとボタンのラベルが適したものに更新されます。</p>

<pre class="brush: js">susresBtn.onclick = function() {
  if(audioCtx.state === 'running') {
    audioCtx.suspend().then(function() {
      susresBtn.textContent = 'Resume context';
    });
  } else if(audioCtx.state === 'suspended') {
    audioCtx.resume().then(function() {
      susresBtn.textContent = 'Suspend context';
    });
  }
}
</pre>

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

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('Web Audio API', '#widl-AudioContext-suspend-Promise-void', 'close()')}}</td>
   <td>{{Spec2('Web Audio API')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>

<h2 id="ブラウザ互換性">ブラウザ互換性</h2>

<div>


<p>{{Compat("api.AudioContext.suspend")}}</p>
</div>

<h2 id="参考">参考</h2>

<ul>
 <li><a href="/en-US/docs/Web_Audio_API/Using_Web_Audio_API">Using the Web Audio API</a></li>
 <li><a href="/en-US/docs/Web/API/Web_Audio_API">Web Audio API</a></li>
</ul>