AudioNode: disconnect() メソッド

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2021.

* Some parts of this feature may have varying levels of support.

AudioNode インターフェイスの disconnect() メソッドは、このメソッドが呼ばれたノードから 1 個または複数のノードを切断します。

構文

js
disconnect()

引数

disconnect() メソッドには、切断するノードを決めるための引数の異なる組み合わせを受け付けるいくつかのバージョンがあります。引数が渡されない場合は、すべての出力の接続が切断されます。

destination 省略可

切断する 1 個または複数のノードを表す AudioNode または AudioParam です。値が AudioNode の場合は、切断する対象の 1 個のノードを表し、他の任意の引数 (output および input) によって切断する入力や出力を絞り込むことができます。値が AudioParam の場合は、この AudioParam への接続が終了し、変更が反映されるとこのパラメーターの計算におけるこのノードの担当部分は 0 になります。

output 省略可

この AudioNode のどの出力を切断するかを表すインデックスです。インデックス番号は出力のチャンネル数に基づいて決められます。(オーディオチャンネルを参照してください)

input 省略可

指定の出力先 AudioNode へのどの入力を切断するかを表すインデックスです。インデックス番号は入力のチャンネル数に基づいて決められます。(オーディオチャンネルを参照してください)

返値

なし (undefined)

例外

IndexSizeError DOMException

input または output として指定された値が無効な (存在しないノードを指しているか、許される範囲の外である) とき投げられます。

InvalidAccessError DOMException

disconnect() が呼ばれたノードが指定された destination ノードに接続されていないとき投げられます。

js
const AudioContext = window.AudioContext || window.webkitAudioContext;

const audioCtx = new AudioContext();

const oscillator = audioCtx.createOscillator();
const gainNode = audioCtx.createGain();

oscillator.connect(gainNode);
gainNode.connect(audioCtx.destination);

gainNode.disconnect();

仕様書

Specification
Web Audio API
# dom-audionode-disconnect

ブラウザーの互換性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
disconnect
destination parameter
input parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
No support
No support

関連情報