Class ControlError

Error subclass for UI5 control interaction failures.

Example

const error = new ControlError({
  message: 'Button not found',
  attempted: 'Find button with ID: submitBtn',
  suggestedSelector: { id: 'btn1' },
});

Hierarchy (View Summary)

PramanError
- ControlError

Index

Constructors

constructor

new ControlError(options: ControlErrorOptions): ControlError
Parameters
- options: ControlErrorOptions
Returns ControlError
Overrides PramanError.constructor
- Defined in core/errors/control-error.ts:70

Properties

`Readonly`attempted

attempted: string

`Readonly`availableControls

availableControls: readonly string[]

`Readonly`code

code: ErrorCode

`Readonly`details

details: Readonly<Record<string, unknown>>

`Readonly`lastKnownSelector

lastKnownSelector: UI5Selector | undefined

`Readonly`retryable

retryable: boolean

`Readonly`severity

severity: "error" | "info" | "warning"

`Readonly`suggestedSelector

suggestedSelector: UI5Selector | undefined

`Readonly`suggestions

suggestions: readonly string[]

`Readonly`timestamp

timestamp: string

Methods

toAIContext

toAIContext(): AIErrorContext & {
    availableControls: readonly string[];
    lastKnownSelector: UI5Selector
    | undefined;
    suggestedSelector: UI5Selector | undefined;
}
Returns structured context for AI agents to reason about the error.

Returns AIErrorContext & {
    availableControls: readonly string[];
    lastKnownSelector: UI5Selector | undefined;
    suggestedSelector: UI5Selector | undefined;
}
AI-friendly context object.
Remarks
Same as toJSON() but omits stack and name — AI agents don't need stack traces, and the error type is conveyed by code.
Example
```
const context = error.toAIContext();
// Send to LLM for self-healing analysis
```
Overrides PramanError.toAIContext
- Defined in core/errors/control-error.ts:100

toJSON

toJSON(): SerializedPramanError & {
    availableControls: readonly string[];
    lastKnownSelector: UI5Selector
    | undefined;
    suggestedSelector: UI5Selector | undefined;
}
Serializes the error to a plain JSON-safe object.

Returns SerializedPramanError & {
    availableControls: readonly string[];
    lastKnownSelector: UI5Selector | undefined;
    suggestedSelector: UI5Selector | undefined;
}
Structured representation with all diagnostic fields.
Example
```
const json = error.toJSON();
logger.debug(JSON.stringify(json, null, 2));
```
Overrides PramanError.toJSON
- Defined in core/errors/control-error.ts:87

toUserMessage

toUserMessage(): string
Formats the error for human-readable console output.

Returns string
Multi-line formatted string with all diagnostic sections.
Example
```
console.error(error.toUserMessage());
```
Inherited from PramanError.toUserMessage
- Defined in core/errors/base.ts:171

Class ControlError

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ControlError

Properties

`Readonly`attempted

`Readonly`availableControls

`Readonly`code

`Readonly`details

`Readonly`lastKnownSelector

`Readonly`retryable

`Readonly`severity

`Readonly`suggestedSelector

`Readonly`suggestions

`Readonly`timestamp

Methods

toAIContext

Returns AIErrorContext & {
    availableControls: readonly string[];
    lastKnownSelector: UI5Selector | undefined;
    suggestedSelector: UI5Selector | undefined;
}

Remarks

Example

toJSON

Returns SerializedPramanError & {
    availableControls: readonly string[];
    lastKnownSelector: UI5Selector | undefined;
    suggestedSelector: UI5Selector | undefined;
}

Example

toUserMessage

Returns string

Example

Settings

On This Page

Class ControlError

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns ControlError

Properties

Readonlyattempted

ReadonlyavailableControls

Readonlycode

Readonlydetails

ReadonlylastKnownSelector

Readonlyretryable

Readonlyseverity

ReadonlysuggestedSelector

Readonlysuggestions

Readonlytimestamp

Methods

toAIContext

Returns AIErrorContext & { availableControls: readonly string[]; lastKnownSelector: UI5Selector | undefined; suggestedSelector: UI5Selector | undefined;}

Remarks

Example

toJSON

Returns SerializedPramanError & { availableControls: readonly string[]; lastKnownSelector: UI5Selector | undefined; suggestedSelector: UI5Selector | undefined;}

Example

toUserMessage

Returns string

Example

Settings

On This Page

`Readonly`attempted

`Readonly`availableControls

`Readonly`code

`Readonly`details

`Readonly`lastKnownSelector

`Readonly`retryable

`Readonly`severity

`Readonly`suggestedSelector

`Readonly`suggestions

`Readonly`timestamp

Returns AIErrorContext & {
availableControls: readonly string[];
lastKnownSelector: UI5Selector | undefined;
suggestedSelector: UI5Selector | undefined;
}

Returns SerializedPramanError & {
availableControls: readonly string[];
lastKnownSelector: UI5Selector | undefined;
suggestedSelector: UI5Selector | undefined;
}