cy.click() in Cypress

Introduction

The cy.click() command simulates a mouse click on a web page element. It helps test if buttons, links, or other clickable items work as expected.

When you want to test if a button submits a form correctly.

When you need to check if clicking a link navigates to the right page.

When verifying that clicking a checkbox or radio button changes its state.

When testing if clicking a menu item opens a dropdown.

When simulating user interaction on any clickable element.

Syntax

Cypress

cy.get('selector').click(options)

cy.get('selector') finds the element to click.

options is optional and can control click behavior like force clicking.

Examples

Clicks the button with id submit.

Cypress

cy.get('button#submit').click()

Clicks a link with class nav-link even if it is hidden or disabled.

Cypress

cy.get('a.nav-link').click({ force: true })

Clicks a checkbox input to toggle its state.

Cypress

cy.get('input[type="checkbox"]').click()

Sample Program

This test visits a page, clicks a button with id submit, and checks if the result area shows the text 'Submitted'.

Cypress

describe('Button click test', () => {
  it('Clicks the submit button and checks result', () => {
    cy.visit('https://example.cypress.io')
    cy.get('button#submit').click()
    cy.get('#result').should('contain.text', 'Submitted')
  })
})

Important Notes

Always use a reliable selector with cy.get() to avoid flaky tests.

Use { force: true } option carefully to click hidden or disabled elements.

Remember that cy.click() waits for the element to be visible and enabled before clicking.

Summary

cy.click() simulates a user clicking an element on the page.

Use it to test buttons, links, checkboxes, and other clickable elements.

Combine with cy.get() to select the element before clicking.

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()