The Laravel team released v11.19 this week, including asserting the exact JSON structure, a whereNone
query builder method, a Number::trim()
method, HTML assertion convenience methods, and more.
A stand-out contributor in Laravel 11.19 is Günther Debrauwer, who contributed four pull requests to the framework this week!
Add assertExactJsonStructure()
Test Method
Günther Debrauwer contributed the assertExactJsonStructure()
to ensure that a test response completely follows an expected structure:
/*
Given the following response:
{
"data": {
"id": 1,
"firstname": "Taylor",
"lastname": "Otwell"
}
}
*/
// This fails
$response->assertExactJsonStructure([
'data' => [
'firstname',
'lastname',
],
]);
// This succeeds '); $response->assertSeeHtmlInOrder([
$response->assertExactJsonStructure([
'data' => [
'id',
'firstname',
'lastname',
],
]);
The assertJsonStructure()
method will pass in both of the above examples, so you can use the exact version to ensure the entire shape of the response matches.
Add whereNone
Method to the Query Builder
Einar Hansen contributed the whereNone
to compliment the whereAny
and whereAll
methods:
$users = DB::table('users')
->where('active', true)
->whereNone([
'first_name',
'last_name',
'email',
], 'LIKE', 'einar%')
->get();
/*
SELECT *
FROM users
WHERE active = true AND NOT (
first_name LIKE 'einar%' OR
last_name LIKE 'einar%' OR
email LIKE 'einar%'
)
*/
See Pull Request #52260 for more details.
Add withoutHeader
Test Method
Günther Debrauwer contributed a withoutHeader()
method when making test requests. This method could be useful if you have a default header that you want to send with each request but also want to write a test when the header is not present:
$this->withoutHeader('Foo')->get(...);
Add assertSeeHtml
Test Methods
Günther Debrauwer contributed three new HTML assertions that are syntactic sugar for assertSee()
with escape disabled:
$response->assertSeeHtml('
'
', '
', '
'
]);
$response->assertDontSeeHtml('
');
// The new methods are equivalent to using `assertSee*` methods without escaping HTML:
$response->assertSee(value: '
', escape: false);
Add a
Number::trim()
MethodGünther Debrauwer contributed a
Number::trim()
method that trims 0
digits after the decimal point of a given number:$this->assertSame(12, Number::trim(12));
$this->assertSame(120, Number::trim(120));
$this->assertSame(12, Number::trim(12.0));
$this->assertSame(12.3, Number::trim(12.3));
$this->assertSame(12.3, Number::trim(12.30));
$this->assertSame(12.3456789, Number::trim(12.3456789));
$this->assertSame(12.3456789, Number::trim(12.34567890000));
One use-case in the Pull Request is that
json_encode()
will convert a float number that doesn't have any digits after the decimal point:json_encode(['value' => 4.0, 'another' => 5.21340]);
// = "{"value":4,"another":5.2134}
When asserting these values in a test, you can use the
Number::trim()
to match this behavior.Release notes
You can see the complete list of new features and updates below and the diff between 11.18.0 and 11.19.0 on GitHub. The following release notes are directly from the changelog:
v11.19.0
- fix @return typehint in Illuminate\Contracts\Process\InvokedProcess::wait method by @mdmahbubhelal in https://github.com/laravel/framework/pull/52304
- [11.x] Add php doc for ServiceProvider bindings and singletons properties by @Anton5360 in https://github.com/laravel/framework/pull/52298
- [10.x] backport #52188 by @calebdw in https://github.com/laravel/framework/pull/52293
- Update docblock to accept an Expression for whereLike methods by @patrickomeara in https://github.com/laravel/framework/pull/52299
- [11.x] Fix Bcrypt/Argon/Argon2I Hashers not checking database field for nullish value before checking hash compatibility by @localpath in https://github.com/laravel/framework/pull/52297
- [11.x] Method to trim '0' digits after decimal point of a given number by @gdebrauwer in https://github.com/laravel/framework/pull/52284
- [11.x] Add
whereNone
method to the query builder by @einar-hansen in https://github.com/laravel/framework/pull/52260 - [11.x] Fix flat array parameter for relation upsert by @iamgergo in https://github.com/laravel/framework/pull/52289
- [11.x]
assertSeeHtml
,assertDontSeeHtml
andassertSeeHtmlInOrder
testing methods by @gdebrauwer in https://github.com/laravel/framework/pull/52285 - [11.x] Fully qualify morph columns when using WHERE clauses by @maartenpaauw in https://github.com/laravel/framework/pull/52227
- [10.x] Fix runPaginationCountQuery not working properly for union queries by @chinleung in https://github.com/laravel/framework/pull/52314
- [11.x] Add
assertExactJsonStructure
method by @gdebrauwer in https://github.com/laravel/framework/pull/52311 - [11.x] Add
withoutHeader()
test method by @gdebrauwer in https://github.com/laravel/framework/pull/52309 - [11.x] Widen typehints in base service provider by @devfrey in https://github.com/laravel/framework/pull/52308
- [11.X] "Model::preventAccessingMissingAttributes()" Causes Exception During Pagination with ResourceCollection by @Katalam in https://github.com/laravel/framework/pull/52305
- [11.x] Fixes through() relationship by @leobeal in https://github.com/laravel/framework/pull/52318
- [11.x] Add new
success
Method to the Docblock ofIlluminate\Console\View\Components\Factory
by @devajmeireles in https://github.com/laravel/framework/pull/52310 - [11.x] Fix tests in wrong file by @christophrumpel in https://github.com/laravel/framework/pull/52329
The post Assert the Exact JSON Structure of a Response in Laravel 11.19 appeared first on Laravel News.
Join the Laravel Newsletter to get Laravel articles like this directly in your inbox.