AudioData: AudioData() constructor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Note: This feature is available in Dedicated Web Workers.

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The AudioData() constructor creates a new AudioData object which represents an individual audio sample.

Syntax

js
new AudioData(init)

Parameters

init

An object containing the following:

format

One of:

  • "u8"
  • "s16"
  • "s32"
  • "f32"
  • "u8-planar"
  • "s16-planar"
  • "s32-planar"
  • "f32-planar"
sampleRate

A decimal containing the sample rate in Hz.

numberOfFrames

An integer containing the number of frames in this sample.

numberOfChannels

An integer containing the number of channels in this sample.

timestamp

An integer indicating the data's time in microseconds .

data

A typed array of the audio data for this sample.

transfer

An array of ArrayBuffers that AudioData will detach and take ownership of. If the array contains the ArrayBuffer backing data, AudioData will use that buffer directly instead of copying from it.

Exceptions

TypeError

Thrown if init is in an incorrect format.

Specifications

Specification
WebCodecs
# dom-audiodata-audiodata

Browser compatibility

BCD tables only load in the browser