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

RecoveryError

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

TokenRefreshError

Next
Built with

Raised when the SDK’s automatic call-recovery flow fails — for example, after a transient signaling disconnect that exceeds maxRecoveryAttempts. The action and attempt properties identify which recovery step gave up. When this fires the call has transitioned to failed; clean up UI and notify the user.

Extends

  • Error

Constructors

Constructor

1new RecoveryError(action, attempt, originalError?): RecoveryError

Parameters

action
stringRequired

Recovery action being attempted when the error was raised.

attempt
numberRequired

Recovery attempt number (1-based) at the time of failure.

originalError
unknown

Underlying error that caused the recovery attempt to fail.

Properties

action
stringRequired

Recovery action being attempted when the error was raised.

attempt
numberRequired

Recovery attempt number (1-based) at the time of failure.

originalError
unknown

Underlying error that caused the recovery attempt to fail.

Examples

1import { RecoveryError } from '@signalwire/js';
2
3call.errors$.subscribe((err) => {
4 if (err instanceof RecoveryError) {
5 console.error(`recovery action ${err.action} failed on attempt ${err.attempt}`);
6 teardownCallUI();
7 }
8});