cypress
16.3.0 · 10 Nov 2026MIT7.6M / weekRepositoryHomepagenpmAtom feed
289 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 12.x
12.17.0
6 Jul 2023Cypress Cloud users can now receive desktop notifications about their runs, including when one starts, finishes, or fails. Addresses #26686.
Fixed a regression introduced in Cypress 12.12.0 where Cypress may fail to reconnect to the Chrome DevTools Protocol in Electron. Fixes #26900.
12.17.0
Released Jul 06, 2023
Features:
Cypress Cloud users can now receive desktop notifications about their runs, including when one starts, finishes, or fails. Addresses #26686.
Bugfixes:
Fixed issues where commands would fail with the error
must only be invoked from the spec file or support file. Fixes #27149 and #27163.Fixed a regression introduced in Cypress 12.12.0 where Cypress may fail to reconnect to the Chrome DevTools Protocol in Electron. Fixes #26900.
Fixed an issue where chrome was not recovering from browser crashes properly. Fixes #24650.
Fixed a race condition that was causing a GraphQL error to appear on the Debug page when viewing a running Cypress Cloud build. Fixed in #27134.
Fixed a race condition in electron where the test window exiting prematurely during the browser launch process was causing the whole test run to fail. Addressed in #27167.
Fixed minor issues with TypeScript types in the CLI. Fixes #24110.
Fixed an issue where a value for the Electron debug port would not be respected if defined using the
ELECTRON_EXTRA_LAUNCH_ARGSenvironment variable. Fixes #26711.
Dependency Updates:
12.12.0
9 May 2023- Security
Upgraded plist from
3.0.5to3.0.6to address CVE-2022-26260NVD security vulnerability. Addressed in #26631. - Security
Upgraded engine.io from
6.2.1to6.4.2to address CVE-2023-31125NVD security vulnerability. Addressed in #26664. Added a new informational banner to help get started with component testing from an existing end-to-end test suite. Addresses #26511.
12.12.0
Released May 09, 2023
Features:
Added a new informational banner to help get started with component testing from an existing end-to-end test suite. Addresses #26511.
Bugfixes:
Fixed an issue in Electron where devtools gets out of sync with the DOM occasionally. Addresses #15932.
Updated the Chromium renderer process crash message to be more terse. Addressed in #26597.
Fixed an issue with
CYPRESS_DOWNLOAD_PATH_TEMPLATEregex to allow multiple replacements. Addresses #23670.
Dependency Updates:
- Security
Upgraded plist from
3.0.5to3.0.6to address CVE-2022-26260NVD security vulnerability. Addressed in #26631. - Security
Upgraded engine.io from
6.2.1to6.4.2to address CVE-2023-31125NVD security vulnerability. Addressed in #26664. Upgraded @vue/test-utilsfrom
2.0.2to2.3.2. Addresses #26575.
12.11.0
26 Apr 2023Added Component Testing support for Angular 16. Addresses #26044.
The run navigation component on the Debug page now displays a warning message if there are more relevant runs than can be displayed in the list. Addresses #26288.
12.11.0
Released Apr 26, 2023
Features:
Added Component Testing support for Angular 16. Addresses #26044.
The run navigation component on the Debug page now displays a warning message if there are more relevant runs than can be displayed in the list. Addresses #26288.
Bugfixes:
Fixed an issue where setting
videoCompressionto0would cause the video output to be broken.0is now treated as false. Addresses #5191 and #24595.Fixed an issue on the Debug page where the passing run status would appear even if the Cypress Cloud organization was over its monthly test result limit. Addresses #26528.
Misc:
Cleaned up our open telemetry dependencies, reducing the size of the open telemetry modules. Addressed in #26522.
Dependency Updates:
12.10.0
17 Apr 2023- Security
Upgraded minimist from
1.2.6to1.2.8to address this CVE-2021-44906 NVD security vulnerability. Addressed in #26254. The Component Testing setup wizard now shows a warning message if an issue is encountered with an installed third party framework definition. Addresses #25838.
Capture the Azure CI provider's environment variable SYSTEM_PULLREQUEST_PULLREQUESTNUMBERto display the linked PR number in the Cloud. Addressed in #26215.
12.10.0
Released Apr 17, 2023
Features:
The Component Testing setup wizard now shows a warning message if an issue is encountered with an installed third party framework definition. Addresses #25838.
Bugfixes:
Capture the Azure CI provider's environment variable SYSTEM_PULLREQUEST_PULLREQUESTNUMBERto display the linked PR number in the Cloud. Addressed in #26215.
Fixed an issue in the onboarding wizard where project framework & bundler would not be auto-detected when opening directly into component testing mode using the
--componentCLI flag. Fixes #22777 and #26388.Updated to use the
SEMAPHORE_GIT_WORKING_BRANCHSemaphore CI environment variable to correctly associate a Cloud run to the current branch. Previously this was incorrectly associating a run to the target branch. Fixes #26309.Fix an edge case in Component Testing where a custom
baseUrlintsconfig.jsonfor Next.js 13.2.0+ is not respected. The issue was partially fixed in #26005, but an edge case was missed. Fixes #25951.Correctly detect and resolve dependencies when configuring Component Testing in projects using Yarn's Plug'n'Play feature. Fixes #25960.
Fixed an issue where
clickevents fired on .type('{enter}') did not propagate through shadow roots. Fixes #26392.
Misc:
Removed unintentional debug logs. Addressed in #26411.
Dependency Updates:
Upgraded commander from
^5.1.0to^6.2.1. Addressed in #26226.- Security
Upgraded minimist from
1.2.6to1.2.8to address this CVE-2021-44906 NVD security vulnerability. Addressed in #26254.
12.9.0
28 Mar 202312.8.1
15 Mar 2023Reading the note…
12.5.1
2 Feb 2023Reading the note…
12.5.0
31 Jan 202312.4.1
27 Jan 2023Reading the note…
12.2.0
20 Dec 2022Added the ability to match on
resourceTypewith cy.intercept(), and to see the resource type of an intercepted request asreq.resourceType. Addresses #14525.Users working in React Component Testing projects can now generate a basic spec file from the components that exist in their project. Addresses #24008.
Fixed a regression introduced in the Electron browser in Cypress 10.8.0 where the
CYPRESS_EVERY_NTH_FRAMEenvironment variable was not being set appropriately causing all frames to be captured which slowed down tests. Fixes #23830.
12.2.0
Released Dec 20, 2022
Features:
Added the ability to match on
resourceTypewith cy.intercept(), and to see the resource type of an intercepted request asreq.resourceType. Addresses #14525.Users working in React Component Testing projects can now generate a basic spec file from the components that exist in their project. Addresses #24008.
Performance:
Fixed a regression introduced in the Electron browser in Cypress 10.8.0 where the
CYPRESS_EVERY_NTH_FRAMEenvironment variable was not being set appropriately causing all frames to be captured which slowed down tests. Fixes #23830.
Bugfixes:
Fixed an issue where the
queryobject was not available on requests from cy.intercept() once they were yielded. Fixes #25088.Fixed an issue with Angular Component Testing where urls within SASS/SCSS files were not being correctly resolved which could result in incomplete styling. Fixes #24272.
Fixed a regression introduced in Cypress 12 where cy.get() would ignore a
nullvalue for thewithinSubjectoption. Fixes #25104.Fixed an issue where an unhandled promise rejection would display an incomplete error message in the command log. Fixes #24915.
Fixed an issue where the incorrect Cypress version could be shown in the migration wizard. Fixes #25138.
Fixed an issue where the Cypress migration wizard would fail to run in global mode on newer versions of Cypress. Addressed in #25138.
Fixed an issue with Angular Component Testing where a custom sourceRootconfiguration would not be respected. Fixes #24827.
Fixed TypeScript typings for cy.nextUntil() to include the
filterparameter. Fixes #24772.
12.1.0
12 Dec 2022Added cy.getAllCookies() and cy.clearAllCookies(), which get and clear cookies for all browser cookies across any domains. Addresses #24265, #8956, and #408.
Updated the error messaging to provide more context when parallel group parameters are mismatched when sent to the Cypress Cloud. Fixes #24734.
Fixed an issue with the
cy.sessioncommand where it now recollects the session data after validation is successful to correctly store the full browser context before the command ends. Addressed with #25112.
12.1.0
Released Dec 12, 2022
Features:
Added cy.getAllCookies() and cy.clearAllCookies(), which get and clear cookies for all browser cookies across any domains. Addresses #24265, #8956, and #408.
Updated the error messaging to provide more context when parallel group parameters are mismatched when sent to the Cypress Cloud. Fixes #24734.
Bugfixes:
Fixed an issue with the
cy.sessioncommand where it now recollects the session data after validation is successful to correctly store the full browser context before the command ends. Addressed with #25112.Fixed an issue where recent versions of Firefox in headless mode would behave inconsistently with headed. Fixes #24900.
Fixed an issue where .select(index) would fail when multiple
<option>elements have the same value property. Fixes #24739.Cleaned up temp files generated by
cypress run. Addressed by #24957.The Chrome web security configuration tooltip will now be shown only if chromeWebSecurity is set to false when using a non-chromium browser. Fixes #23846.
Fixed an issue where updating a component would not trigger the
supportFileto reload imported stylesheets. This is fixed by doing a full reload for Vite, to ensure the spec re-runs correctly with the latest styles. Fixes #24874.The Run All Specs experimentwill now open in a new tab rather than close and reopen the browser. This will make the run faster and help mitigate #21743. Fixes #24919.
12.0.2
8 Dec 2022Reading the note…
12.0.1
7 Dec 2022Reading the note…
12.0.0
6 Dec 2022- Breaking
Cypress dropped support for Node.js 12, 15, and 17. Those versions have reached end-of-life. Installing Cypress on your system now requires Node.js 14, 16 or 18+. Addressed in #24885.
Testing multiple origins in a single test with the new cy.origin() command.
Caching and restoring cookies, localStorage, and sessionStoragebetween tests.
12.0.0
Released Dec 06, 2022
Summary:
The Session and Origin Experiment is now generally available for end-to-end testing. This means Cypress now fully supports:
Testing multiple origins in a single test with the new cy.origin() command.
Caching and restoring cookies, localStorage, and sessionStoragebetween tests.
Configuring testIsolationin suites to define whether or not the browser context is cleaned or persisted between tests.
Additionally in this release, enhancements were made to how Cypress manages DOM element resolution to reduce the likelihood of hitting detached DOM errors due to maintaining stale DOM references. We've updated our Retry-ability Guide with all the details if you'd like to learn more.
Read more about 12.0 in our blog post.
Breaking Changes:
- Breaking
Cypress dropped support for Node.js 12, 15, and 17. Those versions have reached end-of-life. Installing Cypress on your system now requires Node.js 14, 16 or 18+. Addressed in #24885.
Cypress has always recommended writing tests in a clean context. In Cypress 12, we enforce running tests in a clean browser context through test isolation. This option is configurable, but is enabled by default. Whether enabled or disabled, this changes how Cypress cleans up the browser context before each test and you may experience test errors with this upgrade. To better understand the full impact of this change, review the migration guide.
In Cypress v12, the
testIsolationconfiguration values have changed fromonorofftotrueorfalse. Addressed in #24935.
The
experimentalSessionAndOriginconfiguration option has been removed and all functionality associated with this experiment is now enabled by default, with the exception of usingrequireandimportwith callback supplied to the cy.origin() command. To use external dependencies incy.origin()callbacks, set the new e2e.experimentalOriginDependenciesconfiguration option totrue. Addresses #21471.The
Cookies.defaultsandCookies.preserveOnceAPIs have been removed. Use the new cy.session() command to preserve cookies between tests. Addresses #21472.The
cy.server()andcy.route()commands have been removed. Additionally, the correspondingCypress.Server.defaultsAPI has also been removed. Use the [cy.intercept()(/api/commands/intercept) command to stub network responses and requests. Addresses #22126.The Cookie commands now uses the
hostnameas the domain by default instead of thesuperdomain. This change aligns Cypress' cookie rules with the browser cookie rules. This may affect what cookies are returned by cy.getCookie(), what cookies are set with cy.setCookie(), and the cookies cleared with cy.clearCookies(). Addresses #363, #5723 and #24526.The .within() command now requires a single subject and throws an error if given more than one subject. This change adds consistency around how
.within()behaves across commands. Previously some commands inside a.within()callback would silently select the first element, while others would use all of the previously yielded subjects, and others would throw an error. Addressed in #24975.Cypress now throws an error if any Cypress commands are invoked from inside a .should() callback. This previously resulted in unusual and undefined behavior. Addresses #5963, #14656 and #22587.
The .invoke() command now throws an error if the invoked function returns a promise. If you wish to call a method that returns a promise and wait for it to resolve, use .then()instead of
.invoke(). Addressed in #24417.The cy.request() command now uses querystringify to stringify & parse the
qsoptions. This change aligns with how the cy.visit() command generates urls with query parameters. Addressed in #20302.
Features:
Added a new configuration option called
testIsolation, which defaults totrue. This option can be set at thee2eor suite-level to determine whether or not test isolationis enabled to ensure a clean browser context between tests. Addressed in #22230.The previously experimental Cypress command, cy.origin(), is now generally available in end-to-end testing. This command allows testing multiple origins in a single test. Addresses #17336.
The previously experimental Cypress command, cy.session(), is now generally available. This command caches and restores
cookies, localStorage, and sessionStorageto recreate a consistent browser context between tests. Addresses #20977.Added a new Cypress command, cy.getAllLocalStorage(), to get localStoragedata for all origins with which the test has interacted. Addresses #24276.
Added a new Cypress command, cy.clearAllLocalStorage(), to clear localStoragedata for all origins with which the test has interacted. Addresses #24276.
Added a new Cypress command, cy.getAllSessionStorage(), to get sessionStoragedata for all origins with which the test has interacted. Addresses #24276.
Added a new Cypress command, cy.clearAllSessionStorage(), to clear sessionStoragedata for all origins with which the test has interacted. Addresses #24276.
Added a new configuration option called experimentalOriginDependencies, which defaults to
false. This option enables support forrequireandimportwithin the callback supplied to the cy.origin() command in end-to-end testing. Previously this feature was enabled through theexperimentalSessionAndOriginconfiguration option.experimentalOriginDependencieswas added as a configuration option in Cypress 12, instead of being enabled by default, due to increased Node.js memory usage associated with this option that needs to be addressed before making this behavior generally available. See issue #24976 for more information. Addressed in #24931.Added a new
Cypress.ensureAPI which provides several methods that can be helpful when writing customs commands. Addressed in #24697.Added a new "Run All" button to the experimentalRunAllSpecsexperiment which enables running all spec files returned from the
specPatternglob or an array of globs, regardless of the specs sharing a root folder. Addresses #24759.Further improved bundling in the binary to reduce startup and unzip time. Addressed in #24909.
Bugfixes:
Fixed a regression in 10.11.0 where the Launchpad no longer showed a loading spinner on startup to indicate that it had successfully started and was in a loading state. Fixed #24950.
Fixed the "Create Spec from Component" capability to correctly scaffold the component spec from a component which contains special characters in its name. Before this change, a spec was scaffolded with either the wrong spec name or the incorrect component import which led to invalid JS errors. Fixes #23492.
Corrected Cypress environment variable resolution to correctly resolve environment variables set with
npm config set. Fixes #24556.When experimentalRunAllSpecs=true, the "Run N specs" directory-level buttons in the Inline Specs List now function correctly when activated by the keyboard. Fixes #24762.
Fixed unexpected behaviors when verifying a cookie was not returned from cy.getCookie(). Now it's possible to explicitly assert the cookie did not exist with
cy.getCookie('foo1').should('not.exist'). Previously users had to verify cookies properties did not exist with.its('value').should('equal', null). Addressed in #24203.Fixed the console output returned from clicking on an aliased intercept in the Command Log. It now logs the yielded request/response object associated to the intercepted call when clicked, where previously it did not log these details. Fixed in #24623.
- 11.x
11.2.0
22 Nov 2022Re-implemented the 'Run All Specs' for End to End Testing for running multiple tests sequentially in open mode. This feature had been previously removed in Cypress 10.0. Enable 'Run All Specs' with the new experimental flag, experimentalRunAllSpecs. Leave any feedback in the 'Run All Specs' discussion. Your feedback will help us make product decisions around the future of this feature. Addresses #24168.
Added messaging after failures in CI to direct people to set up recording to the Cypress Cloud if they are not already set up to do so. Addresses #24000.
Visually warn in the Command Log when the cy.session() command fails to restore a session to surface to users potential issues with their setup and validation. Addresses #24207.
11.2.0
Released Nov 22, 2022
Features:
Re-implemented the 'Run All Specs' for End to End Testing for running multiple tests sequentially in open mode. This feature had been previously removed in Cypress 10.0. Enable 'Run All Specs' with the new experimental flag, experimentalRunAllSpecs. Leave any feedback in the 'Run All Specs' discussion. Your feedback will help us make product decisions around the future of this feature. Addresses #24168.
Added messaging after failures in CI to direct people to set up recording to the Cypress Cloud if they are not already set up to do so. Addresses #24000.
Visually warn in the Command Log when the cy.session() command fails to restore a session to surface to users potential issues with their setup and validation. Addresses #24207.
Bugfixes:
The cy.session() command no longer clears the page between setup and validation and will now always clear the page at the end of the command when test isolation is on. Fixes #21397.
11.1.0
15 Nov 2022Reading the note…
11.0.1
10 Nov 2022Reading the note…
11.0.0
8 Nov 2022Reading the note…
- 10.x
10.11.0
25 Oct 2022Reading the note…
10.10.0
11 Oct 2022Reading the note…
10.9.0
27 Sep 2022Reading the note…
10.8.0
13 Sep 2022Reading the note…
10.7.0
30 Aug 2022Reading the note…
10.6.0
16 Aug 2022Reading the note…
10.5.0
15 Aug 2022Reading the note…
10.4.0
2 Aug 2022Reading the note…
10.3.1
18 Jul 2022Reading the note…
10.3.0
28 Jun 2022Reading the note…
10.2.0
21 Jun 2022Reading the note…
10.1.0
10 Jun 2022Reading the note…
10.0.3
6 Jun 2022Reading the note…
10.0.2
2 Jun 2022Reading the note…
10.0.1
2 Jun 2022Reading the note…
10.0.0
1 Jun 2022Reading the note…
- 9.x
9.7.0
23 May 2022Reading the note…
9.6.1
9 May 2022Reading the note…
9.6.0
25 Apr 2022Reading the note…
9.5.4
11 Apr 2022Reading the note…
9.5.3
28 Mar 2022Reading the note…
9.5.2
14 Mar 2022Reading the note…
9.5.1
28 Feb 2022Reading the note…
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.