CKTIS / Python
unittest.TestResult.errors — erfasste Testfehler
`unittest.TestResult.errors` speichert jeweils das dem Fehler zugeordnete Objekt und eine formatierte Traceback-Zeichenfolge als Paar. Mit dem Standardwert `AssertionError` für `failureException` werden fehlgeschlagene Assertions in Testmethoden ohne `expectedFailure` separat in `failures` erfasst.
Version: Python 3.14; repository image, production runtime not attested
Syntax
result.errors # result is an instance of unittest.TestResult
for test, traceback_text in result.errors:
...unittest.TestResult.errors ist ein Instanzattribut, keine Methode. Es enthält eine Liste von Tupeln (test, traceback_text). Das erste Element ist das dem Fehler zugeordnete Objekt; das zweite ist eine formatierte Traceback-Zeichenfolge, kein Ausnahmeobjekt. Löst beispielsweise setUpClass eine Ausnahme aus, kann unittest statt einer TestCase-Instanz ein internes Platzhalterobjekt verwenden.
Bei einer Testmethode ohne expectedFailure unterscheidet unittest anhand des Typs failureException des Testfalls zwischen Fehlschlägen und Fehlern. Ist die zu erfassende Ausnahme von diesem Typ oder einem davon abgeleiteten Typ, wird sie in failures eingetragen, andernfalls in errors. Standardmäßig ist failureException auf AssertionError gesetzt. Daher landet ein ausgelöster ValueError in errors, eine fehlgeschlagene Assertion wie self.assertEqual(1, 2) dagegen in failures. Ist failureException auf ValueError gesetzt, landet ein ausgelöster ValueError stattdessen in failures. Löst jedoch setUpClass einen AssertionError aus, wird dieser in errors erfasst. Schlägt eine Assertion in einer mit expectedFailure markierten Testmethode fehl, wird sie in expectedFailures erfasst. Die Standardimplementierung von addError() hängt einen Eintrag an errors an; normalerweise erfasst unittest das Ergebnis automatisch.
Das Beispiel zeigt beide Ergebnisse mit dem Standardwert für failureException bei Testmethoden ohne expectedFailure und prüft den gespeicherten Text, ohne variable Pfade und Zeilennummern auszugeben. Eine leere Liste errors beweist keinen Erfolg: Prüfe result.wasSuccessful(), um auch andere erfolglose Ergebnisse zu berücksichtigen.
Beispiele
import unittest
class Demo(unittest.TestCase):
def test_error(self):
raise ValueError("demo")
def test_failure(self):
self.assertEqual(1, 2)
suite = unittest.TestSuite([
Demo("test_error"),
Demo("test_failure"),
])
result = unittest.TestResult()
suite.run(result)
print("errors:", len(result.errors))
print("failures:", len(result.failures))
test, traceback_text = result.errors[0]
print("test:", test.id().rsplit(".", 1)[-1])
print("message present:", "ValueError: demo" in traceback_text)
print("successful:", result.wasSuccessful())Ergebnis
errors: 1 failures: 1 test: test_error message present: True successful: 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.