Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

unittest.TestResult.failures — lista niepowodzeń asercji

unittest.TestResult.failures przechowuje niepowodzenia asercji jako pary obiektu testu i tekstu stosu wywołań.

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

Składnia

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

unittest.TestResult.failures to atrybut instancji, nie metoda. Zawiera listę par (test, traceback_text): obiektu TestCase oraz napisu ze sformatowanym stosem wywołań. Odczytuj go z obiektu wyniku po uruchomieniu testów.

Gdy unittest klasyfikuje wyjątek ze zwykłej metody testowej jako niepowodzenie lub błąd, używa typu failureException danego przypadku testowego. Wyjątki tego typu lub jego podtypów trafiają do failures, a pozostałe do errors. Domyślnym typem jest AssertionError, zgłaszany na przykład przez nieudaną asercję assertEqual(). Natomiast AssertionError zgłoszony w setUpClass trafia do errors. Oczekiwane niepowodzenia są przechowywane osobno w expectedFailures. Pusta lista failures nie dowodzi więc powodzenia całego zestawu.

Przykład celowo powoduje jedno niepowodzenie. Sprawdza strukturę wpisu bez wypisywania stosu wywołań, którego ścieżki i numery wierszy zależą od pliku.

Przykłady

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

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła