Released 11/10/2021
Breaking Changes:
- The
nodeVersionconfiguration option now defaults tosystem. The behavior
of thesystemoption has changed to always use the Node.js binary/version
that launched Cypress. If Cypress was not launched via the terminal, Cypress
will use thebundledNode.js version. This could change the behavior of code
within yourpluginsFilesince it may be run in yoursystemNode.js
version. Addresses
#18684. - Windows 32-bit is no longer supported in Cypress. Addresses
#17962. - An error will now be thrown if an invalid value is passed to
Cypress.config.
Previously invalid values were ignored and could cause unexpected behavior.
Addresses #18589. cy.contains()no longer yields the<body>element when it matches the
content of<script>or<style>tags. Addresses
#14861.- Attempting to add an existing built-in Cypress command using
Cypress.Commands.add()will now throw an error, indicating that
Cypress.Commands.overwrite()should be used instead to overwrite the
behavior of existing commands. Addresses
#18572. - Custom command implementations are now typed based on the declared custom
chainables. Addresses
#17496. - The bundled Node.js version was upgraded from
14.17.0to16.5.0. This
could change the behavior of code within thepluginsFilewhen using the
bundled Node.js version of Cypress. Addressed in
#18317.
Deprecations:
- The
nodeVersionconfiguration option has been deprecated and will be removed
in a future release.
Features:
- When
nullis passed as the encoding tocy.readFile()orcy.fixture(),
the file is treated as binary and read as a Buffer. Similarly,nullpassed
as the encoding tocy.writeFile()allows direct writing of buffers. If the
encoding is unspecified, the default remainsutf8, matching the current
behavior. Addresses
#18534.
Bugfixes:
- Sticky elements within a fixed container will now be able to be properly
scrolled to during action commands. Fixes
#4233. document.referrerwill now correctly reflect the correct value from the
application under test aftercy.visit(). Fixes
#4295.
Dependencies: