Why cy.click() in Cypress? - Purpose & Use Cases

The Big Idea

What if you could test every button on your site in seconds without lifting a finger?

The Scenario

Imagine you have a website with many buttons and links. You want to check if clicking each one works correctly. Doing this by hand means opening the site, clicking each button, and watching what happens every time.

The Problem

Manually clicking buttons is slow and tiring. You might miss some clicks or forget to check what happens next. It's easy to make mistakes or get bored, which means bugs can slip through unnoticed.

The Solution

The cy.click() command in Cypress lets you automate clicking buttons and links. It does the clicking for you, exactly how a user would, but faster and without mistakes. You can repeat tests anytime with the same results.

Before vs After

✗ Before

Open browser
Find button
Click button
Check result
Repeat for each button

✓ After

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

What It Enables

Automated clicking lets you test your website quickly and reliably, catching problems before real users do.

Real Life Example

When a developer changes a website, cy.click() helps testers quickly check if all buttons still work, saving hours of manual work.

Key Takeaways

Manual clicking is slow and error-prone.

cy.click() automates user clicks reliably.

This speeds up testing and improves quality.

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