EntitiesErrors

OverconstrainedFallbackError

View as MarkdownOpen in Claude

Raised by the device controller when getUserMedia rejects with OverconstrainedError and the SDK’s built-in fallback ladder — progressively relaxing the requested constraints — has been exhausted without finding a working set. The deviceKind property indicates whether the failure was on audio or video capture.

Extends

  • Error

Constructors

Constructor

1new OverconstrainedFallbackError(deviceKind, originalError?): OverconstrainedFallbackError

Parameters

deviceKind
stringRequired

Device kind whose constraints could not be satisfied (audio or video).

originalError
unknown

Final OverconstrainedError returned after all fallback levels were exhausted.

Properties

deviceKind
stringRequired

Device kind whose constraints could not be satisfied (audio or video).

originalError
unknown

Final OverconstrainedError returned after all fallback levels were exhausted.

Examples

1import { OverconstrainedFallbackError } from '@signalwire/js';
2
3try {
4  await client.enableVideoInput();
5} catch (err) {
6  if (err instanceof OverconstrainedFallbackError) {
7    console.error(`no working ${err.deviceKind} device available:`, err.originalError);
8    showPickerWithoutConstraints();
9  }
10}