Proposal: Accessing Thrown Exceptions

[cheack]

We use custom exceptions in our application, each of which has a method public function isIgnored(): bool.
Currently, we have to use this approach:

try {
    $do->something();
    $this->fail('something() should throw Exception.');
} catch (Exception $e) {
    $this->assertEquals('message', $e->getMessage());
    $this->assertTrue($e->isIgnored());
}

Proposing:

I propose enhancing PHPUnit by introducing a mechanism to store the thrown exception during test execution. This could be achieved by modifying the runTest method to capture exceptions:

final protected function runTest(): mixed
{
    try {
        $testResult = $this->{$this->methodName}(...$testArguments);
    } catch (Throwable $exception) {
        ...
        // Something like this:
        $this->observedException = $exception;
        ...
    }

    return $testResult;
}

Subsequently, we could utilize the stored observedException in tearDown or other relevant methods for further assertions or checks.

This will allowed us to use an expressive way to define expectations:

$this->expectException(Exception::class);
$this->expectExceptionMessage('message');
$this->expectExceptionIsIgnored();

$do->something();

[sebastianbergmann]

This is outside the scope of this project.

[cheack]

Of course, my example is quite specific, but the essence is to give the user access to the thrown exception so that they can further manipulate it as needed.