DispatcherError

Defined in: src/SystemMessages.ts:133

A unit of work scheduled on a dispatcher threw, and supervision was not going to hear about it.

Deliberately not an ActorLifecycleEvent: it is not a transition in an actor’s life, and its actor may be null — a task handed straight to dispatcher.execute belongs to no cell. Subscribing to the lifecycle base must not start delivering failures.

Everything supervision can catch is already caught before it gets here: a throw out of onReceive goes to the parent’s strategy. What lands on this channel is what supervision structurally cannot see — a failure in the machinery around the handler, or in a task the framework never owned. That makes it low-volume and worth alerting on, which is exactly why it needed a channel instead of a console line (#410).

Constructors

Constructor

new DispatcherError(dispatcherId, cause, actor?): DispatcherError

Defined in: src/SystemMessages.ts:134

Parameters

dispatcherId

string

id of the dispatcher whose unit failed.

cause

Error

The failure, normalised to an Error even when a non-Error was thrown.

actor?

ActorRef<unknown> | null

The actor whose turn failed, or null when the failing unit came straight from dispatcher.execute and belongs to no cell.

Returns

DispatcherError

Properties

actor

readonly actor: ActorRef<unknown> | null = null

Defined in: src/SystemMessages.ts:143

The actor whose turn failed, or null when the failing unit came straight from dispatcher.execute and belongs to no cell.

---

cause

readonly cause: Error

Defined in: src/SystemMessages.ts:138

The failure, normalised to an Error even when a non-Error was thrown.

---

dispatcherId

readonly dispatcherId: string

Defined in: src/SystemMessages.ts:136

id of the dispatcher whose unit failed.

Methods

toString()

toString(): string

Defined in: src/SystemMessages.ts:145

Returns

string