Why HTTP test assertions in Laravel? - Purpose & Use Cases

The Big Idea

Discover how a few lines of code can replace hours of tedious clicking and guessing!

The Scenario

Imagine you build a web app and want to check if your pages load correctly and show the right data. You open the browser, click around, and hope everything works as expected.

The Problem

Manually testing each page is slow, easy to forget, and you might miss bugs. It's hard to repeat tests exactly the same way every time, especially after changes.

The Solution

HTTP test assertions let you write simple code to automatically check if your web pages respond with the right status, content, or redirects. This saves time and catches errors early.

Before vs After

✗ Before

Visit page, look if text is there, refresh, repeat for every page

✓ After

$response = $this->get('/home');
$response->assertStatus(200);
$response->assertSee('Welcome');

What It Enables

You can quickly verify your app's behavior with repeatable, automatic tests that run anytime you change code.

Real Life Example

Before launching a new feature, you run HTTP test assertions to confirm the page loads and shows the new content correctly, avoiding surprises for users.

Key Takeaways

Manual testing is slow and unreliable.

HTTP test assertions automate checking web responses.

This leads to faster, safer development and fewer bugs.

Practice

1. Which Laravel HTTP test assertion checks if the response status code is 200?

easy

A. $response->assertStatus(200);

B. $response->assertRedirect('/home');

C. $response->assertSee('Welcome');

D. $response->assertJson(['success' => true]);

Solution

1. Step 1: Understand the purpose of assertStatus

   This method checks the HTTP status code returned by the response.

2. Step 2: Match the status code 200 with the assertion

   $response->assertStatus(200); confirms the response was successful (OK).

3. Final Answer:

   $response->assertStatus(200); -> Option A

4. Quick Check:

   Check status code = assertStatus(200) [OK]

Hint: Use assertStatus(200) to check for OK response quickly [OK]

Common Mistakes:

• Confusing assertRedirect with assertStatus
• Using assertSee to check status code
• Expecting assertJson to check status

2. Which of the following is the correct syntax to assert a redirect to the URL '/dashboard' in a Laravel HTTP test?

easy

A. $response->assertLocation('/dashboard', 200);

B. $response->redirect('/dashboard');

C. $response->assertRedirect('/dashboard');

D. $response->assertStatus(302, '/dashboard');

Solution

1. Step 1: Identify the correct assertion method for redirects

   Laravel uses assertRedirect() to check if the response redirects to a given URL.

2. Step 2: Confirm the syntax matches the method signature

   The correct syntax is $response->assertRedirect('/dashboard'); which asserts a redirect to '/dashboard'.

3. Final Answer:

   $response->assertRedirect('/dashboard'); -> Option C

4. Quick Check:

   Redirect assertion = assertRedirect(url) [OK]

Hint: Use assertRedirect('url') to check redirects in tests [OK]

Common Mistakes:

• Using assertStatus with URL parameter
• Calling redirect() instead of assertRedirect()
• Using assertLocation with incorrect status code

3. Given the following test code:

$response = $this->get('/welcome');
$response->assertStatus(200);
$response->assertSee('Hello World');

What will happen if the page '/welcome' returns status 404?

medium

A. The test will fail on assertSee because the content is missing.

B. The test will pass because assertSee ignores status codes.

C. The test will throw a syntax error.

D. The test will fail on assertStatus(200) because the status is 404.

Solution

1. Step 1: Analyze the response status code

   The response returns 404, which means 'Not Found', not 200.

2. Step 2: Understand the effect of assertStatus(200)

   This assertion expects a 200 status code, so it will fail when the actual status is 404.

3. Final Answer:

   The test will fail on assertStatus(200) because the status is 404. -> Option D

4. Quick Check:

   Status mismatch causes assertStatus failure [OK]

Hint: Check status code first; assertStatus fails if codes differ [OK]

Common Mistakes:

• Assuming assertSee passes regardless of status
• Expecting syntax errors from valid code
• Ignoring the importance of status code in tests

4. You wrote this test:

$response = $this->post('/login', ['email' => '[e-mail]', 'password' => 'secret']);
$response->assertRedirect('/dashboard');
$response->assertStatus(200);

Why does this test fail even though the redirect is correct?

medium

A. Because the post method should be get for redirects.

B. Because assertStatus(200) conflicts with the redirect status code 302.

C. Because the URL '/dashboard' is incorrect.

D. Because assertRedirect must come after assertStatus.

Solution

1. Step 1: Understand HTTP redirect status codes

   Redirect responses usually have status code 302, not 200.

2. Step 2: Check the conflict between assertions

   assertRedirect('/dashboard') expects a 302 status, but assertStatus(200) expects 200, causing failure.

3. Final Answer:

   Because assertStatus(200) conflicts with the redirect status code 302. -> Option B

4. Quick Check:

   Redirect status is 302, not 200 [OK]

Hint: Redirects use 302 status; don't assert 200 with assertRedirect [OK]

Common Mistakes:

• Mixing HTTP methods for redirect tests
• Assuming assertRedirect changes status code
• Thinking assertion order affects results

5. You want to test that a JSON API response contains a key 'status' with value 'success' and also returns HTTP status 201. Which assertion combination is correct?

hard

A. $response->assertStatus(201)->assertJson(['status' => 'success']);

B. $response->assertJson(['status' => 'success'])->assertRedirect(201);

C. $response->assertStatus(200)->assertJson(['status' => 'success']);

D. $response->assertSee('success')->assertStatus(201);

Solution

1. Step 1: Identify the correct status code assertion

   HTTP 201 means 'Created', so assertStatus(201) is needed.

2. Step 2: Use assertJson to check JSON content

   assertJson(['status' => 'success']) verifies the JSON key and value.

3. Step 3: Combine assertions correctly

   Chaining assertStatus(201) and assertJson([...]) is valid and checks both conditions.

4. Final Answer:

   $response->assertStatus(201)->assertJson(['status' => 'success']); -> Option A

5. Quick Check:

   Status 201 + JSON key check = assertStatus + assertJson [OK]

Hint: Chain assertStatus(201) with assertJson for API success checks [OK]

Common Mistakes:

• Using assertRedirect with status code
• Checking status 200 instead of 201
• Using assertSee for JSON content