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

Syntax

var audioBuffer = new AudioBuffer(options);
var audioBuffer = new AudioBuffer(context[, options]);

Parameters

Inherits parameters from the AudioNodeOptions dictionary.

options
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).
  • 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 
A reference to an AudioContext. This parameter was removed from the spec.

Return value

A new AudioBuffer object instance.

Exceptions

NotSupportedError
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).
RangeError
There isn't enough memory available to allocate the buffer.

Specifications

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

Browser Compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Basic supportChrome Full support 55
Notes
Full support 55
Notes
Notes The context parameter was supported up until version 57, but has now been removed.
Edge ? Firefox Full support 53IE No support NoOpera Full support 42
Notes
Full support 42
Notes
Notes The context parameter was supported up until version 44, but has now been removed.
Safari ? WebView Android Full support 55
Notes
Full support 55
Notes
Notes The context parameter was supported up until version 57, but has now been removed.
Chrome Android Full support 55
Notes
Full support 55
Notes
Notes The context parameter was supported up until version 57, but has now been removed.
Edge Mobile ? Firefox Android Full support 53Opera Android Full support 42
Notes
Full support 42
Notes
Notes The context parameter was supported up until version 44, but has now been removed.
Safari iOS ? Samsung Internet Android Full support 6.0

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
See implementation notes.
See implementation notes.

Document Tags and Contributors

Last updated by: chrisdavidmills,