aboutsummaryrefslogtreecommitdiffstats
path: root/googletest/docs/advanced.md
diff options
context:
space:
mode:
authorAbseil Team <absl-team@google.com>2020-03-23 15:15:58 -0400
committerXiaoyi Zhang <zhangxy@google.com>2020-03-24 17:32:07 -0400
commit1ced315a483f4ecac21893ce6ceeb502afb82eff (patch)
tree73b84f4009cf19cb136015069293276af561dda4 /googletest/docs/advanced.md
parent749148f1accc346d94825358a9a745b852961a11 (diff)
downloadgoogletest-1ced315a483f4ecac21893ce6ceeb502afb82eff.tar.gz
googletest-1ced315a483f4ecac21893ce6ceeb502afb82eff.tar.bz2
googletest-1ced315a483f4ecac21893ce6ceeb502afb82eff.zip
Googletest export
Add --gtest_fail_fast support to googletest. - Analogous functionality to to golang -test.failfast and python --failfast - Stops test execution upon first test failure. - Also add support Bazel equivalent env var (TESTBRIDGE_TEST_RUNNER_FAIL_FAST) PiperOrigin-RevId: 302488880
Diffstat (limited to 'googletest/docs/advanced.md')
-rw-r--r--googletest/docs/advanced.md9
1 files changed, 9 insertions, 0 deletions
diff --git a/googletest/docs/advanced.md b/googletest/docs/advanced.md
index 5677643d..1295c9dd 100644
--- a/googletest/docs/advanced.md
+++ b/googletest/docs/advanced.md
@@ -2116,6 +2116,15 @@ For example:
everything in test suite `FooTest` except `FooTest.Bar` and everything in
test suite `BarTest` except `BarTest.Foo`.
+#### Stop test execution upon first failure
+
+By default, a googletest program runs all tests the user has defined. In some
+cases (e.g. iterative test development & execution) it may be desirable stop
+test execution upon first failure (trading improved latency for completeness).
+If `GTEST_FAIL_FAST` environment variable or `--gtest_fail_fast` flag is set,
+the test runner will stop execution as soon as the first test failure is
+found.
+
#### Temporarily Disabling Tests
If you have a broken test that you cannot fix right away, you can add the