Hex1bAutomationException

Namespace: Hex1b.Automation

Assembly: Hex1b.dll

Exception thrown by when an automation step fails. Includes rich diagnostic information including the full step history, terminal snapshot, and source location to help pinpoint the failure.

public sealed class Hex1bAutomationException : Exception, ISerializable

Inheritance

Object → Exception → Hex1bAutomationException

Implements

• ISerializable

Properties

CallerFilePath

Gets the source file path where the failing automator method was called.

Returns: String

public string? CallerFilePath { get; }

CallerLineNumber

Gets the line number where the failing automator method was called.

Returns: Nullable<Int32>

public int? CallerLineNumber { get; }

CompletedSteps

Gets all steps that completed successfully before the failure.

Returns: IReadOnlyList<AutomationStepRecord>

public IReadOnlyList<AutomationStepRecord> CompletedSteps { get; }

FailedStepDescription

Gets the description of the step that failed (e.g., "WaitUntilText("File")").

Returns: String

public string FailedStepDescription { get; }

FailedStepElapsed

Gets how long the failed step was executing before it failed.

Returns: TimeSpan

public TimeSpan FailedStepElapsed { get; }

FailedStepIndex

Gets the 1-based index of the step that failed.

Returns: Int32

public int FailedStepIndex { get; }

TerminalSnapshot

Gets the terminal snapshot captured at the time of failure. This is taken from the inner when available, or captured directly from the terminal otherwise.

Returns: Hex1bTerminalSnapshot

public Hex1bTerminalSnapshot? TerminalSnapshot { get; }

TotalElapsed

Gets the total elapsed time across all steps (completed + failed).

Returns: TimeSpan

public TimeSpan TotalElapsed { get; }