Laravel FormRequest Tester

A Simple collection of test helpers that help testing form request the easy way.

Why Bother

for full story on why this package was built please refer to This Blog Post

Installation

Using composer

composer require --dev mohammedmanssour/form-request-tester

add MohammedManssour\FormRequestTester\TestsFormRequests trait to your test case.

Testing a form request

you need to intialize the form request using formRequest method, it takes the FormRequest class as first argument and an array of request data as a second argument

$this->formRequest(UpdatePost::class, [
    'title' => 'New Title',
    'content' => 'Some Content here'
])

or you can use the intuitive methods to set form request method and data

$this->formRequest(UpdatePost::class)
->post([
    'title' => 'New Title',
    'content' => 'Some Content here'
])

the previous code will intialize the request with post method and /fake-route if you want to change these options you can via the options array that can be set as a third argument

$this->formRequest(UpdatePost::class, [
    'title' => 'New Title',
    'content' => 'Some Content here'
], [
    'method' => 'put',
    'route' => 'posts/{post}'
])

if you're using $this->route method in your form request or other related methods, then your form request won't be authorized unless you set the right http method and route via the $options array in order to get the right value for $this->route method

Intuitive methods were also introduced to make setting the route easier

$this->formRequest(UpdatePost::class)
->put([
    'title' => 'New Title',
    'content' => 'Some Content here'
])
->withRoute('posts/{post}')

use the available assertions to test for request

Available Assertions


`$this->assertValidationPassed()`	To make sure the validation have passed successfully with the help of the provided data
`$this->assertValidationFailed()`	To make sure the validation have failed with the help of the provided data
`$this->assertValidationErrors($keysArray)`	To assert that the keys mentioned in the `$keysArray` have occurred in the errors bag.
`$this->assertValidationErrorsMissing($keysArray)`	To assert that the keys mentioned in the `$keysArray` have not occurred in the errors bag.
`$this->assertValidationMessages($messagesArray)`	To assert that the messeges exists in the error bag. Used when you define custom messages for your validation
`$this->assertAuthorized()`	To assert that request have been authorized via the form request
`$this->assertNotAuthorized()`	To assert that request have not been authorized via the form request

Example Usage:

Taking into consderation:

title & content are required field,
Content field is required is a custom error message used for content field
$this->route method is used in authorize method
Route::put('posts/{post}', 'PostsController@update') is the route used to update a post

$this->formRequest(UpdatePost::class,[
    'title' => 'New Title'
],[
    'method' => 'put'
    'route' => 'posts/{post}'
])->assertAuthorized()
->assertValidationFailed()
->assertValidationErrors(['content'])
->assertValidationErrorsMissing(['title'])
->assertValidationMessages(['Content field is required'])

you can now use intuitive methods to build form request

$this->formRequest(UpdatePost::class)
->put([
    'title' => 'New Title'
])
->withRoute('posts/{post}')
->assertAuthorized()
->assertValidationFailed()
->assertValidationErrors(['content'])
->assertValidationErrorsMissing(['title'])
->assertValidationMessages(['Content field is required'])