KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

unittest.TestResult.failures — lijst met assertionfouten

unittest.TestResult.failures slaat assertionfouten op als paren met een testobject en geformatteerde tracebacktekst.

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

Syntax

result.failures
for test, traceback_text in result.failures:
    ...

unittest.TestResult.failures is een instantieattribuut, geen methode. Het bevat een lijst met (test, traceback_text)-paren: een TestCase-object en een tekenreeks met een geformatteerde traceback. Lees dit attribuut uit op het resultaatobject nadat de tests zijn uitgevoerd.

Om te bepalen of een uitzondering uit een gewone testmethode een mislukking of een fout is, gebruikt unittest het type failureException van het testgeval. Uitzonderingen van dat type of van een subklasse ervan komen in failures; andere uitzonderingen komen in errors. Het standaardtype is AssertionError, bijvoorbeeld bij een mislukte aanroep van assertEqual(). Een AssertionError die in setUpClass optreedt, komt daarentegen in errors. Verwachte mislukkingen worden apart opgeslagen in expectedFailures. Een lege lijst failures bewijst dus niet dat de hele testsuite is geslaagd.

Het voorbeeld laat bewust één test mislukken. Het controleert de structuur van het item zonder de traceback af te drukken; de paden en regelnummers daarvan hangen af van het bestand.

Voorbeelden

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

Resultaat

failures: 1
test: __main__.SampleTest.test_total
traceback is text: True
errors: 0

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