Test isolation strategies in Cypress - Framework Patterns

Framework Mode - Test isolation strategies

Folder Structure

cypress/
├── e2e/                  # Test specs
│   ├── login.cy.js       # Example test file
│   └── dashboard.cy.js
├── fixtures/             # Test data files (JSON, etc.)
│   └── user.json
├── support/              # Custom commands and utilities
│   ├── commands.js       # Custom Cypress commands
│   └── index.js          # Support file loaded before tests
cypress.config.js         # Cypress configuration file

Test Framework Layers

• Test Specs (cypress/e2e): Actual test files where test cases are written. Each test should be independent.
• Fixtures (cypress/fixtures): Static test data used to keep tests consistent and isolated.
• Support (cypress/support): Contains reusable commands and setup code to keep tests clean and isolated.
• Configuration (cypress.config.js): Defines environment variables, base URLs, and test settings to isolate test environments.

Configuration Patterns

• Environment Variables: Use env in cypress.config.js to set different URLs, credentials, or flags for dev, staging, and prod.
• Test Isolation: Use testIsolation: true in Cypress config to reset state between tests automatically.
• Fixtures: Load test data from fixtures to avoid hardcoding and keep tests independent.
• BeforeEach Hooks: Use beforeEach() in tests to reset app state or visit fresh pages to isolate tests.

Test Reporting and CI/CD Integration

• Use Cypress built-in reporters or plugins like mochawesome for detailed HTML reports.
• Integrate Cypress tests in CI pipelines (GitHub Actions, Jenkins, GitLab CI) to run tests on every commit.
• Configure CI to run tests in isolated containers or environments to avoid shared state.
• Use screenshots and video recordings on test failures to help debug isolated test issues.

Best Practices for Test Isolation in Cypress

1. Reset State Between Tests: Use testIsolation: true and beforeEach() hooks to start each test fresh.
2. Avoid Shared State: Do not share variables or data between tests; use fixtures or fresh API calls.
3. Use Custom Commands: Encapsulate repetitive setup steps in cypress/support/commands.js to keep tests clean and isolated.
4. Clear Cookies and Local Storage: Use Cypress commands to clear browser data between tests if needed.
5. Run Tests in Parallel: Use Cypress Dashboard or CI parallelization to run isolated tests faster without interference.

Self Check

Where in this folder structure would you add a new custom command to reset the application state before each test?

Key Result

Use Cypress's built-in test isolation features combined with fixtures and custom commands to keep tests independent and reliable.

Practice

1. What is the main purpose of test isolation in Cypress testing?

easy

A. To speed up test execution by running all tests together

B. To share data between tests for faster setup

C. To keep tests independent and avoid interference between them

D. To reduce the number of tests needed

Solution

1. Step 1: Understand test isolation concept

   Test isolation means each test runs independently without relying on others.

2. Step 2: Identify the main benefit

   This independence avoids interference and makes tests reliable and easier to debug.

3. Final Answer:

   To keep tests independent and avoid interference between them -> Option C

4. Quick Check:

   Test isolation = Independent tests [OK]

Hint: Test isolation means no test depends on another [OK]

Common Mistakes:

• Thinking tests should share data to run faster
• Believing test isolation reduces total tests
• Confusing isolation with parallel execution

2. Which Cypress hook is best used to reset application state before each test to ensure isolation?

easy

A. beforeEach

B. before

C. after

D. afterEach

Solution

1. Step 1: Recall Cypress hooks purpose

   beforeEach runs before every test, ideal for resetting state.

2. Step 2: Compare with other hooks

   before runs once before all tests, after and afterEach run after tests, so they don't reset state before tests.

3. Final Answer:

   beforeEach -> Option A

4. Quick Check:

   Reset state before each test = beforeEach [OK]

Hint: Use beforeEach to reset state before every test [OK]

Common Mistakes:

• Using before which runs only once
• Confusing afterEach with beforeEach
• Not resetting state at all

3. Consider this Cypress test code snippet:

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

  it('Test A', () => {
    cy.get('#username').type('user1')
    cy.get('#password').type('pass1')
    cy.get('button').click()
    cy.url().should('include', '/dashboard')
  })

  it('Test B', () => {
    cy.get('#username').type('user2')
    cy.get('#password').type('pass2')
    cy.get('button').click()
    cy.url().should('include', '/dashboard')
  })
})

What is the main benefit of using beforeEach here?

medium

A. It visits the login page once before all tests

B. It visits the login page before each test to isolate them

C. It skips the login page for Test B

D. It runs tests faster by sharing the login page

Solution

1. Step 1: Analyze beforeEach usage

   beforeEach runs before every test, so it visits the login page before Test A and Test B.

2. Step 2: Understand test isolation effect

   This ensures each test starts fresh on the login page, isolating tests and avoiding state carryover.

3. Final Answer:

   It visits the login page before each test to isolate them -> Option B

4. Quick Check:

   beforeEach = fresh start per test [OK]

Hint: beforeEach runs before every test, isolating them [OK]

Common Mistakes:

• Thinking beforeEach runs only once
• Assuming tests share the same page state
• Believing it skips steps for some tests

4. You wrote tests with beforeEach to reset state, but tests still fail due to shared data. What is the likely mistake?

medium

A. Using before instead of beforeEach

B. Not visiting the page in any hook

C. Using afterEach to reset state

D. Running tests in parallel

Solution

1. Step 1: Identify hook usage problem

   If before is used, it runs once before all tests, so state is not reset before each test.

2. Step 2: Understand impact on test isolation

   This causes shared data between tests, breaking isolation and causing failures.

3. Final Answer:

   Using before instead of beforeEach -> Option A

4. Quick Check:

   beforeEach resets state per test, before does not [OK]

Hint: Use beforeEach, not before, to reset state each test [OK]

Common Mistakes:

• Confusing before and beforeEach hooks
• Assuming afterEach resets state before tests
• Ignoring test parallelism effects

5. You want to run Cypress tests in parallel on CI to speed up testing. Which test isolation strategy helps ensure tests run reliably in parallel?

hard

A. Sharing global variables between tests

B. Running all tests in a single browser session without reset

C. Disabling test retries to avoid repeated runs

D. Using beforeEach to reset state and avoid shared data

Solution

1. Step 1: Understand parallel test challenges

   Parallel tests run simultaneously, so shared state causes flaky failures.

2. Step 2: Identify isolation strategy for parallel runs

   Using beforeEach to reset state and avoid shared data ensures each test is independent and reliable.

3. Final Answer:

   Using beforeEach to reset state and avoid shared data -> Option D

4. Quick Check:

   Parallel tests need isolated state = beforeEach [OK]

Hint: Reset state before each test for reliable parallel runs [OK]

Common Mistakes:

• Sharing global variables causing conflicts
• Running tests without resetting state
• Disabling retries instead of fixing isolation