ChannelMergerNode: ChannelMergerNode() constructor

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.

The ChannelMergerNode() constructor creates a new ChannelMergerNode object instance.

Syntax

new ChannelMergerNode(context)
new ChannelMergerNode(context, options)

A BaseAudioContext representing the audio context you want the node to be associated with.

An object defining the properties you want the ChannelMergerNode to have:

numberOfInputs Optional: A number defining the number of inputs the ChannelMergerNode should have. If not specified, the default value used is 6.
channelCount Optional: An integer used to determine how many channels are used when up-mixing and down-mixing connections to any inputs to the node. (See AudioNode.channelCount for more information.) Its usage and precise definition depend on the value of channelCountMode.
channelCountMode Optional: A string describing the way channels must be matched between the node's inputs and outputs. (See AudioNode.channelCountMode for more information including default values.)
channelInterpretation Optional: A string describing the meaning of the channels. This interpretation will define how audio up-mixing and down-mixing will happen. The possible values are "speakers" or "discrete". (See AudioNode.channelCountMode for more information including default values.)

A new ChannelMergerNode object instance.

InvalidStateError DOMException: Thrown if an option such as channelCount or channelCountMode has been given an invalid value.

const ac = new AudioContext();

const options = {
  numberOfInputs: 2,
};

const myMerger = new ChannelMergerNode(ac, options);

Specification
Web Audio API # dom-channelmergernode-constructor-channelmergernode