AudioDecoder: isConfigSupported() static method
Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The isConfigSupported() static method of the AudioDecoder interface checks if the given config is supported (that is, if AudioDecoder objects can be successfully configured with the given config).
Syntax
js
AudioDecoder.isConfigSupported(config)
Parameters
config-
The dictionary object accepted by
AudioDecoder.configure
Return value
A Promise that resolves with an object containing the following members:
supported-
A boolean value which is
trueif the given config is supported by the decoder. config-
A copy of the given config with all the fields recognized by the decoder.
Exceptions
TypeError-
Thrown if the provided
configis invalid; that is, if doesn't have required values (such as an emptycodecfield) or has invalid values (such as a negativesampleRate).
Examples
The following example tests if the browser supports several audio codecs.
js
const codecs = ["mp4a.40.2", "mp3", "alaw", "ulaw"];
const configs = [];
for (const codec of codecs) {
configs.push({
codec,
sampleRate: 48000,
numberOfChannels: 1,
not_supported_field: 123,
});
}
for (const config of configs) {
const support = await AudioDecoder.isConfigSupported(config);
console.log(
`AudioDecoder's config ${JSON.stringify(support.config)} support: ${
support.supported
}`
);
}
Specifications
| Specification |
|---|
| WebCodecs # dom-audiodecoder-isconfigsupported |
Browser compatibility
BCD tables only load in the browser