--- title: AudioContext.close() slug: Web/API/AudioContext/close translation_of: Web/API/AudioContext/close ---

{{ APIRef("Web Audio API") }}

{{ domxref("AudioContext") }}インターフェースのclose()メソッドは、オーディオコンテキストを閉じて使っていたシステムのオーディオリソースを全て解放します。

閉じたコンテキストは新しいノードを生成できませんが、音声データのデコードやバッファの生成などは可能です。

この関数は、他の参照も同様に解放されない限り、AudioContextが生成したオブジェクトは自動的には解放しません。しかし、これはオーディオリソースを強制的に解放します。よって、オーディオコンテキストの更なる生成と使用はできなくなり、オーディオコンテキストの時間の流れは止まり、音声データの処理は停止します。
全てのAudioContext-creation-blockingリソースが解放されたとき、返された{{jsxref("Promise")}}が完了します。このメソッドは{{domxref("OfflineAudioContext")}}で呼ばれたときINVALID_STATE_ERR例外が発生します。
 

構文

var audioCtx = new AudioContext();
audioCtx.close().then(function() { ... });

戻り値

voidで完了する{{jsxref("Promise")}}。

次のスニペットはAudioContext states デモ(すぐ実行)から取ったものです。stopボタンをクリックすると、close()が呼ばれます。プロミスに成功すると、リセットされ最初の状態に戻ります。

stopBtn.onclick = function() {
  audioCtx.close().then(function() {
    startBtn.removeAttribute('disabled');
    susresBtn.setAttribute('disabled','disabled');
    stopBtn.setAttribute('disabled','disabled');
  });
}

仕様

Specification Status Comment
{{SpecName('Web Audio API', '#widl-AudioContext-close-Promise-void', 'close()')}} {{Spec2('Web Audio API')}}  

ブラウザ互換性

{{Compat("api.AudioContext.close")}}

参考