Why element selection drives interaction in Cypress - Automation Benefits in Action

Verify interaction with a button using correct element selection

Preconditions (1)

Step 1: Locate the button with the text 'Click Me' using a reliable selector

Step 2: Click the button

Step 3: Verify that a message 'Button clicked!' appears on the page

✅ Expected Result: The message 'Button clicked!' is visible after clicking the button

Automation Requirements - Cypress

Assertions Needed:

Verify the button is found using a reliable selector

Verify the button click triggers the expected message display

Best Practices:

Use semantic selectors like data-cy attributes

Avoid brittle selectors like absolute XPaths

Use Cypress commands consistently (cy.get, cy.contains)

Add assertions to confirm element presence before interaction

Automated Solution

Cypress

describe('Why element selection drives interaction', () => {
  beforeEach(() => {
    cy.visit('/sample-page')
  })

  it('Clicks the button and verifies the message', () => {
    // Use data-cy attribute for reliable selection
    cy.get('[data-cy=click-me-button]').should('be.visible').click()

    // Verify the message appears
    cy.contains('Button clicked!').should('be.visible')
  })
})

The test starts by visiting the sample page before each test to ensure a fresh state.

We select the button using a data-cy attribute, which is a stable and semantic selector that won't break if the UI changes slightly.

We assert the button is visible before clicking to avoid errors if the element is missing or hidden.

After clicking, we verify the expected message appears, confirming the interaction worked as intended.

Common Mistakes - 3 Pitfalls

Using brittle selectors like absolute XPath

{'mistake': 'Not asserting element visibility before interaction', 'why_bad': 'Trying to click a hidden or missing element causes test failures and unclear errors.', 'correct_approach': "Always assert the element is visible using .should('be.visible') before clicking."}

Mixing different selector strategies inconsistently

Bonus Challenge

Now add data-driven testing with 3 different buttons each showing a unique message

Show Hint

Practice

1. Why is choosing the right element selector important in Cypress tests?

easy

A. It automatically fixes broken tests.

B. It makes the test run faster by skipping elements.

C. It ensures the test interacts with the correct element on the page.

D. It changes the page layout for testing.

Solution

1. Step 1: Understand element selection role

   Choosing the right selector targets the exact element you want to test.

2. Step 2: Recognize test reliability impact

   If the wrong element is selected, the test may fail or behave unpredictably.

3. Final Answer:

   It ensures the test interacts with the correct element on the page. -> Option C

4. Quick Check:

   Correct element selection = reliable test [OK]

Hint: Pick unique selectors to target elements precisely [OK]

Common Mistakes:

• Assuming any selector works equally well
• Using selectors that match multiple elements
• Ignoring page changes that break selectors

2. Which of the following is the best way to select an element in Cypress?

easy

A. cy.get('.button')

B. cy.get('#submit-button')

C. cy.get('div')

D. cy.get('input[type="text"]')

Solution

1. Step 1: Evaluate selector specificity

   ID selectors like '#submit-button' are unique and stable, making them best for selection.

2. Step 2: Compare other selectors

   Class selectors or tag selectors may match multiple elements, causing unreliable tests.

3. Final Answer:

   cy.get('#submit-button') -> Option B

4. Quick Check:

   Use unique IDs for stable selection [OK]

Hint: Use IDs or data attributes for unique element selection [OK]

Common Mistakes:

• Using generic tags that match many elements
• Relying on classes that change often
• Not checking if selector is unique

3. What will happen if you run this Cypress code?

cy.get('.menu-item').click()

Assuming there are 3 elements with class 'menu-item'.

medium

A. Cypress clicks the first element with class 'menu-item'.

B. Cypress clicks all elements with class 'menu-item'.

C. Cypress throws an error because multiple elements match.

D. Cypress clicks the last element with class 'menu-item'.

Solution

1. Step 1: Understand cy.get behavior

   cy.get('.menu-item') selects all matching elements but commands act on the first by default.

2. Step 2: Analyze click command effect

   The click() command clicks only the first matched element unless chained with .each() or .eq().

3. Final Answer:

   Cypress clicks the first element with class 'menu-item'. -> Option A

4. Quick Check:

   cy.get() selects all, commands act on first [OK]

Hint: cy.get() selects all but acts on first element by default [OK]

Common Mistakes:

• Thinking click() affects all matched elements
• Expecting an error for multiple matches
• Assuming last element is clicked

4. You wrote this Cypress test:

cy.get('#login').click()

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

medium

A. The element with ID 'login' does not exist on the page.

B. The click() command is misspelled.

C. cy.get() cannot select elements by ID.

D. The test needs a wait() before click().

Solution

1. Step 1: Understand error meaning

   'Cannot read property click of undefined' means cy.get() did not find the element, returning undefined.

2. Step 2: Check element existence

   If the element with ID 'login' is missing or not loaded, cy.get('#login') fails to find it.

3. Final Answer:

   The element with ID 'login' does not exist on the page. -> Option A

4. Quick Check:

   Missing element causes undefined and click error [OK]

Hint: Check if element exists before clicking [OK]

Common Mistakes:

• Assuming syntax error causes this
• Thinking cy.get() can't select by ID
• Adding wait() without verifying element presence

5. You want to click a button that sometimes has the class 'btn-primary' and sometimes 'btn-secondary'. Which selector is best to ensure your Cypress test clicks the correct button reliably?

hard

A. cy.get('button.btn-primary, button.btn-secondary').click()

B. cy.get('button').click()

C. cy.get('.btn-primary').click()

D. cy.get('[data-cy="submit-button"]').click()

Solution

1. Step 1: Identify selector stability

   Class names change, so relying on them can cause flaky tests.

2. Step 2: Use data attributes for stable selection

   Selectors like '[data-cy="submit-button"]' are stable and unique, unaffected by style changes.

3. Step 3: Compare options

   cy.get('button.btn-primary, button.btn-secondary').click() depends on classes that vary; cy.get('button').click() is too broad; cy.get('.btn-primary').click() misses 'btn-secondary' case.

4. Final Answer:

   cy.get('[data-cy="submit-button"]').click() -> Option D

5. Quick Check:

   Use data attributes for reliable element selection [OK]

Hint: Use data attributes for stable selectors, not classes [OK]

Common Mistakes:

• Using multiple class selectors that change
• Selecting all buttons without filtering
• Ignoring stable custom attributes