W3cubDocs

/Cypress

hover

Cypress does not have a cy.hover() command. See Issue #10.

If cy.hover() is used, an error will display and redirect you to this page.

Workarounds

Sometimes an element has specific logic on hover and you do need to “hover” in Cypress. Maybe the element doesn’t even display to be clickable until you hover over another element.

Oftentimes you can use .trigger(), .invoke() or cy.wrap() to show the element before you perform the action.

Check out our example recipe on testing hover and working with hidden elements

Trigger

If the hover behavior depends on a JavaScript event like mouseover, you can trigger the event to achieve that behavior.

Using .trigger() will only affect events in JavaScript and will not trigger any effects in CSS.

As a workaround, check out the recipe leveraging Chrome remote debugging to set pseudo classes like hover.

Simulating mouseover event to get popover to display

cy.get('.menu-item').trigger('mouseover')
cy.get('.popover').should('be.visible')

Invoke

Example of showing an element in order to perform action

cy.get('.hidden').invoke('show').click()

Force click

You can also force the action to be performed on the element regardless of whether the element is visible or not.

Example of clicking on a hidden element

cy.get('.hidden').click({ force: true })

Example of checking a hidden element

cy.get('.checkbox').check({ force: true })

See also

© 2020 Cypress.io
Licensed under the MIT License.
https://docs.cypress.io/api/commands/hover.html