Why Integration tests in Ruby on Rails? - Purpose & Use Cases

The Big Idea

What if you could test your whole app's key features with just one command?

The Scenario

Imagine you build a web app with many pages and features. You try clicking buttons and filling forms manually every time you change code to check if everything still works.

The Problem

Manually testing each user flow is slow, tiring, and easy to miss mistakes. You might forget some steps or test only parts, causing bugs to slip into your app.

The Solution

Integration tests automatically simulate user actions across multiple parts of your app. They check if everything works together correctly, saving time and catching errors early.

Before vs After

✗ Before

Open browser, click login, fill form, submit, check page manually

✓ After

post login_path, params: { user: { email: '[e-mail]', password: 'pass' } }; follow_redirect!; assert_select 'h1', 'Welcome'

What It Enables

Integration tests let you confidently change code knowing your app's key flows still work perfectly.

Real Life Example

When adding a new signup feature, integration tests ensure users can register, receive confirmation, and log in without breaking anything else.

Key Takeaways

Manual testing is slow and error-prone for full app flows.

Integration tests automate user interactions across components.

They help catch bugs early and keep your app reliable.

Practice

1. What is the main purpose of integration tests in a Rails application?

easy

A. To test individual methods in models

B. To test only the views without backend logic

C. To check database schema correctness

D. To check how different parts of the app work together from a user's perspective

Solution

1. Step 1: Understand integration test scope

   Integration tests simulate user actions and check multiple parts working together.

2. Step 2: Compare options with integration test purpose

   Only To check how different parts of the app work together from a user's perspective describes testing how parts work together from a user's view.

3. Final Answer:

   To check how different parts of the app work together from a user's perspective -> Option D

4. Quick Check:

   Integration tests = user perspective checks [OK]

Hint: Integration tests simulate user actions across components [OK]

Common Mistakes:

• Confusing integration tests with unit tests
• Thinking integration tests only check views
• Assuming integration tests test database schema

2. Which of the following is the correct way to start an integration test class in Rails?

easy

A. class UserFlowsTest < ApplicationController

B. class UserFlowsTest < ActionDispatch::IntegrationTest

C. class UserFlowsTest < ActiveRecord::Base

D. class UserFlowsTest < ActionController::TestCase

Solution

1. Step 1: Identify the base class for integration tests

   Rails integration tests inherit from ActionDispatch::IntegrationTest.

2. Step 2: Check each option's base class

   Only class UserFlowsTest < ActionDispatch::IntegrationTest inherits from ActionDispatch::IntegrationTest, others are for models or controllers.

3. Final Answer:

   class UserFlowsTest < ActionDispatch::IntegrationTest -> Option B

4. Quick Check:

   Integration test class inherits ActionDispatch::IntegrationTest [OK]

Hint: Integration tests inherit from ActionDispatch::IntegrationTest [OK]

Common Mistakes:

• Using ActiveRecord::Base which is for models
• Using ApplicationController which is for controllers
• Using ActionController::TestCase which is for controller tests

3. Given this integration test code snippet:

test "visit home page" do
  get root_path
  assert_response :success
  assert_select "h1", "Welcome"
end

What does assert_select "h1", "Welcome" check?

medium

A. That the page contains an <h1> tag with text exactly 'Welcome'

B. That the page has any <h1> tag regardless of text

C. That the response status is 404

D. That the page redirects to another URL

Solution

1. Step 1: Understand assert_select usage

   assert_select checks HTML elements and their content in the response body.

2. Step 2: Analyze the parameters "h1" and "Welcome"

   It looks for an <h1> tag with text exactly matching "Welcome".

3. Final Answer:

   That the page contains an <h1> tag with text exactly 'Welcome' -> Option A

4. Quick Check:

   assert_select checks HTML element and text [OK]

Hint: assert_select checks HTML tags and their content [OK]

Common Mistakes:

• Thinking assert_select only checks tag presence without text
• Confusing assert_response with assert_select
• Assuming assert_select checks redirects

4. Identify the error in this integration test code:

test "create user" do
  post users_path, params: { user: { name: "Alice" } }
  assert_redirected_to user_path(@user)
end

medium

A. params hash syntax is invalid

B. Missing get request before post

C. Using @user without defining or assigning it in the test

D. Incorrect HTTP verb; should use get instead of post

Solution

1. Step 1: Check variable usage in assertion

   The test asserts redirect to user_path(@user), but @user is never set.

2. Step 2: Understand how to get created user

   After post, the created user should be fetched from controller or database, not assumed as @user.

3. Final Answer:

   Using @user without defining or assigning it in the test -> Option C

4. Quick Check:

   Undefined @user causes error in redirect assertion [OK]

Hint: Define variables before using in assertions [OK]

Common Mistakes:

• Assuming @user is auto-set after post
• Confusing HTTP verbs for create actions
• Incorrect params hash structure

5. You want to write an integration test that submits a login form and then checks if the user is redirected to their dashboard page. Which sequence of methods correctly simulates this flow?

hard

A. post login_path, params: { session: { email: "[e-mail]", password: "secret" } } followed by assert_redirected_to dashboard_path

B. get login_path followed by assert_response :success and then get dashboard_path

C. assert_redirected_to login_path followed by post dashboard_path

D. post dashboard_path with user params followed by assert_response :redirect

Solution

1. Step 1: Identify correct HTTP verb for form submission

   Login forms usually submit with POST, so use post with params.

2. Step 2: Check correct assertion after login

   After successful login, user should be redirected to dashboard, so assert_redirected_to dashboard_path is correct.

3. Final Answer:

   post login_path, params: { session: { email: "[e-mail]", password: "secret" } } followed by assert_redirected_to dashboard_path -> Option A

4. Quick Check:

   POST login + assert redirect to dashboard [OK]

Hint: Use post for form submit, then assert_redirected_to for redirect [OK]

Common Mistakes:

• Using get instead of post for form submission
• Checking response success instead of redirect
• Posting to dashboard_path instead of login_path