Class NavigationError

constructor

• new NavigationError(options: NavigationErrorOptions): NavigationError

  Creates a new NavigationError instance.

  Parameters

  • options: NavigationErrorOptions

    Navigation error construction options including target and current URLs for diagnostic context.

  Returns NavigationError

  Example

  import { NavigationError } from '#core/errors/navigation-error.js';
  
  const error = new NavigationError({
    message: 'FLP tile not found',
    attempted: 'Navigate to Purchase Order app',
    targetUrl: 'https://sap.example.com/app/po',
    currentUrl: 'https://sap.example.com/flp',
  });
  Copy

ReadonlycurrentUrl

ReadonlytargetUrl

toAIContext

• toAIContext(): AIErrorContext & {
      currentUrl: string
      | undefined;
      targetUrl: string | undefined;
  }

  Returns AI-agent-friendly context with navigation-specific diagnostic fields.

  Returns AIErrorContext & {
      currentUrl: string | undefined;
      targetUrl: string | undefined;
  }

  Base AI context extended with target and current URL details.

  Example

  const ctx = error.toAIContext();
  // LLM can compare ctx.targetUrl and ctx.currentUrl to diagnose
  // whether navigation started but resolved to the wrong view
  Copy

toJSON

• toJSON(): SerializedPramanError & {
      currentUrl: string
      | undefined;
      targetUrl: string | undefined;
  }

  Serializes this error to a JSON-safe object with navigation-specific fields.

  Returns SerializedPramanError & {
      currentUrl: string | undefined;
      targetUrl: string | undefined;
  }

  Base serialization extended with targetUrl and currentUrl.

  Example

  const json = error.toJSON();
  console.log(json.targetUrl);  // 'https://sap.example.com/app/po'
  console.log(json.currentUrl); // 'https://sap.example.com/flp'
  Copy