[5.5] Create assertion to determine if a cookie is expired

[roberto-aguilar]

Given that the \Illuminate\Cookie\CookieJar::forget method expires the given cookie to trigger its deletion, this will allow to test those scenarios.

This new assertion will

• Fail if the cookie is not present at all.
• Fail if the cookie is present, but it is not expired.
• Pass if the cookie is present and is expired.

[taylorotwell]

Maybe assertCookieExpired?

[roberto-aguilar]

It is now renamed to assertCookieExpired

@taylorotwell thanks for the feedback!

[JamesAnelay]

Might it also make sense to have an assertCookieNotExpired assertion here? I've been using assertCookieExpired to test that a certain cookie expires at a point in the future, however, if I can't assert that it's not expired beforehand it's not that useful (for me atleast).

Example use case below.

public function testCookieIsSetWhenVisitingUrlWithRefferalHashAndExpiresIn30Days()
        //Create a user with a refferalcode
        $refferedBy = factory(User::class)->create([
            'refferal_code' => 'TESTREFFERALCODE'
        ]);

        //Have a guest user visit the website with that hash in the url.
        $response = $this->get('auth/login/#TESTREFFERALCODE');
        $response->assertCookie('reffered_by', $refferedBy->user_id);

        Carbon::setTestNow(Carbon::parse('+29 days'));
        $response->assertCookieNotExpired('reffered_by'); //Doesn't exist in core laravel.

        Carbon::setTestNow(Carbon::parse('+2 days'));
	$response->assertCookieExpired('reffered_by');

[roberto-aguilar]

@JamesAnelay

It is now created and merged, please wait for the next release for it to be available :)