Class ControlError

constructor

• new ControlError(options: ControlErrorOptions): ControlError

  Creates a new ControlError instance.

  Parameters

  • options: ControlErrorOptions

    Control error construction options including self-healing selector fields.

  Returns ControlError

  Example

  import { ControlError } from '#core/errors/control-error.js';
  
  const error = new ControlError({
    message: 'Control not found: submitBtn',
    attempted: 'Find control with ID: submitBtn',
    lastKnownSelector: { id: 'oldSubmitBtn' },
    availableControls: ['btn1', 'btn2'],
    suggestedSelector: { id: 'btn1' },
  });
  Copy

ReadonlyavailableControls

ReadonlylastKnownSelector

ReadonlysuggestedSelector

toAIContext

• toAIContext(): AIErrorContext & {
      availableControls: readonly string[];
      lastKnownSelector: UI5Selector
      | undefined;
      suggestedSelector: UI5Selector | undefined;
  }

  Returns structured context for AI agents with control self-healing fields.

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

  Base AI context plus lastKnownSelector, availableControls, and suggestedSelector fields to enable AI-driven selector correction.

  Example

  const context = error.toAIContext();
  // context.lastKnownSelector — the selector that previously worked
  // context.availableControls — controls currently in the view
  // context.suggestedSelector — best-match selector suggestion
  Copy

toJSON

• toJSON(): SerializedPramanError & {
      availableControls: readonly string[];
      lastKnownSelector: UI5Selector
      | undefined;
      suggestedSelector: UI5Selector | undefined;
  }

  Serializes the error to a JSON-safe object with control interaction fields.

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

  Base fields plus lastKnownSelector, availableControls, and suggestedSelector.

  Example

  const json = error.toJSON();
  // json.lastKnownSelector === { id: 'oldSubmitBtn' }
  // json.availableControls === ['btn1', 'btn2']
  // json.suggestedSelector === { id: 'btn1' }
  Copy