CKTIS / Python
unittest.TestResult.errors — erros de teste registados
`unittest.TestResult.errors` guarda pares constituídos pelo objeto associado a cada erro e por uma cadeia de traceback formatada. Com o valor predefinido de `failureException` (`AssertionError`), as falhas de asserção em métodos de teste não marcados com `expectedFailure` são registadas separadamente em `failures`.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
result.errors # result is an instance of unittest.TestResult
for test, traceback_text in result.errors:
...unittest.TestResult.errors é um atributo de instância, não um método. Contém uma lista de tuplos (test, traceback_text). O primeiro elemento é o objeto associado ao erro; o segundo é uma cadeia de traceback formatada, não um objeto de exceção. Por exemplo, se setUpClass lançar uma exceção, unittest pode usar um objeto interno em vez de uma instância de TestCase.
Num método de teste não marcado com expectedFailure, unittest distingue as falhas dos erros com base no tipo failureException do caso de teste. Se a exceção a registar for desse tipo ou de uma subclasse, é registada em failures; caso contrário, é registada em errors. Por predefinição, failureException é AssertionError, pelo que uma exceção ValueError é registada em errors, enquanto uma falha de asserção, como a de self.assertEqual(1, 2), é registada em failures. Se failureException estiver definido como ValueError, uma exceção ValueError é registada em failures em vez de errors. Se for setUpClass a lançar AssertionError, a exceção é registada em errors. Uma falha de asserção num método de teste marcado com expectedFailure é registada em expectedFailures. A implementação predefinida de addError() acrescenta uma entrada a errors; normalmente, unittest regista automaticamente o resultado.
O exemplo mostra ambos os resultados com o valor predefinido de failureException para métodos de teste não marcados com expectedFailure e verifica o texto armazenado sem imprimir caminhos e números de linha variáveis. Uma lista errors vazia não prova que tudo tenha sido bem-sucedido: verifica result.wasSuccessful() para ter em conta também outros resultados sem sucesso.
Exemplos
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())Resultado
errors: 1 failures: 1 test: test_error message present: True successful: False
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.