Link Search Menu Expand Document

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
Advice
You should first run your tests in debug mode(4) to get the failure line in the report.
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
Advice
Whats the difference between errors and failures?
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.

Advice
By double-clicking, you can jump directly to the test or test error if an failure line reported Debug Mode(4).

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.



Copyright © 2021-2022 Mike Schulze. Distributed by an MIT license.