Merge pull request #217 from devajmeireles/throws-unless

[2.x] Adding `throwsUnless`
pestphp · Oct 17, 2023 · 6d773b1 · 6d773b1
2 parents ce0ae54 + abd55e6
commit 6d773b1
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/exceptions.md b/exceptions.md
@@ -37,6 +37,14 @@ it('throws exception', function () {
 })->throwsIf(fn() => DB::getDriverName() === 'mysql', Exception::class, 'MySQL is not supported.');
 ```
 
+Just like `throwsIf()` method, you can use the `throwsUnless()` method to conditionally verify an exception if a given boolean expression evaluates to false.
+
+```php
+it('throws exception', function () {
+    //
+})->throwsUnless(fn() => DB::getDriverName() === 'mysql', Exception::class, 'Only MySQL is supported.');
+```
+
 You can also verify that a given closure throws one or more exceptions using the [toThrow()](/docs/expectations#expect-toThrow) method of the expectation API.
 
 ```php