This feature is not Baseline because it does not work in some of the most widely-used browsers.
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Note: This feature is available in Dedicated Web Workers.
The configure() method of the AudioDecoder interface enqueues a control message to configure the audio decoder for decoding chunks.
configure(config)
configA dictionary object containing the following members:
codecA string containing a valid codec string. See "codecs" parameter for details on codec string construction.
sampleRateAn integer representing the number of frame samples per second.
numberOfChannelsAn integer representing the number of audio channels.
description OptionalAn ArrayBuffer, a TypedArray, or a DataView containing a sequence of codec specific bytes, commonly known as extradata.
Note: The registrations in the WebCodecs Codec Registry link to a specification detailing whether and how to populate the optional description member.
None (undefined).
TypeErrorThrown if the provided config is invalid.
InvalidStateError DOMException
Thrown if the state is "closed".
NotSupportedError DOMException
Thrown if the provided config is valid but the user agent cannot provide a codec that can decode this profile.
The following example configures the audioDecoder with the opus codec.
audioDecoder.configure({
codec: "opus",
sampleRate: 44100,
numberOfChannels: 2,
});
| Specification |
|---|
| WebCodecs> # dom-audiodecoder-configure> |
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | WebView on iOS | |
configure |
94 | 94 | 130 | 80 | 26 | 94 | No | 66 | 26 | 17.0 | 94 | 26 |
© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/AudioDecoder/configure