Praman — Agent-First SAP UI5 Test Automation Plugin - v1.2.0
    Preparing search index...

    Class BridgeError

    Error subclass for bridge adapter failures.

    Bridge injection and readiness contract — thrown only after injection attempt

    Injection timeout — bridge script failed to load within configured timeout

    Version mismatch — UI5 version incompatible with bridge capabilities

    Requires active browser session with UI5 application loaded

    const error = new BridgeError({
    message: 'Bridge not ready',
    attempted: 'Inject bridge adapter',
    });

    Hierarchy (View Summary)

    Index

    Constructors

    • Creates a new BridgeError instance.

      Parameters

      • options: BridgeErrorOptions

        Bridge error construction options including UI5 version and adapter type.

      Returns BridgeError

      import { BridgeError } from '#core/errors/bridge-error.js';

      const error = new BridgeError({
      message: 'Bridge injection timed out',
      attempted: 'Inject RecordReplay bridge adapter',
      ui5Version: '1.120.0',
      adapterType: 'record-replay',
      });

    Properties

    adapterType: string | undefined
    attempted: string
    code: ErrorCode
    details: Readonly<Record<string, unknown>>
    retryable: boolean
    severity: "error" | "info" | "warning"
    suggestions: readonly string[]
    timestamp: string
    ui5Version: string | undefined

    Methods

    • Returns structured context for AI agents with bridge diagnostics.

      Returns AIErrorContext & {
          adapterType: string | undefined;
          ui5Version: string | undefined;
      }

      Base AI context plus ui5Version and adapterType fields to help diagnose bridge injection and compatibility issues.

      const context = error.toAIContext();
      // context.ui5Version, context.adapterType available
      // Send to LLM for bridge troubleshooting or version compatibility analysis
    • Serializes the error to a JSON-safe object with bridge adapter fields.

      Returns SerializedPramanError & {
          adapterType: string | undefined;
          ui5Version: string | undefined;
      }

      Base fields plus ui5Version and adapterType.

      const json = error.toJSON();
      // json.ui5Version === '1.120.0'
      // json.adapterType === 'record-replay'
    • Formats the error for human-readable console output.

      Returns string

      Multi-line formatted string with all diagnostic sections.

      console.error(error.toUserMessage());