cypress/docs/source/guides/references/known-issues.md

title, comments

title	comments
Known Issues	false

Missing Commands

Some commands have not been implemented in Cypress. Some commands will be implemented in the future and some do not make sense to implement in Cypress.

Right click

{% fa fa-github %} {% issue 53 'Issue #53' %}

Workaround

Oftentimes you can use {% url .invoke() invoke %} or {% url cy.wrap() wrap %} to trigger the event or execute the action in the DOM.

Example of right clicking on an element using jQuery

cy.get('#nav').first().invoke('trigger', 'contextmenu')

Example of right clicking on an element without jQuery

// need to create the event to later dispatch
var e = new Event('contextmenu', {bubbles: true, cancelable: true})
// set coordinates of click
e.clientX = 451
e.clientY = 68

cy
  .get('#nav').first().then(function($el) {
    $el[0].dispatchEvent(e)
  })

Hover

{% fa fa-github %} {% issue 10 'Issue #10' %}

Sometimes an element has specific logic on hover. Maybe the element doesn't even display to be clickable until you hover over a specific element.

Workaround

Oftentimes you can use {% url .invoke() invoke %} or {% url cy.wrap() wrap %} to show the element before you perform the action.

Example of showing an element in order to perform action

cy.get('.content').invoke('show').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('.content').click({force: true})

Example of checking a hidden element

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

Difficult use cases

Cypress does not support the following use cases.

Iframes

{% fa fa-github %} {% issue 136 'Issue #136' %}

You cannot target elements or interact with anything in an iframe - regardless of it being a same domain or cross domain iframe.

This is actively being worked on in Cypress and you'll first see support for same domain iframes, followed by cross domain (they are much harder to do).

Workaround

Sit tight, comment on the issue so we know you care about this support, and be patient.

OAuth

This is related to the iframe issue above, but basically oauth usually will not work. This is one of the hardest things for Cypress to be able to handle as there are so many different implementations and mechanisms.

Likely we will be able to support server side oauth redirects, but for client side popups you'll simply use sinon and stub the oauth response directly in your code. This is actually possible to do right now but we don't have any good docs or tutorials on it.

Workaround

Come into Gitter and talk to us about what you're trying to do. We'll tell you if you're able to mock this and how to do it.

window.fetch routing and stubbing

{% fa fa-github %} {% issue 95 'Issue #95' %}

Support for fetch has not been added but it's possible to handle in the same way as we handle XHRs. This biggest challenge here is that you can use fetch in Service Workers outside of the global context. We'll likely have to move routing to the server and handle it in the proxy layer but it should be possible.

While we currently provide things like the stack trace and initiator line for XHR's we will not be able to provide that for fetch.

Workaround

Sit tight, comment on the issue so we know you care about this support, and be patient.