codeception/assert-throws

Assert exception was thrown without stopping a test

Maintainers

Details

github.com/Codeception/AssertThrows

Source

Issues

Installs: 1 246 107

Dependents: 39

Suggesters: 0

Security: 0

Stars: 19

Watchers: 8

Forks: 10

Open Issues: 1

1.4.0 2024-02-06 21:28 UTC

Requires

MIT e87f75390fccc90037b9411268432fbb69b3f7e9

This package is auto-updated.

Last update: 2024-12-06 23:20:28 UTC

README

Handle exceptions inside a test without a stop! Works with PHPUnit and Codeception.

Actions Status Latest Stable Version Total Downloads License

Installation

composer require "codeception/assert-throws" --dev

Include AssertThrows trait it to a TestCase:

<?php

class MyTest extends PHPUnit\Framework\TestCase
{
    use Codeception\AssertThrows;

    //...
}

Usage

Catch exception thrown inside a code block.

<?php

$this->assertThrows(NotFoundException::class, function() {
	$this->userController->show(99);
});

// alternatively
$this->assertThrows(new NotFoundException(), function() {
	$this->userController->show(99);
});

// you can also assert that an exception is not throw
$this->assertDoesNotThrow(NotFoundException::class, function() {
    $this->userController->show(99);
});

You can optionally test the exception message:

<?php

$this->assertThrowsWithMessage(
    NotFoundException::class, 'my error message', function() {
	throw new NotFoundException('my error message');
    }
);

License

Codeception AssertThrows is open-sourced software licensed under the MIT License.

© Codeception PHP Testing Framework