You're reading the documentation for a version of ROS 2 that has reached its EOL (end-of-life), and is no longer officially supported. If you want up-to-date information, please have a look at Iron.
Running Tests in ROS 2 from the Command Line
Build and run your tests
To compile and run the tests, simply run the test verb from
colcon test --ctest-args tests [package_selection_args]
package_selection_args are optional package selection arguments for
colcon to limit which packages are built and run)
Sourcing the workspace before testing should not be necessary.
colcon test makes sure that the tests run with the right environment, have access to their dependencies, etc.
Examine Test Results
To see the results, simply run the test-result verb from
colcon test-result --all
To see the exact test cases which fail, use the
colcon test-result --all --verbose