Command timeout vs assertion timeout in Cypress - Test Execution Compared

Test Overview

This test demonstrates the difference between command timeout and assertion timeout in Cypress. It verifies that a button becomes visible within the command timeout and that its text matches the expected value within the assertion timeout.

Test Code - Cypress

Cypress

describe('Command timeout vs assertion timeout demo', () => {
  it('waits for button visibility and text assertion with different timeouts', () => {
    cy.visit('https://example.cypress.io/commands/waiting')

    // Command timeout: wait up to 5 seconds for button to be visible
    cy.get('.wait-btn', { timeout: 5000 }).should('be.visible')

    // Assertion timeout: retry assertion for up to 7 seconds
    cy.get('.wait-btn').should('have.text', 'Button appears after 3 seconds', { timeout: 7000 })
  })
})

Execution Trace - 5 Steps

Step	Action	System State	Assertion	Result
1	Test starts	Cypress test runner initialized	-	PASS
2	Browser opens and navigates to 'https://example.cypress.io/commands/waiting'	Page loads with waiting buttons section	-	PASS
3	Find element with selector '.wait-btn' with command timeout 5000ms	Button not visible initially, appears after 3 seconds	Check element is visible	PASS
4	Assert that element '.wait-btn' has text 'Button appears after 3 seconds' with assertion timeout 7000ms	Button text updates after it appears	Verify button text matches expected string	PASS
5	Test ends successfully	All assertions passed	-	PASS

Failure Scenario

Failing Condition: Button does not become visible within 5 seconds or text does not match within 7 seconds

Execution Trace Quiz - 3 Questions

What does the command timeout control in this Cypress test?

A How long Cypress waits for the assertion to pass

B How long Cypress waits to find the element before failing

C How long the test runner waits before starting

D How long the browser stays open after the test

Key Result

Use command timeout to control how long Cypress waits to find elements, and assertion timeout to control how long it retries assertions. Setting appropriate timeouts helps tests be reliable and fast.