WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

unittest.TestResult.wasSuccessful — Testergebnisse prüfen

Die Methode wasSuccessful() meldet, ob die bisher erfassten Testergebnisse keine Fehlschläge, Fehler oder unerwarteten Erfolge enthalten. Sie führt selbst keine Tests aus.

Version: Python 3.14; repository image, production runtime not attested

Syntax

result.wasSuccessful()

unittest.TestResult.wasSuccessful() ist eine Instanzmethode, die ohne Argumente als result.wasSuccessful() aufgerufen wird. Sie gibt einen bool zurück, der die bisher in result erfassten Ergebnisse zusammenfasst; Tests führt sie nicht aus.

Die Standardimplementierung gibt False zurück, wenn failures, errors oder unexpectedSuccesses nicht leer sind. Übersprungene Tests (skipped) und erwartete Fehlschläge (expectedFailures) führen für sich allein nicht zu False. Ein bestandener Test mit dem Dekorator @unittest.expectedFailure ist ein unerwarteter Erfolg und führt zu False.

Ein leeres Ergebnis liefert True: Das beweist weder, dass Tests ausgeführt wurden, noch dass die gesamte Testsuite abgeschlossen ist. Prüfe auch testsRun, wenn Tests ausgeführt worden sein müssen. Das Beispiel führt ausdrücklich zwei Tests aus und sammelt ihre Ergebnisse in einem Objekt.

Beispiele

import unittest

class Checks(unittest.TestCase):
    def test_pass(self):
        self.assertEqual(2 + 2, 4)

    @unittest.expectedFailure
    def test_unexpected_success(self):
        self.assertTrue(True)

result = unittest.TestResult()
print(result.testsRun, result.wasSuccessful())
Checks('test_pass').run(result)
print(result.testsRun, result.wasSuccessful())
Checks('test_unexpected_success').run(result)
print(result.testsRun, result.wasSuccessful())

Ergebnis

0 True
1 True
2 False

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen