cy.trigger() for custom events in Cypress - Cheat Sheet & Quick Revision

Recall & Review

beginner

What does cy.trigger() do in Cypress?

cy.trigger() simulates an event on a DOM element, like clicks or custom events, to test how your app reacts.

beginner

How do you trigger a custom event named myEvent on an element using cy.trigger()?

Use cy.get('selector').trigger('myEvent') to fire the custom event myEvent on the selected element.

intermediate

Can cy.trigger() send extra data with a custom event? How?

Yes! Pass an object as the second argument with extra properties, like { detail: { key: 'value' } }, to send data with the event.

intermediate

What is a real-life example of using cy.trigger() with a custom event?

Imagine a button that fires a userLoggedIn event. You can test it by triggering userLoggedIn on the button and checking if the app updates accordingly.

beginner

Why use cy.trigger() instead of cy.click() for custom events?

cy.click() only simulates mouse clicks. cy.trigger() can simulate any event, including custom ones your app listens for.

What is the main purpose of cy.trigger() in Cypress?

A To simulate any event on a DOM element

B To type text into input fields

C To navigate to a new page

D To take screenshots

cy.trigger() simulates events like clicks or custom events on elements.

How do you pass extra data with a custom event using cy.trigger()?

A By adding a third argument with data

B By passing an object as the second argument

C By chaining <code>.data()</code> after <code>cy.trigger()</code>

D You cannot pass extra data

Extra data is passed as an object in the second argument of cy.trigger().

Which of these events can cy.trigger() simulate?

A Only mouse clicks

B Only keyboard events

C Any DOM event including custom events

D Only form submissions

cy.trigger() can simulate any DOM event, including custom ones.

If your app listens for a custom event dataLoaded, how do you test it with Cypress?

A Use <code>cy.trigger('dataLoaded')</code> on the element

B Use <code>cy.visit('dataLoaded')</code>

C Use <code>cy.type('dataLoaded')</code>

D Use <code>cy.click()</code> on the element

Trigger the custom event dataLoaded with cy.trigger() to test event handling.

Why might you choose cy.trigger() over cy.click()?

A <code>cy.click()</code> only works on buttons

B <code>cy.click()</code> is deprecated

C <code>cy.trigger()</code> types text faster

D <code>cy.trigger()</code> can simulate events other than clicks

cy.trigger() is more flexible and can simulate any event, not just clicks.

Explain how to use cy.trigger() to simulate a custom event with extra data on a DOM element.

Think about how you tell Cypress which element and event to use, and how to add data.

Describe a scenario where using cy.trigger() is better than cy.click() in testing.

Consider events your app listens for that are not mouse clicks.

Practice

1. What does cy.trigger() do in Cypress when testing web pages?

easy

A. It simulates user or custom events on page elements.

B. It creates a new database entry.

C. It styles the page elements dynamically.

D. It fetches data from an API.

Solution

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

   cy.trigger() is used in Cypress to simulate events like clicks or custom events on elements.

2. Step 2: Compare options with the purpose

   Only the option 'It simulates user or custom events on page elements.' correctly describes simulating events. Other options describe unrelated actions.

3. Final Answer:

   It simulates user or custom events on page elements. -> Option A

4. Quick Check:

   cy.trigger() = simulate events [OK]

Hint: Remember: cy.trigger() fires events on elements [OK]

Common Mistakes:

• Thinking cy.trigger() fetches data
• Confusing cy.trigger() with styling functions
• Assuming it modifies database entries

2. Which of the following is the correct syntax to trigger a custom event named myEvent on an element with id #btn in Cypress?

easy

A. cy.get('#btn').trigger('myEvent')

B. cy.trigger('#btn', 'myEvent')

C. cy.get('#btn').fire('myEvent')

D. cy.triggerEvent('#btn', 'myEvent')

Solution

1. Step 1: Recall correct method chaining in Cypress

   To trigger an event on an element, first select it with cy.get(), then call .trigger() with the event name.

2. Step 2: Check each option's syntax

   cy.get('#btn').trigger('myEvent') matches the correct pattern. The other options use invalid Cypress commands.

3. Final Answer:

   cy.get('#btn').trigger('myEvent') -> Option A

4. Quick Check:

   Use cy.get().trigger() for events [OK]

Hint: Always select element first with cy.get(), then trigger event [OK]

Common Mistakes:

• Calling trigger() directly on cy without get()
• Using non-existent methods like fire() or triggerEvent()
• Passing selector as first argument to trigger()

3. Consider the code:

cy.get('#input').trigger('customChange', { detail: { value: 42 } })

What will be the effect of this code in a Cypress test?

medium

A. It causes a syntax error because of the detail object.

B. It changes the value of #input to 42 directly.

C. It triggers a click event instead of 'customChange'.

D. It triggers a 'customChange' event on #input with extra data { value: 42 }.

Solution

1. Step 1: Understand event triggering with extra options

   The trigger method can send custom events with additional data via the detail property.

2. Step 2: Analyze the code effect

   The code triggers 'customChange' on '#input' and passes { value: 42 } as event detail. It does not change input value directly or cause syntax errors.

3. Final Answer:

   It triggers a 'customChange' event on #input with extra data { value: 42 }. -> Option D

4. Quick Check:

   trigger(event, {detail}) sends custom event data [OK]

Hint: Use detail object to pass extra event data [OK]

Common Mistakes:

• Assuming trigger changes element properties directly
• Confusing event name with standard events like click
• Thinking detail causes syntax errors

4. You wrote this Cypress code:

cy.get('#form').trigger('submit', { bubbles: true })

But the form does not submit as expected. What is the likely problem?

medium

A. You must pass the event object manually; trigger() cannot send options.

B. The event name 'submit' is invalid for trigger().

C. The 'submit' event must be triggered on the form element, but it requires calling .submit() instead.

D. The bubbles option should be false for submit events.

Solution

1. Step 1: Understand how form submission works in Cypress

   Triggering 'submit' event alone may not cause form submission; Cypress recommends using .submit() command.

2. Step 2: Analyze the code and options

   The 'submit' event must be triggered on the form element, but it requires calling .submit() instead. correctly states that triggering 'submit' event is not enough; .submit() triggers native submission. Other options are incorrect about event validity and options usage.

3. Final Answer:

   The 'submit' event must be triggered on the form element, but it requires calling .submit() instead. -> Option C

4. Quick Check:

   Use .submit() to submit forms, not just trigger('submit') [OK]

Hint: Use .submit() for forms, not just trigger('submit') [OK]

Common Mistakes:

• Assuming trigger('submit') submits form
• Misusing bubbles option for submit event
• Thinking trigger() cannot send options

5. You want to test a custom event dataReady on a div with id #container. This event should carry a payload with a list of items. Which code correctly triggers this event with the payload { items: [1, 2, 3] } and ensures event bubbles up?

hard

A. cy.get('#container').trigger('dataReady', { items: [1, 2, 3], bubbles: true })

B. cy.get('#container').trigger('dataReady', { detail: { items: [1, 2, 3] }, bubbles: true })

C. cy.get('#container').trigger('dataReady', { detail: [1, 2, 3], bubbles: false })

D. cy.get('#container').trigger('dataReady', { payload: { items: [1, 2, 3] }, bubbles: true })

Solution

1. Step 1: Recall how to pass custom data in events

   Custom event data must be inside a detail object when triggering events.

2. Step 2: Check bubbling option and payload structure

   cy.get('#container').trigger('dataReady', { detail: { items: [1, 2, 3] }, bubbles: true }) correctly uses detail with the payload and sets bubbles: true. Other options either miss detail or have wrong payload keys or bubbling.

3. Final Answer:

   cy.get('#container').trigger('dataReady', { detail: { items: [1, 2, 3] }, bubbles: true }) -> Option B

4. Quick Check:

   Use detail for payload and bubbles:true to bubble event [OK]

Hint: Put payload inside detail and set bubbles:true to bubble event [OK]

Common Mistakes:

• Passing payload outside detail object
• Forgetting to set bubbles:true for bubbling
• Using wrong property names like payload instead of detail