Class ErrorHandler

Centralized error handler

Index

Constructors

Properties

errors externalLogger listeners maxErrors

Methods

addListener clearErrors formatError getRecentErrors handle handleAndThrow handleError notifyListeners removeListener setExternalLogger withRetry

Constructors

constructor

new ErrorHandler(): ErrorHandler
Returns ErrorHandler

Properties

`Private` `Static`errors

errors: ShogunError[] = []

`Private` `Static`externalLogger

externalLogger: null | (error: ShogunError) => void = null

`Private` `Static`listeners

listeners: (error: ShogunError) => void[] = []

`Private` `Static`maxErrors

maxErrors: number = 100

Methods

`Static`addListener

addListener(listener: (error: ShogunError) => void): void
Adds a listener for errors
Parameters
- listener: (error: ShogunError) => void
  Function that will be called when an error occurs
Returns void

`Static`clearErrors

clearErrors(): void
Clear all stored errors

Returns void

`Static`formatError

formatError(error: unknown): string
Helper function to format error messages from native errors
Parameters
- error: unknown
  Error to format
Returns string
Formatted error message

`Static`getRecentErrors

getRecentErrors(count?: number): ShogunError[]
Retrieves the last N errors
Parameters
- count: number = 10
  Number of errors to retrieve
Returns ShogunError[]
List of most recent errors

`Static`handle

handle(
    type: ErrorType,
    code: string,
    message: string,
    originalError?: unknown,
    logLevel?: LogLevel,
): ShogunError
Handles a raw error by converting it to ShogunError
Parameters
- type: ErrorType
  Error type
- code: string
  Error code
- message: string
  Error message
- OptionaloriginalError: unknown
  Original error
- logLevel: LogLevel = "error"
  Log level for the error
Returns ShogunError

`Static`handleAndThrow

handleAndThrow(
    type: ErrorType,
    code: string,
    message: string,
    originalError?: unknown,
): never
Handles errors and throws them as standardized ShogunError objects
Parameters
- type: ErrorType
  Error type
- code: string
  Error code
- message: string
  Error message
- OptionaloriginalError: unknown
  Original error
Returns never
Throws
ShogunError

`Static`handleError

handleError(error: ShogunError): void
Handles an error by logging it and notifying listeners
Parameters
- error: ShogunError
  The error to handle
Returns void

`Private` `Static`notifyListeners

notifyListeners(error: ShogunError): void
Notifies all listeners of an error
Parameters
- error: ShogunError
  Error to notify
Returns void

`Static`removeListener

removeListener(listener: (error: ShogunError) => void): void
Removes an error listener
Parameters
- listener: (error: ShogunError) => void
  Function to remove
Returns void

`Static`setExternalLogger

setExternalLogger(logger: (error: ShogunError) => void): void
Set an external logging service for production error monitoring
Parameters
- logger: (error: ShogunError) => void
  External logger function to send errors to a monitoring service
Returns void

`Static`withRetry

withRetry<T>(
    fn: () => Promise<T>,
    errorType: ErrorType,
    errorCode: string,
    maxRetries?: number,
    retryDelay?: number,
): Promise<T>
Error handling with retry logic
Type Parameters
- T
Parameters
- fn: () => Promise<T>
- errorType: ErrorType
- errorCode: string
- maxRetries: number = 3
- retryDelay: number = 1000
Returns Promise<T>