AudioDecoder: configure() method

Limited availability

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

See full compatibility

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.

Syntax

configure(config)

Parameters

config

A dictionary object containing the following members:

codec: A string containing a valid codec string. See "codecs" parameter for details on codec string construction.
sampleRate: An integer representing the number of frame samples per second.
numberOfChannels: An integer representing the number of audio channels.
description Optional: An 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.

Exceptions

TypeError: Thrown 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.

Examples

The following example configures the audioDecoder with the opus codec.

audioDecoder.configure({
  codec: "opus",
  sampleRate: 44100,
  numberOfChannels: 2,
});

Specifications

Specification
WebCodecs # dom-audiodecoder-configure

Browser compatibility

	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`	Chrome – Full support Chrome 94 (Release date: 2021-09-21) footnote Full support	Edge – Full support Edge 94 (Release date: 2021-09-24) footnote Full support	Firefox – Full support Firefox 130 (Release date: 2024-09-03) footnote Full support	Opera – Full support Opera 80 (Release date: 2021-10-05) footnote Full support	Safari – Full support Safari 26 (Release date: 2025-09-15) footnote Full support	Chrome Android – Full support Chrome Android 94 (Release date: 2021-09-21) footnote Full support	Firefox for Android – No support Firefox for Android footnote No support	Opera Android – Full support Opera Android 66 (Release date: 2021-12-15) footnote Full support	Safari on iOS – Full support Safari on iOS 26 (Release date: 2025-09-15) footnote Full support	Samsung Internet – Full support Samsung Internet 17 (Release date: 2022-05-04) footnote Full support	WebView Android – Full support WebView Android 94 (Release date: 2021-09-21) footnote Full support	WebView on iOS – Full support WebView on iOS 26 (Release date: 2025-09-15) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support

This page was last modified on May 28, 2025 by MDN contributors.

Visit Mozilla Corporation’s not-for-profit parent, the Mozilla Foundation.
Portions of this content are ©1998–2026 by individual mozilla.org contributors. Content available under a Creative Commons license.