Error Handling

result = session.action("e14", "click")

if result.success:
    print(result.message)   # "Clicked Submit"
else:
    print(result.error)     # "Element e14 not found"

@dataclass
class ActionResult:
    success: bool       # True if the action succeeded
    message: str        # Human-readable description
    error: str | None   # Error details (None on success)

const result = await session.action("e14", "click");

if (result.success) {
  console.log(result.message);   // "Clicked Submit"
} else {
  console.error(result.error);   // "Element e14 not found"
}

interface ActionResult {
  success: boolean;    // true if the action succeeded
  message: string;     // Human-readable description
  error?: string;      // Error details (undefined on success)
}

result = session.action("e14", "click")

if not result.success:
    # UI may have changed — re-capture and retry
    session.snapshot()
    results = session.find(query="Submit")
    if results:
        result = session.action(results[0]["id"], "click")

let result = await session.action("e14", "click");

if (!result.success) {
  // UI may have changed — re-capture and retry
  await session.snapshot();
  const results = await session.find({ query: "Submit" });
  if (results.length > 0) {
    result = await session.action(results[0].id, "click");
  }
}

import cup

try:
    session = cup.Session()
    screen = session.snapshot()
except RuntimeError as e:
    print(f"Platform error: {e}")
    # Handle: missing dependencies, unsupported platform, etc.
except ImportError as e:
    print(f"Missing dependency: {e}")
    # Handle: optional dependency not installed

import { Session } from "computeruseprotocol";

try {
  const session = await Session.create();
  const screen = await session.snapshot();
} catch (e) {
  console.error(`Platform error: ${e}`);
  // Handle: missing dependencies, unsupported platform, etc.
}