Use the Most Robust Selector for Cypress Tests
Which selectors your choose for your tests matter, a lot. In this lesson, we'll see the recommended Cypress best practices for selectors, and why we should prefer the data-cy attribute.
The automatically follows these best practices.
When determining an unique selector it will automatically prefer elements with:
data-cy
data-test
data-testid
Assert on Your Redux Store with Cypress
Cypress doesn't provide out-of-the-box ability to make assertions on our frontend stores, so let's expose the store to the tests, and assert on it. We'll use our knowledge of Cypress's asynchronous programming style to access properties and functions on the store using cy.its and cy.invoke.
Inside applicatioin:
if(window.Cypress) { window.store = store}
Inside test:
cy.window().then(($window) => {console.log($window.store)})or cy.window().its('store')
What we want is to be able to make assertions against the state of the store. In order to get the state of the store, we would normally call, getState
which is a function, not a property like store. In order to do this, we can call, .invoke
.
cy.window().its('store').invoke('getState').then(($state) => { console.log($state)})
Create Custom Cypress Commands with better logs
Do you need to reuse complex Cypress calls often (like when accessing the store)?
You can turn them into custom Cypress commands, and even customize their output in the time-traveling debugger, so it's easy to see a snapshot at the point your command ran!
commands:
Cypress.Commands.add("store", (stateName = '') => { let log = Cypress.log({name: 'store'}) const cb = (state) => { log.set({ message: JSON.stringify(state), consoleProps: () => { return state } }) return state } return cy.window({ log: false}).then(($window) => { return $window.store.getState() }).then((state) => { if (stateName.length > 0) { return cy.wrap(state, {log: false}).its(stateName).then(cb) } else { return cy.wrap(state, {log: false}).then(cb) } })})
Test:
cy.store('todos').should('deep.equal', [{ id: 1, text: 'Hello world', completed: false }, { id: 2, text: 'Goodnight moon', completed: true }])// or cy.store('example.test.first')
Wrap External Libraries with Cypress
External libraries tend to be synchronous, so how do we integrate other powerful tools into the Cypress framework? This lesson walks us through merging in the Lodash library to Cypress to allow us to slice and dice data to more accurately assert on just the pieces of data we care about.
commands.js
const _ = require('lodash')let loMethods = _.functions(_).map((fn) => { return 'lo_${fn}'})loMethods.forEach((loFn) => { let loName = loFn.replace(/lo_/, '')Cypress.Commands.add(loFn, {prevSubject: true}, (subject, fn, ...args) => { let result = _[loName](subject, fn, ...args) Cypress.log({ name: 'lo_filter', message: JSON.stringify(result), consoleProps: () => { return result } }) return result})
Use:
cy.store('todos') .lo_find((todo) => { return todo.id == 1}) .lo_pick('text') .should('deep.equal', [ { text: '1st Todo', }, ... ])
Find Unstubbed Cypress Requests with Force 404
Requests that aren't stubbed will hit our real backend. To ensure we've stubbed all our routes, we can use the force404 method to send 404s from any unstubbed routes.
cy.server({force404: true})