fundamentals__errors

Handling application errors

For more details, see Cypress catalogue of events

Exceptions

If an application throws an error, it fails the Cypress test automatically.

You can see how to ignore such errors in cypress/integration/app-error.js spec file.

See short video about this topic here: https://www.youtube.com/watch?v=DwVezYq4zPM

Test fails

If a Cypress command fails, the test fails

You can listen to the "fail" events and return false to NOT fail the test, as cypress/integration/test-fails.js shows.

Unhandled promise rejections in the application

If the application code creates an unhandled rejected promise, Cypress does NOT see it by default and continues with the test. If you want to fail the test, listen to the unhandled promise event and throw an error.

You can register your own unhandled promise event listener during cy.visit as cypress/integration/unhandled-promise.js shows. Or you can register the window handler for all tests using Cypress.on('window:before:load') call, see cypress/integration/unhandled-promise2.js.

You can also watch a small video explaining it here: https://www.youtube.com/watch?v=VY9yVle8LRQ

Unhandled promise rejections in the test code

If your test code has an unhandled promise rejection, Cypress test happily continues. You can register handlers to fail the test. See cypress/integration/unhandled-promise-in-test.js, but you have two choices:

If the test code uses Cypress.Promise API, then:

Cypress.Promise.onPossiblyUnhandledRejection((error, promise) => {
  throw error
})

If the test code uses native window.Promise then register a window event listener

window.addEventListener('unhandledrejection', (event) => {
  throw event.reason
})

Note: because this is the test window object, such listeners are NOT reset before every test. You can register such listener once using before hook in the spec file.