XCTestXCTAssertThrowsErrorEqual

Releyendo el libro Diseño Ágil con TDD de Carlos Blé Jurado (que recomiendo ampliamente) y practicando los ejercicios que incluye, he hecho esta extensión de XCTest que es función de test que evalúa 3 cosas:

• que se lance un error
• que el error sea del tipo especificado
• que sea de un caso en específico

1) La cabecera

Primero debemos definir el genérico, en este caso esperamos un Error y que sea Equatable para poder compararlo.

El autoclosure es una técnica que permite esperar a evaluar una expresión hasta el momento en que lo necesitemos.

En este ejemplo, la función es isStrongPassword por que lo expression devuelve un Bool, y necesitamos que espere hasta que sea evaluada por  XCTAssertThrowsError

De la que esperamos que lance un error y que sea Equatable para poder hacer los assertions.

Los parámetros file y line permiten saber en que archivo y linea se ha producido el error así que asignamos ese valor por defecto #file y #line.

2)

Esperamos un error  y un tipo de error, opcionales (si se llega a producir). Evaluaremos con XCTAssertThrowsError y les asignaremos el error que ha producido y su tipo.

3)

Validamos que efectivamente lance un error expectedError, nuestro propio error, en este caso PasswordError

4)

y además que coincidan el error indicado en la cabecera (expectedError) con el error lanzado por expression

De esta manera al escribir los tests el código es más legible y menos farragoso al tener que evaluar cada caso con XCTAssertThrowsError y en el closure que nos habilita.

Os comparto el código y cualquier mejora es bien recibida.

func XCTAssertThrowsErrorEqual<E: Error & Equatable>(_ expression: @autoclosure () throws -> any Equatable, 
                                                         _ expectedError: E,
                                                         file: StaticString = #file,
                                                         line: UInt = #line) {
        var thrownError: Error?
        var errorType: (any Error.Type)?
        XCTAssertThrowsError(try expression()) { error in
            thrownError = error
            errorType = type(of: error)
        }
        XCTAssertTrue(thrownError is E,
                      "Unexpected error type: \(String(describing: errorType)) insted of \(E.Type.self)", file: file, line: line)
        if let unwrappedThrownError = thrownError as? E {
            XCTAssertEqual(unwrappedThrownError, expectedError, 
                           "Error was not equal to the expected error", file: file, line: line)
        }
    }