The GdUnit Test Inspector/Explorer
Definition
The GdUnit inspector gives an overview of the currently executed tests and allows you to navigate over them. This allows you to select individual tests and view possible test failures for them. The integrated status and info bar gives you a quick overview of the last test run.
Button Bar
This bar contains a number of buttons that allow you to open the documentation or configure the execution behavior of GdUnit, as well as restart the last executed tests.
Button | Description |
---|---|
(1) | Opens the browser to the GdUnit documentation page |
(2) | Opens the GdUnit settings |
(3) | (Re)Run test’s (Runtime mode) |
(4) | (Re)Run debug test’s (Debug mode)) |
(5) | Stops current test run |
(6) | GdUnit version info |
Godot does not provide stack trace information when running in runtime mode(3) and therefore will not display an failure line in the report.
Status Bar
This area gives you information about the current/last test execution, such as the progress and errors/failures found.
With the arrow buttons you can navigate back and forth over found failures.
Button | Description |
---|---|
(1) | Test execution progress (indicator of testrun) |
(2) | Number of errors found |
(3) | Number of failures found |
(4) | Navigate to previous failure |
(5) | Navigate to next failure |
GdUnit distinguishes between errors and failures. An error is a hard failure such as a test abort or timeout, while a failure is a test error caused by a failed assertion.
Testrun Overview
This area gives you an overview of all executed/executing tests and their execution status in real time.
Here you can navigate through the tests and view the report for each individual test by selecting it. With a right click you can open a context menu and run the currently selected test or test suite again.
Failure Report
This area displays the failure report of the currently selected failed test.
GdUnit generates the failure report based on the used assert according to the scheme expected vs current value.
Info Bar
This section provides you with information about the total duration of the test execution and about any orphaned nodes found.