Download the PHP package cspray/assert-throws without Composer
On this page you can find all versions of the php package cspray/assert-throws. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cspray/assert-throws
More information about cspray/assert-throws
Files in cspray/assert-throws
Package assert-throws
Short Description Assertions for PHPUnit when testing code that throws complex exceptions.
License MIT
Informations about the package assert-throws
cspray/assert-throws
Provides an alternative way to test code that throws exceptions using PHPUnit 10 or 11. The primary benefit being access to the thrown Exception for further inspection. This might prove useful when you need to check for details of an exception that aren't available to be expected in PHPUnit. The below example acts as a Quick Start, for more details check out the Detailed Guide below.
Installation
Composer is the only supported method to install this package.
Detailed Guide
PHPUnit provides a reasonable way to test for expected exceptions out-of-the-box. For most situations, the PHPUnit provided methods should be sufficient. However, there are scenarios where you might need to test exception throwing code in a way not readily available in PHPUnit. Examples of this include code where you want to test the previous exception or if the exception includes domain specific information. It is in these situations that this library is most appropriate.
All the assertions provided by this library takes a callable that is expected to throw an exception. If an exception
is not thrown a PHPUnit\Framework\ExpectationFailedException
will be thrown resulting in a test failure. Otherwise, the
thrown exception will be returned for additional assertions.
The following static methods are available on the Cspray\AssertThrows\ThrowableAssert
class:
In addition to the ThrowableAssert
class with static methods there are global functions available:
As well as a trait to use in your PHPUnit\Framework\TestCase
implementations:
Which method you use is a personal preference. Ultimately, all examples utilize the static methods available in the
ThrowableAssert
class.