Package

Jasonmccreary Laravel Test Assertions

A set of helpful assertions when testing Laravel applications.

Package

jasonmccreary/laravel-test-assertions

View on GitHub →

Laravel Test Assertions

A set of helpful assertions when testing Laravel applications.

Requirements

Your application must be running the Laravel 5.5 or higher and using Laravel's testing harness.

Installation

You may install these additional assertions with Composer by running:

composer require --dev jasonmccreary/laravel-test-assertions

Afterwards, add the trait to your base TestCase class:

<?php
namespace Tests;

use JMac\Testing\Traits\AdditionalAssertions;
use Illuminate\Foundation\Testing\TestCase as BaseTestCase;

abstract class TestCase extends BaseTestCase
{
    use CreatesApplication, AdditionalAssertions;
}

Documentation

This package adds several assertions, matchers, and helpers aimed at making testing within Laravel easier.

Assertions

assertActionUsesFormRequest(string $controller, string $method, string $form_request)

Verifies the action for a given controller performs validation using the given form request.

assertActionUsesMiddleware(string $controller, string $method, string|array $middleware)

Verifies the action for a given controller uses the given middleware or set of middleware.

assertRouteUsesFormRequest(string $routeName, string $formRequest)

Verifies that the corresponding action/controller, for a given route name performs the validation using the given form request.

assertRouteUsesMiddleware(string $routeName, array $middlewares, bool $exact)

Verifies the route for a given route name uses all the given middlewares or only the given set of middlewares.

assertValidationRules(array $expected, array $actual)

Verifies the expected subset of validation rules for fields are within a set of validation rules. Rules may be passed as a delimited string or array.

assertExactValidationRules(array $expected, array $actual)

Verifies the expected set of validation rules for fields exactly match a set of validation rules. Rules may be passed as a delimited string or array.

assertValidationRuleContains($rule, string $class)

Verifies the rule or rules contains an instance of the given Rule class.

assertViewHasNull($key)

Verifies the view data $key has an explicit value of null. Note: is a TestResponse assertion. It must be called on the response of a view.

assertNow(CarbonInterface $datetime, ?CarbonInterface $now = null)

Verifies $datetime is equal to $now, precise to the second. $now defaults to Carbon::now() which can be faked with the freezeNow() testing helper.

Matchers

LaravelMatchers::isModel(Model $model = null)

Matches an argument is the same as $model. When called without $model, will match any argument of type Illuminate\Database\Eloquent\Model.

LaravelMatchers::isCollection(Collection $collection = null)

Matches an argument equals $collection. When called without $collection, will match any argument of type Illuminate\Support\Collection.

LaravelMatchers::isEloquentCollection(Collection $collection = null)

Matches an argument equals $collection. When called without $collection, will match any argument of type \Illuminate\Database\Eloquent\Collection.

Helpers

createFormRequest(string $class, array $data = [])

Creates an instance of the given Form Request class with the given request data.

freezeNow(bool $subseconds = false)

Similar to Laravel's freezeTime() helper, but defaults with second precision and returns the frozen time. You may pass true to freeze with sub-second precision.

Support Policy

Starting with version 2, this package will only support the latest stable version of Laravel (currently Laravel 8). If you need to support older versions of Laravel, you may use version 1 or upgrade your application (try using Shift).

This package still follows semantic versioning. However, it does so with respect to its own code. Any breaking changes will increase its major version number. Otherwise, minor version number increases will contain new features. This includes changes for future versions of Laravel.

Jasonmccreary Laravel Test Assertions Related Articles

Laravel Test Assertions Package image

Laravel Test Assertions Package

Read article
Write Tabular Assertions with Pest and PHPUnit image

Write Tabular Assertions with Pest and PHPUnit

Read article
JSON Type Assertions and a "prohibited" Validation rule Are Now In Laravel 8.34 image

JSON Type Assertions and a "prohibited" Validation rule Are Now In Laravel 8.34

Read article
Laravel 8.32 with HTTP client dump methods, queue exception throttling, fluent JSON assertions, and more image

Laravel 8.32 with HTTP client dump methods, queue exception throttling, fluent JSON assertions, and more

Read article
Testmo Review: Unified Test Management image

Testmo Review: Unified Test Management

Read article
Learn how to start Testing in Laravel with Simple Examples using PHPUnit and PEST image

Learn how to start Testing in Laravel with Simple Examples using PHPUnit and PEST

Read article

Acquaint Softtech

Acquaint Softtech offers AI-ready Laravel developers who onboard in 48 hours at $3000/Month with no lengthy sales process and a 100 percent money-back guarantee.

Acquaint Softtech

NativePHP

The fastest way to build fully native apps for any platform (with AI or not)

NativePHP

PhpStorm

The go-to PHP IDE with extensive out-of-the-box support for Laravel and its ecosystem.

PhpStorm

Let your users buy domains without leaving your app

If your Laravel app gives users a site, a storefront, or a workspace, they’ll eventually want their own domain. The name.com API lets them search, register, and connect one without leaving your product. It’s a clean REST API, so Laravel’s HTTP client is all you need.

Let your users buy domains without leaving your app

Shift

Running an old Laravel version? Instant, automated Laravel upgrades and code modernization to keep your applications fresh.

Shift

Kirschbaum

Providing innovation and stability to ensure your web application succeeds.

Kirschbaum