Toolkit

Detect Form Errors

Scans the current page for visible validation errors, required-field failures, and other messages that explain why a flow is blocked.

What It Does

Detect Form Errors is a diagnostic tool for moments when a page refuses to move forward. It surfaces the visible reasons a submit, next-step action, or completion attempt failed.

How It Works

  • Runs a page command dedicated to error detection.
  • Can optionally include iframe content when needed.
  • Returns structured error data instead of trying to fix the page automatically.
  • Logs the result for downstream tools or manual review.

Best For

  • After submit failures
  • Forms that block progression without obvious explanation
  • Workflows that need a clear reason before choosing the next action

Behavior Notes

  • It is diagnostic, not corrective.
  • It is most useful right after a failed submit or blocked next-step transition.