CKTIS / Python
unittest.TestResult.failures — Liste der Assertionsfehler
unittest.TestResult.failures speichert Assertionsfehler als Paare aus einem Testobjekt und formatiertem Traceback-Text.
Version: Python 3.14; repository image, production runtime not attested
Syntax
result.failures
for test, traceback_text in result.failures:
...unittest.TestResult.failures ist ein Instanzattribut, keine Methode. Es enthält eine Liste von (test, traceback_text)-Paaren: ein TestCase-Objekt und einen formatierten Traceback-String. Lies den Wert nach dem Ausführen der Tests aus dem Ergebnisobjekt aus.
Wenn unittest eine Ausnahme aus einer gewöhnlichen Testmethode als Fehlschlag oder Fehler einstuft, verwendet es den Typ failureException des Testfalls. Ausnahmen dieses Typs oder seiner Unterklassen landen in failures, andere Ausnahmen in errors. Der Standardtyp ist AssertionError; diese Ausnahme wird beispielsweise bei einem fehlgeschlagenen Aufruf von assertEqual() ausgelöst. Ein in setUpClass ausgelöster AssertionError landet dagegen in errors. Erwartete Fehlschläge werden separat in expectedFailures gespeichert. Eine leere Liste failures beweist daher nicht, dass die gesamte Testsuite erfolgreich war.
Das Beispiel erzeugt absichtlich einen Fehlschlag. Es prüft die Struktur des Eintrags, ohne den Traceback auszugeben, dessen Pfade und Zeilennummern von der Datei abhängen.
Beispiele
import unittest
class SampleTest(unittest.TestCase):
def test_total(self):
self.assertEqual(2 + 2, 5)
result = unittest.TestResult()
SampleTest("test_total").run(result)
test, traceback_text = result.failures[0]
print("test:" if False else "failures:", len(result.failures))
print("test:", test.id())
print("traceback is text:", isinstance(traceback_text, str))
print("errors:", len(result.errors))Ergebnis
failures: 1 test: __main__.SampleTest.test_total traceback is text: True errors: 0
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.