The AudioBuffer constructor of the Web Audio API creates a new AudioBuffer object.


var audioBuffer = new AudioBuffer(options);


Inherits parameters from the AudioNodeOptions dictionary.

Options are as follows:
  • length: The size of the audio buffer in sample-frames. To determine the length to use for a specific number of seconds of audio, use numSeconds * sampleRate.
  • numberOfChannels: The number of channels for the buffer. The default is 1, and all user agents are required to support at least 32 channels.
  • sampleRate: The sample rate in Hz for the buffer. The default is the sample rate of the context used in constructing this object. User agents are required to support sample rates from 8,000 Hz to 96,000 Hz (but are allowed to go farther outside this range).

Deprecated parameters

context This deprecated API should no longer be used, but will probably still work.
A reference to an AudioContext. This parameter was removed from the spec.

Return value

A new AudioBuffer object instance.


One or more of the options are negative or otherwise has an invalid value (such as numberOfChannels being higher than supported, or a sampleRate outside the nominal range).
There isn't enough memory available to allocate the buffer.


Specification Status Comment
Web Audio API
The definition of 'AudioBuffer' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser