← 返回首页

VideoEncoder: isConfigSupported() static method - Web APIs | MDN

Toggle sidebar

Theme

OS default
Light
Dark

English (US)

Remember language Learn more

VideoEncoder: isConfigSupported() static method

Limited availability

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 isConfigSupported() static method of the VideoEncoder interface checks if VideoEncoder can be successfully configured with the given config.

In this article

Syntax

js

VideoEncoder.isConfigSupported(config)

Parameters

config

The dictionary object accepted by VideoEncoder.configure

Return value

A Promise that resolves with an object containing the following members:

A boolean value which is true if the given config is supported by the encoder.

A copy of the given config with all the fields recognized by the encoder.

Exceptions

Thrown if the provided config is invalid; that is, if doesn't have required values (such as an empty codec field) or has invalid values (such as a negative width)

Examples

The following example tests if the browser supports accelerated and un-accelerated versions of several video codecs.

js
const codecs = [
  "avc1.420034",
  "hvc1.1.6.L123.00",
  "vp8",
  "vp09.00.10.08",
  "av01.0.04M.08",
];
const accelerations = ["prefer-hardware", "prefer-software"];

const configs = [];
for (const codec of codecs) {
  for (const acceleration of accelerations) {
    configs.push({
      codec,
      hardwareAcceleration: acceleration,
      width: 1280,
      height: 720,
      bitrate: 2_000_000,
      bitrateMode: "constant",
      framerate: 30,
      not_supported_field: 123,
    });
  }
}

for (const config of configs) {
  const support = await VideoEncoder.isConfigSupported(config);
  console.log(
    `VideoEncoder's config ${JSON.stringify(support.config)} support: ${
      support.supported
    }`,
  );
}

Specifications

Specification

WebCodecs
# dom-videoencoder-isconfigsupported

Browser compatibility

Enable JavaScript to view this browser compatibility table.

See also

Help improve MDN

Was this page helpful to you?

Yes No

Learn how to contribute

This page was last modified on Feb 9, 2026 by MDN contributors.

View this page on GitHub • Report a problem with this content

WebCodecs API
VideoEncoder
Constructor
1. VideoEncoder()
Instance properties
1. encodeQueueSize
2. state
Static methods
1. isConfigSupported()
Instance methods
Events
1. dequeue
Inheritance
1. EventTarget
Related pages for WebCodecs API
Guides