API-first setup pattern in Cypress - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is the API-first setup pattern in testing?

It means setting up test data or environment by calling APIs directly before running UI tests. This makes tests faster and more reliable.

beginner

Why use API calls for setup instead of UI actions in Cypress tests?

API calls are faster, less flaky, and avoid UI delays. They prepare the test state directly without depending on the UI.

intermediate

How do you perform an API-first setup in Cypress?

Use cy.request() to call backend APIs to create or reset data before visiting the UI page.

intermediate

What is a key benefit of API-first setup pattern for test maintenance?

Tests are easier to maintain because setup logic is centralized in API calls, reducing UI changes impact.

beginner

Show a simple Cypress code snippet for API-first setup before a UI test.

cy.request('POST', '/api/users', {name: 'Test User'}).then(() => { cy.visit('/users') })

What does the API-first setup pattern primarily improve in tests?

A UI design

B Test speed and reliability

C Manual testing effort

D Database schema

API-first setup makes tests faster and less flaky by preparing data directly via APIs.

Which Cypress command is commonly used for API-first setup?

A cy.request()

B cy.get()

C cy.visit()

D cy.click()

cy.request() sends HTTP requests to backend APIs, perfect for setup.

When should you prefer API-first setup over UI setup?

A When manual testing is preferred

B When UI is very fast

C When UI is slow or unstable

D When no backend exists

API setup avoids UI delays and flakiness, improving test stability.

What is a common risk if you do NOT use API-first setup?

A Tests skip setup

B Tests run faster

C Tests become more reliable

D Tests may be slower and flaky

Without API setup, tests rely on UI which can be slow and flaky.

Which is NOT a benefit of API-first setup pattern?

A Direct UI interaction

B Faster test execution

C Less flaky tests

D Easier test maintenance

API-first setup avoids direct UI interaction for setup.

Explain how the API-first setup pattern improves Cypress test reliability and speed.

Think about how calling APIs directly helps tests run better.

Describe a simple example of using API-first setup in a Cypress test.

Imagine you create a user via API before opening the user page.

Practice

1. What is the main benefit of using the API-first setup pattern in Cypress tests?

easy

A. It prepares test data quickly by calling backend APIs before UI tests run.

B. It replaces UI tests completely with API tests.

C. It slows down tests by adding extra API calls.

D. It only works for frontend UI testing without backend interaction.

Solution

1. Step 1: Understand API-first setup purpose

   API-first setup means using backend API calls to prepare data before UI tests.

2. Step 2: Identify the benefit

   This approach makes tests faster and more reliable by avoiding UI data entry steps.

3. Final Answer:

   It prepares test data quickly by calling backend APIs before UI tests run. -> Option A

4. Quick Check:

   API-first setup = faster, reliable test data setup [OK]

Hint: API-first means setup via backend calls before UI tests [OK]

Common Mistakes:

• Thinking API-first replaces UI tests
• Assuming API calls slow down tests
• Believing API-first only works on frontend

2. Which of the following is the correct way to make an API call in Cypress for setup?

easy

A. cy.fetch('POST', '/users', {name: 'John'})

B. cy.api('POST', '/users', {name: 'John'})

C. cy.call('POST', '/users', {name: 'John'})

D. cy.request('POST', '/users', {name: 'John'})

Solution

1. Step 1: Recall Cypress API call syntax

   Cypress uses cy.request() to make HTTP requests.

2. Step 2: Match correct method and parameters

   cy.request('POST', url, body) is the correct syntax.

3. Final Answer:

   cy.request('POST', '/users', {name: 'John'}) -> Option D

4. Quick Check:

   Use cy.request() for API calls in Cypress [OK]

Hint: Use cy.request() for API calls in Cypress [OK]

Common Mistakes:

• Using cy.api() which is not a Cypress command
• Using cy.call() or cy.fetch() which don't exist in Cypress
• Mixing up method names or parameters

3. Given this Cypress test snippet using API-first setup:

cy.request('POST', '/api/users', {name: 'Alice'}).then((response) => {
  expect(response.status).to.eq(201)
  cy.visit('/users/' + response.body.id)
})

What will happen if the API returns status 400 instead of 201?

medium

A. The test will continue and visit the user page anyway.

B. The test will throw a syntax error.

C. The test will fail at the assertion checking response.status.

D. The test will ignore the response and pass.

Solution

1. Step 1: Analyze the assertion on response status

   The test expects response.status to equal 201.

2. Step 2: Understand behavior if status is 400

   If status is 400, the assertion expect(response.status).to.eq(201) fails and test stops with failure.

3. Final Answer:

   The test will fail at the assertion checking response.status. -> Option C

4. Quick Check:

   Assertion fails if response.status != 201 [OK]

Hint: Assertion fails if API response status is unexpected [OK]

Common Mistakes:

• Assuming test continues after failed assertion
• Thinking Cypress throws syntax error on bad status
• Believing test ignores failed API responses

4. You wrote this API-first setup code in Cypress:

cy.request('POST', '/api/items', {name: 'Book'})
  .then((res) => {
    expect(res.status).to.eq(200)
    cy.wrap(res.body.id).as('itemId')
  })
cy.get('@itemId').then((id) => {
  cy.visit(`/items/${id}`)
})

But the test fails with "Cannot read property 'then' of undefined". What is the likely cause?

medium

A. The cy.get('@itemId') runs before the alias is set.

B. The API returned status 500 causing failure.

C. The cy.request method is misspelled.

D. The cy.wrap command cannot create aliases.

Solution

1. Step 1: Understand Cypress command chaining and timing

   Cypress commands run asynchronously and in order, but alias usage requires the alias to be set before use.

2. Step 2: Identify timing issue with alias usage

   cy.get('@itemId') is called immediately, before the alias is set inside the then callback, causing undefined error.

3. Final Answer:

   The cy.get('@itemId') runs before the alias is set. -> Option A

4. Quick Check:

   Alias must be set before cy.get() uses it [OK]

Hint: Set alias before using cy.get('@alias') to avoid timing errors [OK]

Common Mistakes:

• Assuming API error causes this specific error
• Thinking cy.request is misspelled
• Believing cy.wrap cannot create aliases

5. You want to use API-first setup to create multiple users before a UI test. Which approach correctly ensures all users are created before visiting the page?

const users = [
  {name: 'Anna'},
  {name: 'Ben'},
  {name: 'Cara'}
]

// Which code snippet is correct?

hard

A. users.forEach(user => {
cy.request('POST', '/api/users', user)
cy.visit('/users')
})

B. cy.wrap(users).each(user => {
cy.request('POST', '/api/users', user)
}).then(() => {
cy.visit('/users')
})

C. for (const user of users) {
cy.request('POST', '/api/users', user)
cy.visit('/users')
}

D. cy.wrap(users).each(user => {
cy.request('POST', '/api/users', user)
})
cy.visit('/users')

Solution

1. Step 1: Understand Cypress command queue and async behavior

   Cypress commands like cy.request are asynchronous and queued. To wait for all requests, use cy.wrap().each() with a .then() callback.

2. Step 2: Analyze each option

   The native forEach and for-of options place cy.visit() inside the loop, causing visits after each request instead of after all. The cy.wrap(users).each(...) cy.visit() executes visit before requests due to queuing. Only cy.wrap(users).each(...).then(() => cy.visit()) waits for all requests before visiting.

3. Final Answer:

   cy.wrap(users).each(user => { cy.request('POST', '/api/users', user) }).then(() => { cy.visit('/users') }) -> Option B

4. Quick Check:

   Use cy.wrap().each() with then() to wait before next step [OK]

Hint: Chain .then() after cy.wrap().each() to wait for all API calls [OK]

Common Mistakes:

• Placing cy.visit() inside the forEach or for-of loop
• Using cy.wrap().each() without .then() afterward
• Not chaining .then() to wait for all iterations