cypress-should-really  !cypress version [![renovate-app badge][renovate-badge]][renovate-app]

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.

``js
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.

`js
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.

`js
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.

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

Installation

`text
$ 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
- filter
- isEqual
- really

invoke

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

`js
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.

`js
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.

`js
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

Videos

- Filter Input Elements By Value Using cypress-should-really Plugin

See also

- cypress-recurse

Small print

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

- @bahmutov
- glebbahmutov.com
- blog
- videos
- presentations
- cypress.tips

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.

[renovate-badge]: https://img.shields.io/badge/renovate-app-blue.svg
[renovate-app]: https://renovateapp.com/