AudioNode: Methode 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.

Die disconnect()-Methode des AudioNode-Interfaces ermöglicht es, ein oder mehrere Knoten von dem Knoten zu trennen, auf dem die Methode aufgerufen wird.

Syntax

js
disconnect()

Parameter

Es gibt mehrere Versionen der disconnect()-Methode, die verschiedene Kombinationen von Parametern akzeptieren, um zu steuern, welche Knoten getrennt werden sollen. Wenn keine Parameter angeben sind, werden alle ausgehenden Verbindungen getrennt.

destination Optional

Ein AudioNode oder AudioParam, das den oder die Knoten angibt, von dem getrennt werden soll. Wenn dieser Wert ein AudioNode ist, wird ein einzelner Knoten getrennt, wobei alle anderen optionalen Parameter (output und/oder input) weiter einschränken, welche Eingänge und/oder Ausgänge getrennt werden sollen. Wenn dieser Wert ein AudioParam ist, wird die Verbindung zu diesem AudioParam beendet, und die Beiträge des Knotens zu diesem berechneten Parameter werden ab dem Zeitpunkt der Änderung 0.

output Optional

Ein Index, der beschreibt, welcher Ausgang vom aktuellen AudioNode getrennt werden soll. Die Indexnummern sind entsprechend der Anzahl der Ausgangskanäle definiert (siehe Audiokanäle).

input Optional

Ein Index, der beschreibt, welcher Eingang in den angegebenen AudioNode-Zielknoten getrennt werden soll. Die Indexnummern sind entsprechend der Anzahl der Eingangskanäle definiert (siehe Audiokanäle).

Rückgabewert

Keiner (undefined).

Ausnahmen

IndexSizeError DOMException

Wird ausgelöst, wenn der angegebene Wert als input oder output ungültig ist, sich auf einen Knoten bezieht, der nicht existiert oder außerhalb des zulässigen Bereichs liegt.

InvalidAccessError DOMException

Wird ausgelöst, wenn der Knoten, auf dem disconnect() aufgerufen wird, nicht mit dem angegebenen destination-Knoten verbunden ist.

Beispiele

js
const audioCtx = new AudioContext();

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

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

gainNode.disconnect();

Spezifikationen

Specification
Web Audio API
# dom-audionode-disconnect

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch