Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

unittest.TestResult.errors — errori di test registrati

`unittest.TestResult.errors` memorizza coppie formate dall’oggetto associato a ciascun errore e da una stringa di traceback formattata. Con il valore predefinito di `failureException` (`AssertionError`), le asserzioni fallite nei metodi di test non contrassegnati con `expectedFailure` vengono registrate separatamente in `failures`.

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

Sintassi

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

unittest.TestResult.errors è un attributo di istanza, non un metodo. Contiene un elenco di tuple (test, traceback_text). Il primo elemento è l’oggetto associato all’errore; il secondo è una stringa di traceback formattata, non un oggetto eccezione. Per esempio, se setUpClass solleva un’eccezione, unittest può usare un oggetto interno come segnaposto al posto di un’istanza di TestCase.

Per un metodo di test non contrassegnato con expectedFailure, unittest distingue i fallimenti dagli errori in base al tipo failureException del caso di test. Se l’eccezione da registrare è di quel tipo o di una sua sottoclasse, finisce in failures; altrimenti finisce in errors. Per impostazione predefinita, failureException vale AssertionError: un’eccezione ValueError finisce quindi in errors, mentre il fallimento di un’asserzione come self.assertEqual(1, 2) finisce in failures. Se failureException è impostato su ValueError, un’eccezione ValueError finisce in failures anziché in errors. Se invece è setUpClass a sollevare AssertionError, l’eccezione viene registrata in errors. Il fallimento di un’asserzione in un metodo di test contrassegnato con expectedFailure viene registrato in expectedFailures. L’implementazione predefinita di addError() aggiunge una voce a errors; normalmente, unittest registra automaticamente il risultato.

L’esempio mostra entrambi gli esiti con il valore predefinito di failureException per metodi di test non contrassegnati con expectedFailure e controlla il testo memorizzato senza stampare percorsi e numeri di riga variabili. Un elenco errors vuoto non dimostra che tutto sia riuscito: controlla result.wasSuccessful() per tenere conto anche di altri esiti non riusciti.

Esempi

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

Risultato

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

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti