EZ Web Audio / AudioError

Class: AudioError

Defined in: packages/core/src/errors/audio-error.ts:25

Base error class for all audio-related errors.

Provides a consistent error structure with optional error codes for programmatic error handling. Subclasses add specific context like URL, note identifier, or AudioContext state.

Subclasses include ValidationError (invalid parameters or API misuse), AudioLoadError (fetch/decode failures), AudioContextError (AudioContext state issues), and InvalidNoteError (bad note identifiers).

Example

import { AudioError } from 'ez-web-audio'

try {
  await sound.play()
} catch (e) {
  if (e instanceof AudioError) {
    console.error(`Audio error [${e.code}]: ${e.message}`)
  }
}

Extends

• Error

Extended by

• AggregateAudioLoadError
• AudioContextError
• AudioLoadError
• InvalidNoteError
• ValidationError

Constructors

Constructor

new AudioError(message, code?): AudioError

Defined in: packages/core/src/errors/audio-error.ts:32

Create a new AudioError.

Parameters

message

string

Human-readable error description with actionable fix

code?

string

Optional error code for programmatic handling

Returns

AudioError

Overrides

Error.constructor

Properties

code?

readonly optional code: string

Defined in: packages/core/src/errors/audio-error.ts:34

Optional error code for programmatic handling