MediaElementAudioSourceNode: MediaElementAudioSourceNode() 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 MediaElementAudioSourceNode() constructor creates a new MediaElementAudioSourceNode object instance.

Syntax

js
new MediaElementAudioSourceNode(context, options)

Parameters

context

An AudioContext representing the audio context you want the node to be associated with.

options

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

mediaElement

An HTMLMediaElement that will be used as the source for the audio.

channelCount

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

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

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.channelInterpretation for more information including default values.)

Return value

A new MediaElementAudioSourceNode object instance.

Examples

js
const ac = new AudioContext();
const mediaElement = document.createElement("audio");

const myAudioSource = new MediaElementAudioSourceNode(ac, {
  mediaElement,
});

Specifications

Specification
Web Audio API
# dom-mediaelementaudiosourcenode-mediaelementaudiosourcenode

Browser compatibility

BCD tables only load in the browser