AudioNode: disconnect() 方法

语法

disconnect()

参数

disconnect() 方法有几种不同的形式，它们接受不同的参数组合来控制要断开连接的节点。如果不提供任何参数，将断开所有传出连接。

destination 可选

一个 AudioNode 或 AudioParam，用于指定要断开连接的节点。如果此值为 AudioNode，则将断开与单个节点的连接，而任何其他可选参数（output 和/或 input）将进一步限制要断开连接的输入和/或输出。如果此值为 AudioParam，则终止与该 AudioParam 的连接，并且该节点对计算参数的贡献将在更改生效后变为 0。

output 可选

一个描述当前 AudioNode 的哪个输出将被断开连接的索引。索引编号根据输出通道的数量定义（参见 音频通道）。

input 可选

一个描述要断开连接的指定目标 AudioNode 的哪个输入索引。索引编号根据输入通道的数量定义（参见 音频通道）。

返回值

无（undefined）。

异常

IndexSizeError DOMException

如果指定的 input 或 output 值无效，指向一个不存在的节点或超出允许范围，则会抛出此异常。

InvalidAccessError DOMException

如果调用 disconnect() 的节点未连接到指定的 destination 节点，则会抛出此异常。

示例

const audioCtx = new AudioContext();

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

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

gainNode.disconnect();

规范

浏览器兼容性

另见

• 使用 Web Audio API