W3cubDocs

/Web APIs

AudioDestinationNode

The AudioDestinationNode interface represents the end destination of an audio graph in a given context — usually the speakers of your device. It can also be the node that will "record" the audio data when used with an OfflineAudioContext.

AudioDestinationNode has no output (as it is the output, no more AudioNode can be linked after it in the audio graph) and one input. The number of channels in the input must be between 0 and the maxChannelCount value or an exception is raised.

The AudioDestinationNode of a given AudioContext can be retrieved using the AudioContext.destination property.

EventTarget AudioNode AudioDestinationNode
Number of inputs 1
Number of outputs 0
Channel count mode "explicit"
Channel count 2
Channel interpretation "speakers"

Instance properties

Inherits properties from its parent, AudioNode.

AudioDestinationNode.maxChannelCount

An unsigned long defining the maximum number of channels that the physical device can handle.

Instance methods

No specific method; inherits methods from its parent, AudioNode.

Example

There is no complex set up for using an AudioDestinationNode — by default, this represents the output of the user's system (e.g. their speakers), so you can get it hooked up inside an audio graph using only a few lines of code:

js

const audioCtx = new AudioContext();
const source = audioCtx.createMediaElementSource(myMediaElement);
source.connect(gainNode);
gainNode.connect(audioCtx.destination);

To see a more complete implementation, check out one of our MDN Web Audio examples, such as Voice-change-o-matic or Violent Theremin.

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
AudioDestinationNode 14 12 25 No 15 6 4.4.3 18 25 14 6 1.0
maxChannelCount 27 12 25 No 15 14.1
7–14.1This property always returns 0.
≤37 27 25 15 14.5
7–14.5This property always returns 0.
1.5

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioDestinationNode