Skip to main content
Version: 5.9.x

aspect test

Build the specified targets and run all test targets among them


Runs test targets and reports the test results.


First, the targets are built. See 'aspect help build' for more about the phases of a build. By default, any targets that match the pattern(s) are built, even if they are not needed as inputs to any test target. Use --build_tests_only to avoid building these targets.

Targets may be filtered from the pattern. See

  • by size, using --test_size_filters often used to select only "unit tests"
  • by timeout, using --test_timeout_filters often used to select only fast tests,
  • by tag, using --test_tag_filters
  • by language, using --test_lang_filters though it only understands those built-in to Bazel. Follow

The tests are run following a well-specified contract between Bazel and the test runner process, see

This command accepts all valid options to 'build', and inherits defaults for 'build' from your .bazelrc. If you don't use .bazelrc, don't forget to pass all your 'build' options to 'test' too.

See 'aspect help target-syntax' for details and examples on how to specify targets.

aspect test [--build_tests_only] <target pattern> [<target pattern> ...] [flags]


  -h, --help   help for test

Options inherited from parent commands

      --aspect:config string   User-specified Aspect CLI config file. /dev/null indicates that all further --aspect:config flags will be ignored.
--aspect:interactive Interactive mode (e.g. prompts for user input)