WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen