KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

unittest.TestResult.errors — vastgelegde testfouten

`unittest.TestResult.errors` slaat het bij elke fout horende object en een opgemaakte traceback-tekst als paar op. Met de standaardwaarde voor `failureException` (`AssertionError`) worden mislukte assertions in testmethoden die niet met `expectedFailure` zijn gemarkeerd apart vastgelegd in `failures`.

Versie: 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 is een instantieattribuut, geen methode. Het bevat een lijst met tuples (test, traceback_text). Het eerste element is het object dat bij de fout hoort; het tweede is een opgemaakte traceback-tekst, geen exception-object. Als setUpClass bijvoorbeeld een uitzondering veroorzaakt, kan unittest een intern object als plaatsaanduiding gebruiken in plaats van een TestCase-instantie.

Bij een testmethode die niet met expectedFailure is gemarkeerd, gebruikt unittest het type failureException van het testgeval om mislukkingen van fouten te onderscheiden. Is de vast te leggen uitzondering van dat type of van een subklasse ervan, dan komt die in failures terecht; anders in errors. Standaard is failureException gelijk aan AssertionError. Daardoor komt een opgegooide ValueError in errors terecht en een mislukte assertion zoals self.assertEqual(1, 2) in failures. Als failureException is ingesteld op ValueError, komt een opgegooide ValueError in failures terecht in plaats van in errors. Een AssertionError die door setUpClass wordt opgegooid, wordt daarentegen vastgelegd in errors. Een mislukte assertion in een testmethode die met expectedFailure is gemarkeerd, wordt vastgelegd in expectedFailures. De standaardimplementatie van addError() voegt een item toe aan errors; normaal gesproken legt unittest de uitkomst automatisch vast.

Het voorbeeld toont beide uitkomsten met de standaardwaarde voor failureException bij testmethoden die niet met expectedFailure zijn gemarkeerd en controleert de opgeslagen tekst zonder variabele paden en regelnummers af te drukken. Een lege lijst errors bewijst niet dat alles is geslaagd: controleer result.wasSuccessful() om ook rekening te houden met andere niet-geslaagde uitkomsten.

Voorbeelden

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())

Resultaat

errors: 1
failures: 1
test: test_error
message present: True
successful: False

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen