StageException class
Exception thrown during stage execution.
Stage exceptions are retryable by default with a 1-second suggested delay, since transient failures at the stage level are common.
- Inheritance
-
- Object
- OpsException
- StageException
Constructors
-
StageException(String message, {String? code, required String stageId, String? handlerId, Map<
String, dynamic> ? details, StackTrace? stackTrace}) -
const
- StageException.fromError(Object error, {required String stageId, String? handlerId, StackTrace? stackTrace})
-
Create a StageException from an arbitrary error.
factory
Properties
- code → String?
-
Optional structured error code string (e.g. 'OPS-PIPE-001').
finalinherited
-
details
→ Map<
String, dynamic> ? -
Optional details providing additional context.
finalinherited
- handlerId → String?
-
Handler that was executing when the error occurred (if applicable).
final
- hashCode → int
-
The hash code for this object.
no setterinherited
- message → String
-
Human-readable error message.
finalinherited
- retryable → bool
-
Whether the operation that caused this exception can be retried.
no setteroverride
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
- stackTrace → StackTrace?
-
Optional stack trace captured at the point of error.
finalinherited
- stageId → String
-
Stage that raised the error.
final
- suggestedDelay → Duration
-
Suggested delay before retry. Returns Duration.zero for non-retryable.
no setteroverride
Methods
-
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
toString(
) → String -
A string representation of this object.
override
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited