Exceptions & Errors

• Overview

Overview

Testing the behavior in PHP sometimes requires checking if an exception/error was thrown.

Writing a test to expect a test to throw an exception can be done as follows:

1it('throws exception', function () {
2    throw new Exception('Something happened.');
3})->throws(Exception::class);

If you wish to assert the exception message too, you need to give a second argument to the throws method:

1it('throws exception', function () {
2    throw new Exception('Something happened.');
3})->throws(Exception::class, 'Something happened.');

If you're only interested in the message, and the exception type isn't important, you can just provide the message by itself:

1it('throws exception', function () {
2    throw new Exception('Something happened.');
3})->throws('Something happened.');

You may also use the throwsIf method to conditional assert an exception if a given boolean expression evaluates to true:

1it('throwsIf exception', function () {
2    // ..
3})->throwsIf(fn() => DB::getDriverName() === 'mysql', Exception::class, 'MySQL is not supported.');

You may also assert one or more exceptions inside your test function with Expectations' method toThrow()

---

Next section: Groups Of Tests →