cypress-should-really

Functional helpers for constructing Cypress should callbacks

Usage no npm install needed!

<script type="module">
  import cypressShouldReally from 'https://cdn.skypack.dev/cypress-should-really';
</script>

README

cypress-should-really ci cypress version renovate-app badge

Read the blog posts Functional Helpers For Cypress Tests and Check Items For Duplicates

Example

Grab text from each list item, convert the strings into Dates, convert Dates into timestamps, then confirm they are sorted using chai-sorted assertion.

import { innerText, toDate, invoke } from 'cypress-should-really'
cy.get('.dates')
  .then(map('innerText'))
  .then(map(toDate))
  .then(invoke('getDate'))
  .should('be.sorted')

The above separates each operation using cy.then commands, which are not retried. Luckily, we can easily combine the individual steps into a single data transformation function using the pipe command.

import { innerText, toDate, invoke, pipe } from 'cypress-should-really'
const transform = pipe(map('innerText'), map(toDate), invoke('getDate'))
cy.get('.dates').then(transform).should('be.sorted')

The above commands are still NOT retrying the first cy.get command, thus if the page changes, the assertion still fails since it never "sees" the changed elements. We need to remove the .then(transform) step and directly tie the cy.get command to the assertion. We can move the data transformation into the assertion callback that transforms the data AND runs the assertion using really function.

import { innerText, toDate, invoke, pipe, really } from 'cypress-should-really'
const transform = pipe(map('innerText'), map(toDate), invoke('getDate'))
cy.get('.dates').should(really(transform, 'be.sorted'))

Finally, we can skip using the pipe function, since it is built into the really automatically. All functions before the assertion are applied and then the assertion runs.

import { innerText, toDate, invoke, really } from 'cypress-should-really'
cy.get('.dates').should(
  really(map('innerText'), map(toDate), invoke('getDate'), 'be.sorted'),
)

Installation

$ npm i -D cypress-should-really
# or install using Yarn
$ yarn add -D cypress-should-really

API

  • map
  • invoke
  • constructor
  • toDate (deprecated) use constructor(Date) instead
  • its
  • greaterThan
  • flipTwoArguments
  • partial
  • pipe
  • tap
  • really

invoke

invoke(<method name>, ...arguments) returns a function that waits for an object or an array, then calls the method and returns the results

const calc = {
  add(a, b) {
    return a + b
  },
}
invoke('add', 1, 2)(calc)
// 3

See invoke-spec.js

constructor

Takes a constructor function, returns a function that waits for a single argument and calls with the new keyword.

import {constructor} from 'cypress-should-really'
// converts a string to Date object
.then(constructor(Date))

tap

Passes the argument into the given function, but returns the original argument. Useful for debugging pipes of functions - insert it in every place of the pipeline to see the values.

const o = {
  name: 'Joe',
}
cy.wrap(o).should(really(its('name'), tap(console.log), 'equal', 'Mary'))
// change the name to Mary after some time
setTimeout(() => {
  o.name = 'Mary'
}, 1000)

In the above example, the console.log the string "Joe" multiple times, before logging "Mary" once and passing the test.

See tap-spec.js

See also

Small print

Author: Gleb Bahmutov <gleb.bahmutov@gmail.com> © 2021

License: MIT - do anything with the code, but don't blame me if it does not work.

Support: if you find any problems with this module, email / tweet / open issue on Github

MIT License

Copyright (c) 2021 Gleb Bahmutov <gleb.bahmutov@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.