flutter_visual_test_runner library
Flutter Visual Test Runner - In-App Live Test Execution Dashboard.
Classes
- AssertionEngine
- Evaluates test assertions against the live Element tree with adaptive polling and async frame pumping.
- ControlBar
- Interactive execution control bar with Play, Pause, Resume, Step-Over, Speed selector, and Tag filters.
- FloatingBadge
- Draggable floating badge allowing quick monitoring and one-tap expansion of dashboard.
- FoundWidgetResult
- Represents the result of locating a widget in the live Element tree.
- GestureSimulator
- Simulates realistic pointer gestures and text input on live Flutter widgets.
- LogConsoleView
- Real-time live log console with log level filters, search, and expandable stack traces.
- NaturalLanguageTestParser
- Parses natural English text, markdown, or BDD-style lines into structured TestScenario, TestCase, and TestStep objects.
- RippleEffectPainter
- Dynamic touch ripple shockwave and simulated pointer cursor painter.
- RunnerLogEntry
- Represents a single execution log entry in the visual test runner console.
- RunnerTheme
- Ultra-modern glassmorphic dark theme colors and styles for the Visual Test Runner dashboard.
- ScenarioTreeView
- Collapsible tree view showing scenarios, cases, and steps with status icons and breakpoint controls.
- StepExecutionEngine
- Orchestrates live step execution by combining finder lookup, gesture simulation, assertions, and highlight notifications.
- StepStatusBanner
- Floating glassmorphic HUD pill at top of screen displaying active step execution state.
- TargetFinder
- Defines how the test runner locates a target widget in the live Flutter Element tree.
- TargetHighlightPainter
- High-tech animated neon bounding box and target ring painter.
- TestCase
- Represents a distinct test case comprising an ordered series of TestSteps.
- TestCaseConverter
-
Intelligent converter that transforms loose, high-level, or informal user test descriptions
(e.g.
test login,test dashboard,test add to cart, shorthand commands, or conversational steps) into canonical, structured, and executable Visual Test Runner specifications. - TestReport
- Aggregated execution report detailing duration, pass/fail metrics, step traces, and logs.
- TestReportExporter
- Exports TestReport into standalone JSON and HTML report files.
- TestRunnerController
- Central reactive state controller managing test suite lifecycle, execution, stepping, and speed.
- TestRunnerDashboard
- Full interactive glassmorphic dashboard panel.
- TestRunnerState
- Immutable snapshot representing the visual test runner's state at any point in time.
- TestScenario
- Represents a cohesive feature scenario grouping multiple related TestCases.
- TestSpecParser
- Parses test suites from JSON, YAML, or asset files.
- TestStep
- Defines an individual executable action, assertion, or wait step in a test case.
- TestSuite
- Top-level test suite container representing an entire test specification or manifest file.
- VisualOverlayLayer
- Top-level visual overlay layer that renders animated target widget highlights, pointer ripples, and active step status banners over the running application.
- VisualTestRunner
- Top-level wrapper widget that equips any Flutter application with the interactive visual test runner.
- WidgetFinderEngine
- Intelligent engine that inspects the live Flutter Element tree to locate widgets, compute screen geometry, and automatically resolve off-screen elements.
Enums
- FinderType
- Supported lookup strategies to locate widgets in the live Element tree.
- RunnerExecutionState
- Top-level runner execution lifecycle state.
- RunnerLogLevel
- Log levels for test execution console.
- TestStatus
- Execution status of a scenario, test case, or step.
- TestStepType
- Action types that a test step can execute.
Typedefs
-
StepExecutorCallback
= Future<
void> Function(TestStep step, BuildContext? context, TestRunnerController controller) - Signature for executing a single test step in the context of the live widget tree.