Why beforeEach and afterEach hooks in Cypress? - Purpose & Use Cases

The Big Idea

What if you never had to repeat boring setup steps again in your tests?

The Scenario

Imagine testing a website where you must log in before every test and log out after. Doing this by hand means repeating the same steps over and over for each test case.

The Problem

Manually repeating setup and cleanup steps wastes time and causes mistakes. You might forget to log out or reset data, leading to wrong test results and frustration.

The Solution

Using beforeEach and afterEach hooks lets you run setup code before every test and cleanup code after every test automatically. This keeps tests clean and reliable without repeating yourself.

Before vs After

✗ Before

it('test 1', () => {
  cy.login()
  // test steps
  cy.logout()
})
it('test 2', () => {
  cy.login()
  // test steps
  cy.logout()
})

✓ After

beforeEach(() => {
  cy.login()
})
afterEach(() => {
  cy.logout()
})
it('test 1', () => {
  // test steps
})
it('test 2', () => {
  // test steps
})

What It Enables

This makes your tests faster to write, easier to read, and less likely to break because setup and cleanup happen automatically.

Real Life Example

When testing an online store, you can log in once before each test and clear the shopping cart after each test without repeating those steps inside every test case.

Key Takeaways

Manual repetition of setup and cleanup is slow and error-prone.

beforeEach and afterEach hooks automate these steps for every test.

This leads to cleaner, more reliable, and easier-to-maintain tests.

Practice

1. What is the main purpose of the beforeEach hook in Cypress testing?

easy

A. To run code before every test to set up the test environment

B. To run code after every test to clean up the test environment

C. To skip a test conditionally

D. To group multiple tests together

Solution

1. Step 1: Understand the role of beforeEach

   The beforeEach hook runs before each test to prepare the environment or state needed for the test.

2. Step 2: Differentiate from afterEach

   Unlike afterEach, which runs after tests to clean up, beforeEach sets up conditions before tests.

3. Final Answer:

   To run code before every test to set up the test environment -> Option A

4. Quick Check:

   beforeEach = setup before tests [OK]

Hint: Remember: beforeEach runs before tests, afterEach runs after [OK]

Common Mistakes:

• Confusing beforeEach with afterEach
• Thinking beforeEach skips tests
• Assuming beforeEach groups tests

2. Which of the following is the correct syntax to use afterEach in a Cypress test file?

easy

A. afterEach { cy.visit('/home') }

B. afterEach(() => { cy.visit('/home') })

C. afterEach: () => cy.visit('/home')

D. afterEach => { cy.visit('/home') }

Solution

1. Step 1: Recall correct function syntax in Cypress

   Cypress hooks use function calls with arrow functions inside parentheses, like afterEach(() => { ... }).

2. Step 2: Identify syntax errors in other options

   Options B, C, and D miss parentheses or use incorrect arrow function syntax.

3. Final Answer:

   afterEach(() => { cy.visit('/home') }) -> Option B

4. Quick Check:

   Hook syntax = function call with arrow function [OK]

Hint: Hooks need parentheses and arrow functions: hook(() => {}) [OK]

Common Mistakes:

• Omitting parentheses after hook name
• Using curly braces without parentheses
• Incorrect arrow function syntax

3. Consider this Cypress test code:

describe('My Tests', () => {
  beforeEach(() => {
    cy.visit('/login')
  })

  it('Test 1', () => {
    cy.get('#username').type('user1')
  })

  it('Test 2', () => {
    cy.get('#username').type('user2')
  })
})

How many times will cy.visit('/login') run when these tests execute?

medium

A. Once before all tests

B. Twice, once after each test

C. Twice, once before each test

D. Once after all tests

Solution

1. Step 1: Understand beforeEach behavior

   The beforeEach hook runs before every individual test inside the describe block.

2. Step 2: Count the tests and hook calls

   There are two tests, so cy.visit('/login') runs twice, once before each test.

3. Final Answer:

   Twice, once before each test -> Option C

4. Quick Check:

   beforeEach runs before every test [OK]

Hint: Count tests; beforeEach runs before each one [OK]

Common Mistakes:

• Thinking beforeEach runs only once
• Confusing beforeEach with afterEach
• Assuming hooks run after tests

4. You wrote this Cypress test:

describe('Sample', () => {
  beforeEach(() => {
    cy.visit('/dashboard')
  })

  afterEach(() => {
    cy.clearCookies
  })

  it('checks title', () => {
    cy.title().should('include', 'Dashboard')
  })
})

Why does cy.clearCookies not run after the test?

medium

A. Because cy.clearCookies is missing parentheses to call the function

B. Because afterEach only runs before tests

C. Because cy.clearCookies is not a valid Cypress command

D. Because beforeEach overrides afterEach

Solution

1. Step 1: Check the afterEach hook code

   The code uses cy.clearCookies without parentheses, so the function is not called.

2. Step 2: Understand function call syntax

   To execute the command, parentheses are required: cy.clearCookies().

3. Final Answer:

   Because cy.clearCookies is missing parentheses to call the function -> Option A

4. Quick Check:

   Functions need () to run [OK]

Hint: Always add () to call Cypress commands [OK]

Common Mistakes:

• Forgetting parentheses on Cypress commands
• Confusing beforeEach and afterEach roles
• Assuming afterEach runs before tests

5. You want to test a form that requires logging in before each test and clearing local storage after each test. Which is the best way to organize your Cypress hooks?

hard

A. Use only beforeEach for both login and clearing local storage

B. Use afterEach to log in and beforeEach to clear local storage

C. Use only afterEach for both login and clearing local storage

D. Use beforeEach to log in and afterEach to clear local storage

Solution

1. Step 1: Identify setup and cleanup tasks

   Logging in is setup needed before each test; clearing local storage is cleanup after each test.

2. Step 2: Assign tasks to correct hooks

   Use beforeEach for setup (login) and afterEach for cleanup (clear local storage).

3. Final Answer:

   Use beforeEach to log in and afterEach to clear local storage -> Option D

4. Quick Check:

   Setup beforeEach, cleanup afterEach [OK]

Hint: Setup in beforeEach, cleanup in afterEach [OK]

Common Mistakes:

• Mixing setup and cleanup in wrong hooks
• Using only one hook for both tasks
• Not cleaning up after tests