What problem does it solve?
Provides structured, event-driven hooks into TestBox test runs so you can monitor progress, capture failures, and react to lifecycle events without invasive changes to test suites or reporters.
Core Features & Use Cases
- Lifecycle Callbacks: Receive onBundleStart, onBundleEnd, onSuiteStart, onSuiteEnd, onSpecStart, and onSpecEnd events with detailed results structs for real-time reaction.
- Integrations & Reporting: Build progress bars, live dashboards, CI annotations, or custom loggers that respond to each spec or suite as it executes.
- Reusable Patterns: Use closures or class-based listeners to aggregate failures, profile timings, or emit external notifications (webhooks, Slack, observability systems).
- Use Case: Stream test run events to a CI pipeline to generate immediate GitHub Actions annotations for failing specs and a summary report at bundle end.
Quick Start
Use the testbox-listeners skill to capture onSpecEnd failures and emit GitHub Actions annotations in real time.