For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inSign up
Support
GuidesReferenceClick-to-Call
GuidesReferenceClick-to-Call
  • Core
    • Overview
  • Entities
    • SignalWire
    • Address
    • Participant
    • ClientPreferences
    • SelfCapabilities
    • SelfParticipant
    • User
    • WebRTCCall
      • CallCreateError
      • CollectionFetchError
      • DeviceTokenError
      • DPoPInitError
      • InvalidCredentialsError
      • MediaTrackError
      • MessageParseError
      • OverconstrainedFallbackError
      • PreflightError
      • RecoveryError
      • TokenRefreshError
      • UnexpectedError
      • VertoPongError
  • Web Components
    • Overview
    • sw-audio-level
    • sw-call-controls
    • sw-call-dialpad
    • sw-call-media
    • sw-call-provider
    • sw-call-status
    • sw-call-widget
    • sw-click-to-call
    • sw-device-selector
    • sw-directory
    • sw-local-camera
    • sw-participant-controls
    • sw-participants
    • sw-self-media
    • sw-ui-alert
    • sw-ui-background
    • sw-ui-call-layout
    • sw-ui-content-drawer
    • sw-ui-control-bar
    • sw-ui-dialpad
    • sw-ui-dropup
    • sw-ui-icon
    • sw-ui-modal
    • sw-ui-responsive-container
    • sw-ui-split-button
    • sw-ui-transcript-view
LogoLogoSignalWire Docs
Log inSign up
Support
On this page
  • Extends
  • Constructors
  • Constructor
  • Parameters
  • Properties
  • Examples
EntitiesErrors

OverconstrainedFallbackError

|View as Markdown|Open in Claude|
Was this page helpful?
Edit this page
Previous

PreflightError

Next
Built with

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}