cy.click() in Cypress - Build an Automation Script

Verify clicking the Submit button navigates to the confirmation page

Preconditions (2)

Step 1: Locate the Submit button by its data-cy attribute 'submit-btn'

Step 2: Click the Submit button

Step 3: Wait for navigation to the confirmation page

✅ Expected Result: The browser navigates to '/confirmation' URL after clicking the Submit button

Automation Requirements - Cypress

Assertions Needed:

Verify the Submit button is visible before clicking

Verify the URL changes to '/confirmation' after clicking

Best Practices:

Use data-cy attributes for selectors

Use cy.get() with assertions before clicking

Avoid hardcoded waits; rely on Cypress automatic waits

Chain commands for readability

Automated Solution

Cypress

describe('Form Submit Button Click Test', () => {
  it('should navigate to confirmation page after clicking Submit', () => {
    cy.visit('/form');
    cy.get('[data-cy=submit-btn]')
      .should('be.visible')
      .click();
    cy.url().should('include', '/confirmation');
  });
});

This test visits the form page first using cy.visit(). Then it locates the Submit button using the data-cy attribute selector, which is a best practice for stable selectors. Before clicking, it asserts the button is visible to ensure the element is ready for interaction. The click() command simulates the user clicking the button. Finally, it asserts the URL includes '/confirmation' to confirm navigation happened as expected. Cypress automatically waits for elements and page loads, so no explicit waits are needed.

Common Mistakes - 3 Pitfalls

Using CSS classes or IDs that may change instead of data-cy attributes for selectors

{'mistake': 'Calling click() without checking if the element is visible or enabled', 'why_bad': 'Clicking on hidden or disabled elements causes test failures or false positives', 'correct_approach': "Use assertions like should('be.visible') before clicking"}

Using cy.wait() with fixed time before clicking

Bonus Challenge

Now add data-driven testing to click Submit button on three different form pages with URLs '/form1', '/form2', '/form3' and verify navigation each time

Show Hint

Practice

1. What does the cy.click() command do in Cypress testing?

easy

A. Types text into an input field

B. Selects an element by its CSS selector

C. Simulates a user clicking on a selected element

D. Waits for a specified amount of time

Solution

1. Step 1: Understand the purpose of cy.click()

   The cy.click() command is used to simulate a user clicking on an element in the browser during a test.

2. Step 2: Differentiate from other commands

   Typing text uses cy.type(), selecting elements uses cy.get(), and waiting uses cy.wait(). So, cy.click() specifically simulates clicks.

3. Final Answer:

   Simulates a user clicking on a selected element -> Option C

4. Quick Check:

   cy.click() = Simulate click [OK]

Hint: Click means simulate user click on element [OK]

Common Mistakes:

• Confusing cy.click() with typing or selecting elements
• Thinking cy.click() waits or pauses the test
• Using cy.click() without selecting an element first

2. Which of the following is the correct syntax to click a button with id submitBtn using Cypress?

easy

A. cy.click().get('#submitBtn')

B. cy.click('#submitBtn')

C. cy.find('#submitBtn').click()

D. cy.get('#submitBtn').click()

Solution

1. Step 1: Select the element before clicking

   In Cypress, you must first select the element using cy.get() with the CSS selector, then call .click() on it.

2. Step 2: Check each option's syntax

   cy.click('#submitBtn') tries to call cy.click() with a selector, which is invalid. cy.find('#submitBtn').click() uses cy.find(), which is not a Cypress command. cy.click().get('#submitBtn') calls cy.click() before selecting, which is incorrect.

3. Final Answer:

   cy.get('#submitBtn').click() -> Option D

4. Quick Check:

   Select with cy.get(), then .click() [OK]

Hint: Always use cy.get(selector).click() to click elements [OK]

Common Mistakes:

• Calling cy.click() directly with a selector
• Using non-existent commands like cy.find()
• Calling click() before selecting the element

3. What will happen when the following Cypress code runs?

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

Assuming there are multiple elements with class btn-primary on the page.

medium

A. Clicks the first element with class btn-primary

B. Clicks all elements with class btn-primary

C. Throws an error because multiple elements match

D. Clicks a random element with class btn-primary

Solution

1. Step 1: Understand cy.get() behavior with multiple matches

   cy.get() selects all matching elements, but .click() clicks only the first matched element by default.

2. Step 2: Confirm no error is thrown

   Cypress does not throw an error when multiple elements match; it acts on the first element unless specified otherwise.

3. Final Answer:

   Clicks the first element with class btn-primary -> Option A

4. Quick Check:

   cy.get() + .click() clicks first match [OK]

Hint: Click acts on first matched element by default [OK]

Common Mistakes:

• Assuming all matched elements are clicked
• Expecting an error when multiple elements match
• Thinking click chooses a random element

4. You wrote this Cypress test:

cy.get('.submit-btn').click()

But the test fails with error: Timed out retrying: Expected to find element: .submit-btn, but never found it.
What is the most likely cause?

medium

A. The selector .submit-btn does not match any element on the page

B. You forgot to call cy.click() after cy.get()

C. The click() command is not supported on buttons

D. The page is not loaded before running the test

Solution

1. Step 1: Analyze the error message

   The error says Cypress could not find any element matching .submit-btn. This means the selector is incorrect or the element is missing.

2. Step 2: Check other options

   You did call click() correctly, so B is wrong. click() works on buttons, so C is wrong. If the page was not loaded, the error would be different or you would use cy.visit() and wait commands, so A is less likely.

3. Final Answer:

   The selector .submit-btn does not match any element on the page -> Option A

4. Quick Check:

   Selector not found = test fails [OK]

Hint: Check if selector matches any element before clicking [OK]

Common Mistakes:

• Assuming click() is missing when it is present
• Thinking click() can't be used on buttons
• Ignoring selector correctness or page load state

5. You want to click a checkbox only if it is not already checked. Which Cypress code correctly does this?

hard

A. cy.get('#agree').check()

B. cy.get('#agree').then($el => { if (!$el.is(':checked')) { cy.wrap($el).click() } })

C. cy.get('#agree').click({ force: true })

D. cy.get('#agree').click()

Solution

1. Step 1: Understand the requirement

   You want to click the checkbox only if it is not checked yet, to avoid toggling it off accidentally.

2. Step 2: Analyze each option

   cy.get('#agree').then($el => { if (!$el.is(':checked')) { cy.wrap($el).click() } }) uses then to check if the checkbox is unchecked, then clicks it. cy.get('#agree').click({ force: true }) forces a click regardless of state. cy.get('#agree').check() uses check(), which is a better way to check a checkbox but not a click. cy.get('#agree').click() clicks unconditionally.

3. Step 3: Choose the best option

   cy.get('#agree').then($el => { if (!$el.is(':checked')) { cy.wrap($el).click() } }) correctly checks the state and clicks only if unchecked, matching the requirement.

4. Final Answer:

   cy.get('#agree').then($el => { if (!$el.is(':checked')) { cy.wrap($el).click() } }) -> Option B

5. Quick Check:

   Check state before click to avoid toggling off [OK]

Hint: Check checkbox state before clicking to avoid toggling [OK]

Common Mistakes:

• Clicking checkbox without checking state
• Using click({ force: true }) unnecessarily
• Confusing click() with check()