Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

unittest.TestResult.errors — lista błędów testów

`unittest.TestResult.errors` przechowuje pary złożone z obiektu powiązanego z błędem i sformatowanego tekstu śladu stosu. Przy domyślnym `failureException` (`AssertionError`) niepowodzenia asercji w metodach testowych nieoznaczonych przez `expectedFailure` trafiają na osobną listę `failures`.

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

Składnia

result.errors  # result is an instance of unittest.TestResult
for test, traceback_text in result.errors:
    ...

unittest.TestResult.errors jest atrybutem instancji, nie metodą. Zawiera listę krotek (test, traceback_text). Pierwszy element to obiekt powiązany z błędem; drugi to sformatowany tekst śladu stosu, a nie obiekt wyjątku. Jeśli na przykład setUpClass zgłosi wyjątek, unittest może użyć wewnętrznego obiektu zastępczego zamiast instancji TestCase.

W przypadku metody testowej nieoznaczonej przez expectedFailure mechanizm unittest rozróżnia niepowodzenia i błędy na podstawie typu failureException danego przypadku testowego. Jeśli rejestrowany wyjątek jest tego typu lub typu pochodnego, trafia do failures; w przeciwnym razie trafia do errors. Domyślnie failureException to AssertionError, więc zgłoszony ValueError trafia do errors, a niepowodzenie asercji takiej jak self.assertEqual(1, 2) — do failures. Jeśli jednak failureException ustawiono na ValueError, zgłoszony ValueError trafi do failures, a nie do errors. Jeśli AssertionError zgłosi setUpClass, zostanie on zapisany w errors. Niepowodzenie asercji w metodzie testowej oznaczonej przez expectedFailure trafia do expectedFailures. Standardowa implementacja addError() dopisuje wpis do errors; zwykle wynik zapisuje sam mechanizm unittest.

Przykład pokazuje oba wyniki przy domyślnym failureException dla metod testowych nieoznaczonych przez expectedFailure i sprawdza zapisany tekst bez drukowania zmiennych ścieżek i numerów linii. Puste errors nie dowodzi sukcesu: sprawdź result.wasSuccessful(), aby uwzględnić także inne wyniki powodujące niepowodzenie.

Przykłady

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

Wynik

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

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

Źródła