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.
- 14.x
14.2.0
12 Mar 2025Cypress.stop() is now available to stop the Cypress App on the current machine while tests are running.
Cypress.stop()can be useful for stopping test execution upon failures or other predefined conditions. Addresses #518. Addressed in #31225.The browser dropdown now has a more minimal design - showing only the icon of the browser selected to the left of the URL. The currently selected browser also now shows at the top of the browser dropdown. Browsers with longer names now have their names correctly left aligned in the browser dropdown. Addresses #21755 and #30998. Addressed in #31216.
Cypress displays additional CLI options in the terminal for some Cloud error messages. Addressed in #31211.
14.2.0
Released Mar 12, 2025
Features:
Cypress.stop() is now available to stop the Cypress App on the current machine while tests are running.
Cypress.stop()can be useful for stopping test execution upon failures or other predefined conditions. Addresses #518. Addressed in #31225.
Misc:
The browser dropdown now has a more minimal design - showing only the icon of the browser selected to the left of the URL. The currently selected browser also now shows at the top of the browser dropdown. Browsers with longer names now have their names correctly left aligned in the browser dropdown. Addresses #21755 and #30998. Addressed in #31216.
Cypress displays additional CLI options in the terminal for some Cloud error messages. Addressed in #31211.
Updated Cypress Studio with url routing to support maintaining state when reloading. Addresses #31000 and #30996.
Dependency Updates:
14.1.0
25 Feb 2025Firefox versions 135 and above are now automated with WebDriver BiDi instead of Chrome Devtools Protocol. Addresses #30220.
Viewport width, height, and scale now display in a badge above the application under test. The dropdown describing how to set viewport height and width has been removed from the UI. Additionally, component tests now show a notice about URL navigation being disabled in component tests. Addresses #30999. Addressed in #31119.
14.1.0
Released Feb 25, 2025
Features:
Firefox versions 135 and above are now automated with WebDriver BiDi instead of Chrome Devtools Protocol. Addresses #30220.
Bugfixes:
Fixed the calculation of upload throughput units when displaying the 'stream stalled' error message during Test Replay archive uploads. Fixes #31075. Addressed in #31160.
Misc:
Viewport width, height, and scale now display in a badge above the application under test. The dropdown describing how to set viewport height and width has been removed from the UI. Additionally, component tests now show a notice about URL navigation being disabled in component tests. Addresses #30999. Addressed in #31119.
Updated types around
.readFile()and.scrollTo()arguments andCypress.dommethods. Addressed in #31055.Updated types around
.shadow()and.root()options. Addressed in #31154.
Dependency Updates:
14.0.0
16 Jan 2025- Removed
Removed support for Node.js 16 and Node.js 21. Addresses #29930.
- Breaking
Cypress Component Testing no longer supports:
- Breaking
@cypress/webpack-dev-serverno longer supportswebpack-dev-serverversion 3. Additionally,@cypress/webpack-dev-servernow ships withwebpack-dev-serverversion 5 by default.webpack-dev-serverversion 4 will need to be installed alongside Cypress if you are still usingwebpackversion 4. Addresses #29308, #30347, and #30141.
14.0.0
Released Jan 16, 2025
Summary:
Cypress
14.0.0improves performance of component testing and adds support for new framework and dev server versions.14.0.0also includes breaking changes tocy.originthat are necessary to handle Chrome's deprecation of document.domain injection, which should fix issues for some users in recent Chrome versions. Support for older versions of Node.js, Linux distributions, browsers and component testing frameworks and dev servers is removed.Overall, we don't anticipate this release to be too disruptive for most users. We recommend bumping your version to see if your tests still run as expected. As always, open a bug report for any issues you find.
Breaking Changes:
info
Refer to the v14 Migration Guide for help migrating your code.
- Removed
Removed support for Node.js 16 and Node.js 21. Addresses #29930.
Upgraded bundled Node.js version from
18.17.0to20.18.1. Addresses #29547.Prebuilt binaries for Linux are no longer compatible with Linux distributions based on glibc
<2.28, for example: Ubuntu 14-18, RHEL 7, CentOS 7, Amazon Linux 2. Addresses #29601.Cypress now only officially supports the latest 3 major versions of Chrome, Firefox, and Edge - older browser versions may still work, but we recommend keeping your browsers up to date to ensure compatibility with Cypress. A warning will no longer be displayed on browser selection in the Launchpad for any 'unsupported' browser versions. Additionally, the undocumented
minSupportedVersionproperty has been removed fromCypress.browser. Addressed in #30462.The
cy.origin()command must now be used when navigating between subdomains. Because this is a fairly disruptive change for users who frequently navigate between subdomains, a new configuration option is being introduced.injectDocumentDomaincan be set totrueto re-enable the injection ofdocument.domainsetters in Cypress. This configuration option is marked as deprecated and you'll receive a warning when Cypress is launched with this option set totrue. It will be removed in a future version of Cypress. Addressed in #30770.The
experimentalSkipDomainInjectionconfiguration has been removed and replaced with aninjectDocumentDomainconfiguration. Addressed in #30770.It is no longer possible to make a
fetchorXMLHttpRequestrequest from theabout:blankpage in Electron (i.e.cy.window().then((win) => win.fetch('<some-url>'))). You must usecy.requestinstead or perform some form of initial navigation viacy.visit(). Addressed in #30394.The
experimentalJustInTimeCompileconfiguration option for component testing has been replaced with ajustInTimeCompileoption that istrueby default. This option will only compile resources directly related to your spec, compiling them 'just-in-time' before spec execution. This should result in improved memory management and performance for component tests incypress openandcypress runmodes, in particular for large component testing suites.justInTimeCompileis now only supported for webpack. Addresses #30234. Addressed in #30641.- Breaking
Cypress Component Testing no longer supports:
create-react-app. Addresses #30028.@vue/cli-service. Addresses #30481.Angularversions 13, 14, 15, and 16. The minimum supported version is now17.2.0to fully support Angular signals. Addresses #29582. Addressed in #30539.Next.jsversions 10, 11, 12, and 13. Addresses #29583.Nuxt.jsversion 2. Addresses #30468.Reactversions 16 and 17. Addresses #29607.Vueversion 2. Addresses #30295.
The
cypress/react18test harness is no longer included in the Cypress binary. Instead, React 18 support is now shipped withcypress/react! Addresses #29607.The
cypress/angular-signalstest harness is no longer included in the Cypress binary. Instead, signals support is now shipped withcypress/angular! This requiresrxjsto be installed as apeerDependency. Addresses #29606.The Cypress configuration wizard for Component Testing supports TypeScript 4.0 or greater. Addresses #30493.
- Breaking
@cypress/webpack-dev-serverno longer supportswebpack-dev-serverversion 3. Additionally,@cypress/webpack-dev-servernow ships withwebpack-dev-serverversion 5 by default.webpack-dev-serverversion 4 will need to be installed alongside Cypress if you are still usingwebpackversion 4. Addresses #29308, #30347, and #30141. - Breaking
@cypress/vite-dev-serverno longer supportsviteversions 2 and 3. Addresses #29377 and #29378. The
delayMsoption ofcy.intercept()has been removed. This option was deprecated in Cypress 6.4.0. Use thedelayoption instead. Addressed in #30463.The
experimentalFetchPolyfillconfiguration option was removed. This option was deprecated in Cypress 6.0.0. We recommend usingcy.intercept()for handling fetch requests. Addressed in #30466.- Deprecated
We removed yielding the second argument of
before:browser:launchas an array of browser arguments. This behavior has been deprecated since Cypress 4.0.0. Addressed in #30460. The
cypress open-ctandcypress run-ctCLI commands were removed. Usecypress open --componentorcypress run --componentrespectively instead. Addressed in #30456.The undocumented methods
Cypress.backend('firefox:force:gc')andCypress.backend('log:memory:pressure')were removed. Addresses #30222.
Deprecations:
- Deprecated
The
resourceTypeoption oncy.intercepthas been deprecated. We anticipate the resource types to change or be completely removed in the future. Our intention is to replace essential functionality dependent on theresourceTypewithin Cypress in a future version (like hiding network logs that are not fetch/xhr). Leave feedback on any essential uses ofresourceTypein this GitHub issue. Addresses #30433. The new
injectDocumentDomainconfiguration option is released as deprecated. It will be removed in a future version of Cypress. Addressed in #30770.
Features:
injectDocumentDomain, a new configuration option, can be set totrueto re-enable the injection ofdocument.domainsetters in Cypress. Addressed in #30770.Cypress Component Testing now supports:
Reactversion 19. Addresses #29470.Angularversion 19. Addresses #30175.Next.jsversion>=15.0.4. Versions15.0.0 - 15.0.3depend on the React 19 Release Candidate and are not officially supported by Cypress, but should still work. Addresses #30445.Svelteversion 5. Addresses #29641.Viteversion 6. Addresses #30591.
Bugfixes:
Elements with
display: contentswill no longer use box model calculations for visibility, and correctly show as visible when they are visible. Fixed in #29680. Fixes #29605.Fixed a visibility issue when the element is positioned
staticorrelativeand the element's offset parent is positionedabsolute, a descendent of the ancestor, and has no clippable overflow. Fixed in #29689. Fixes #28638.Fixed a visibility issue for elements with
textContentbut without a width or height. Fixed in #29688. Fixes #29687.Elements whose parent elements has
overflow: clipand no height/width will now correctly show as hidden. Fixed in #29778. Fixes #23852.The CSS pseudo-class
:dir()is now supported when testing in Electron. Addresses #29766.Fixed an issue where the spec filename was not updating correctly when changing specs in
openmode. Fixes #30852.cy.origin()now correctly errors when the cy.window(), cy.document(), cy.title(), cy.url(), cy.location(), cy.hash(), cy.go(), cy.reload(), and cy.scrollTo() commands are used outside of thecy.origin()command after the AUT has navigated away from the primary origin. Fixes #30848. Fixed in #30858.
Misc:
- Removed
Removed some component testing API stubs that were removed in Cypress v11.0.0. Addressed in #30696. Addresses #30623.
Dependency Updates:
Upgraded
electronfrom27.3.10to33.2.1. Addresses #29547 and #30561.Upgraded
@electron/rebuildfrom3.2.10to3.7.1. Addresses #28766 and #30632.Upgraded bundled Chromium version from
118.0.5993.159to130.0.6723.137. Addresses #29547 and #30561.Updated
jQueryfrom3.4.1to3.7.1. Addressed in #30345.Updated
reactfrom17.0.2to18.3.1andreact-domfrom17.0.2to18.3.1. Addresses #30511.Upgraded @vue/test-utils from
2.3.2to2.4.6. Addresses #26628.
- 13.x
13.17.0
17 Dec 2024Added official support for the Google Chrome for Testing browser. Assuming the browser is in a location where it can be auto-detected, it can be launched by providing the
--browser chrome-for-testingoption. If it can't be auto-detected, the path to the browser can also be provided. Previously customizing the available browsers was required. Addresses #28123 and #28554.Fixed an issue where targets may hang if
Network.enableis not implemented for the target. Addresses #29876.Updated Firefox
userChrome.cssto correctly hide the toolbox during headless mode. Addresses #30721.
13.17.0
Released Dec 17, 2024
Features:
Added official support for the Google Chrome for Testing browser. Assuming the browser is in a location where it can be auto-detected, it can be launched by providing the
--browser chrome-for-testingoption. If it can't be auto-detected, the path to the browser can also be provided. Previously customizing the available browsers was required. Addresses #28123 and #28554.
Bugfixes:
Fixed an issue where targets may hang if
Network.enableis not implemented for the target. Addresses #29876.Updated Firefox
userChrome.cssto correctly hide the toolbox during headless mode. Addresses #30721.Fixed an issue loading the
cypress.config.tsfile with Node.js version22.12.0if it is loaded as an ESM. Addresses #30715.
Misc:
Removed a comment from the scaffolded
supportFilefor component tests around CommonJS syntax. Addresses #23287.
Dependency Updates:
Updated
chaifrom4.2.0to4.5.0. Addressed in #30737.
13.16.1
4 Dec 202413.16.0
19 Nov 2024Added new defaultBrowser configuration option to specify the default browser to launch. This option only affects the first browser launch; changing this option after the browser is already launched has no effect. Addresses #6646.
Fixed an issue where some JS assets were not properly getting sourcemaps included with the vite dev server if they had a cache busting query parameter in the URL. Fixed some scenarios to ensure that the sourcemaps that were included by the vite dev server were inlined. Addressed in #30606.
Updated the protocol to be able to flex logic based on project config. Addresses #30560.
13.16.0
Released Nov 19, 2024
Features:
Added new defaultBrowser configuration option to specify the default browser to launch. This option only affects the first browser launch; changing this option after the browser is already launched has no effect. Addresses #6646.
Bugfixes:
Fixed an issue where some JS assets were not properly getting sourcemaps included with the vite dev server if they had a cache busting query parameter in the URL. Fixed some scenarios to ensure that the sourcemaps that were included by the vite dev server were inlined. Addressed in #30606.
Misc:
Updated the protocol to be able to flex logic based on project config. Addresses #30560.
13.15.0
25 Sep 2024- Security
Updated
expressfrom4.19.2to4.21.0. This update removes the CVE-2024-43796, CVE-2024-45590, and CVE-2024-43800 vulnerabilities being reported in security scans. Addresses #30241. - Security
Updated
loader-utilsfrom1.4.0to1.4.2. This update removes the CVE-2022-37601 vulnerability being reported in security scans. Addresses #28208. - Security
Updated
sendfrom0.17.1to0.19.0. This update removes the CVE-2024-43799 vulnerability being reported in security scans. Addressed in #30241.
13.15.0
Released Sep 25, 2024
Features:
Cypress now displays more actionable errors when a Test Replay upload takes too long, and more verbose messages when uncategorized errors occur during the upload process. Addressed in #30235.
Bugfixes:
Fixed an issue where Firefox was incorrectly mutating the state of click events on checkboxes after Firefox version
129and up. Addressed in #30245.Fixed a regression introduced in 13.13.0 where 'Open in IDE' would not work for filepaths containing spaces and various other characters on Windows. Addresses #29820.
Misc:
Pass along the related log to the
createSnapshotfunction for protocol usage. Addressed in #30244.
Dependency Updates:
Update
@cypress/requestfrom3.0.1to3.0.4. Addressed in #30194.- Security
Updated
expressfrom4.19.2to4.21.0. This update removes the CVE-2024-43796, CVE-2024-45590, and CVE-2024-43800 vulnerabilities being reported in security scans. Addresses #30241. Update
launch-editorfrom2.8.0to2.9.1. Addressed in #30247.- Security
Updated
loader-utilsfrom1.4.0to1.4.2. This update removes the CVE-2022-37601 vulnerability being reported in security scans. Addresses #28208. - Security
Updated
sendfrom0.17.1to0.19.0. This update removes the CVE-2024-43799 vulnerability being reported in security scans. Addressed in #30241.
13.11.0
4 Jun 2024Improved performance when setting console props within
Cypress.log. Addressed in #29501.Added support for Next.js 14 for component testing. Addresses #28185.
Added an
IGNORE_CHROME_PREFERENCESenvironment variable to ignore Chrome preferences when launching Chrome. Addresses #29330.
13.11.0
Released Jun 04, 2024
Performance:
Improved performance when setting console props within
Cypress.log. Addressed in #29501.
Features:
Added support for Next.js 14 for component testing. Addresses #28185.
Added an
IGNORE_CHROME_PREFERENCESenvironment variable to ignore Chrome preferences when launching Chrome. Addresses #29330.
Bugfixes:
Fixed a situation where the Launchpad would hang if the project config had not been loaded when the Launchpad first queries the current project. Fixes #29486.
Pre-emptively fix behavior with Chrome for when
unloadevents are forcefully deprecated by usingpagehideas a proxy. Fixes #29241.
Misc:
Enhanced the type definitions available to cy.intercept() and cy.wait(). The
bodyproperty of both the request and response in an interception can optionally be specified with user-defined types. Addresses #29507.
13.10.0
21 May 2024Added support for
vitev5 to@cypress/vite-dev-server. Addresses #28347.Fixed an issue where Cypress would use the wrong URL to upload Test Replay recordings when it wasn't able to determine the upload URL. Cypress now displays an error when the upload URL cannot be determined, rather than a "Request Entity Too Large" error. Addressed in #29512.
13.10.0
Released May 21, 2024
Features:
Added support for
vitev5 to@cypress/vite-dev-server. Addresses #28347.
Bugfixes:
Fixed an issue where orphaned Electron processes were inadvertently terminating the browser's CRI client. Fixes #28397. Fixed in #29515.
Fixed an issue where Cypress would use the wrong URL to upload Test Replay recordings when it wasn't able to determine the upload URL. Cypress now displays an error when the upload URL cannot be determined, rather than a "Request Entity Too Large" error. Addressed in #29512.
Fixed an issue where Cypress was unable to search in the Specs list for files or folders containing numbers. Fixes #29034.
Fixed an issue setting the
x-cypress-file-pathheader when there are invalid header characters in the file path. Fixes #25839.Fixed the display of some command assertions. Fixed in #29517.
Dependency Updates:
13.2.0 – 13.9.022 releases without a noteShow each
- 13.9.07 May 2024no note
- 13.8.123 Apr 2024no note
- 13.8.018 Apr 2024no note
- 13.7.311 Apr 2024no note
- 13.7.22 Apr 2024no note
- 13.7.121 Mar 2024no note
- 13.7.013 Mar 2024no note
- 13.6.622 Feb 2024no note
- 13.6.520 Feb 2024no note
- 13.6.430 Jan 2024no note
- 13.6.316 Jan 2024no note
- 13.6.226 Dec 2023no note
- 13.6.15 Dec 2023no note
- 13.6.021 Nov 2023no note
- 13.5.114 Nov 2023no note
- 13.5.08 Nov 2023no note
- 13.4.030 Oct 2023no note
- 13.3.324 Oct 2023no note
- 13.3.218 Oct 2023no note
- 13.3.111 Oct 2023no note
- 13.3.027 Sep 2023no note
- 13.2.012 Sep 2023no note
13.1.0
31 Aug 2023- Security
Updated
plistfrom3.0.6to3.1.0to address CVE-2022-37616 and CVE-2022-39353. Fixed in #27710. Introduces a status icon representing the
latesttest run in the Sidebar for the Runs Page. Addresses #27206.Fixed a regression introduced in Cypress 13.0.0 where the Module API, after:run, and after:spec results did not include the
stats.skippedfield for each run result. Fixes #27694. Addressed in #27695.
13.1.0
Released Aug 31, 2023
Features:
Introduces a status icon representing the
latesttest run in the Sidebar for the Runs Page. Addresses #27206.
Bugfixes:
Fixed a regression introduced in Cypress 13.0.0 where the Module API, after:run, and after:spec results did not include the
stats.skippedfield for each run result. Fixes #27694. Addressed in #27695.Individual CDP errors that occur while capturing data for Test Replay will no longer prevent the entire run from being available. Addressed in #27709.
Fixed an issue where the release date on the
v13landing page was a day behind. Fixed in #27711.Fixed an issue where fatal protocol errors would leak between specs causing all subsequent specs to fail to upload protocol information. Fixed in #27720.
- Security
Updated
plistfrom3.0.6to3.1.0to address CVE-2022-37616 and CVE-2022-39353. Fixed in #27710.
13.0.0
29 Aug 2023- Deprecated
Node 14 support has been removed and Node 16 support has been deprecated. Node 16 may continue to work with Cypress
v13, but will not be supported moving forward to closer coincide with Node 16's end-of-life schedule. It is recommended that users update to at least Node 18. - Breaking
The minimum supported TypeScript version is
4.x. - Security
Upgraded @cypress/request from
^2.88.11to^3.0.0to address the CVE-2023-28155 security vulnerability. Addresses #27535. Addressed in #27495.
13.0.0
Released Aug 29, 2023
Summary:
When recording to Cypress Cloud, users now receive our newest feature: Test Replay. Test Replay brings the debugging experience you know and love from the Cypress app directly into your recorded tests in Cypress Cloud.
Previously, trying to debug failures and flake in CI was painful and time consuming with only videos & screenshots. Test Replay provides a way to inspect the DOM, network events, and console logs of your application from your tests exactly as they ran in CI.
Test Replay is available in all Cypress Cloud plans. To start using Test Replay, simply record a run to Cypress Cloud. Learn more in the Test Replay documentation.
Test Replay now serves as the primary replacement for debugging via video. Video capture and
videoCompressionof captured video are now set tofalseby default andvideoUploadOnPassesis removed.Read more about v13.0.0 in our blog post.
Breaking Changes:
info
Refer to the v13 Migration Guide for help migrating your code.
The video configuration option now defaults to
false. Addresses #26157.The videoCompression configuration option now defaults to
false. Addresses #26160.The videoUploadOnPasses configuration option has been removed. See our screenshots & videos guide on how to accomplish similar functionality. Addresses #26899.
Requests for assets at relative paths for component testing are now correctly forwarded to the dev server. Fixes #26725.
The cy.readFile() command is now retry-able as a query command. This should not affect any tests using it; the functionality is unchanged. However, it can no longer be overwritten using Cypress.Commands.overwrite(). Addressed in #25595.
The deprecated configuration option
nodeVersionhas been removed. Addresses #27016.The properties and values returned by the Module API and included in the arguments of handlers for the after:run and after:spec have been changed to be more consistent. Addresses #23805.
For Cypress Cloud runs with Test Replay enabled, the Cypress Runner UI is now hidden during the run. This change was made to improve performance in situations where the Runner no longer needs to be rendered. If video is recorded during the run, the Runner will not be visible. In addition, if a screenshot with
capture: runneris taken, the screenshot will be taken as if thecapture: viewportoption was passed. You can turn off this behavior by passing --runner-ui. Addressed in #27482.The browser and browser page unexpectedly closing in the middle of a test run are now gracefully handled. Addressed in #27592.
Automation performance is now improved by switching away from websockets to direct CDP calls for Chrome and Electron browsers. Addressed in #27592.
Edge cases where
cy.interceptwould not properly intercept have been addressed. Addressed in #27592.- Deprecated
Node 14 support has been removed and Node 16 support has been deprecated. Node 16 may continue to work with Cypress
v13, but will not be supported moving forward to closer coincide with Node 16's end-of-life schedule. It is recommended that users update to at least Node 18. - Breaking
The minimum supported TypeScript version is
4.x.
Features:
Added --runner-ui and --no-runner-ui CLI flags to control whether the Cypress Runner UI is visible during a run. Addressed in #27582.
Consolidates and improves terminal output when uploading test artifacts to Cypress Cloud. Addressed in #27402.
Bugfixes:
Fixed an issue where Cypress's internal
tsconfigwould conflict with properties set in the user'stsconfig.jsonsuch asmoduleandmoduleResolution. Fixes #26308 and #27448.Clarified Svelte 4 works correctly with Component Testing and updated dependencies checks to reflect this. It was incorrectly flagged as not supported. Fixes #27465.
Resolve the
process/browserglobal inside@cypress/webpack-batteries-included-preprocessorto resolve toprocess/browser.jsto explicitly provide the file extension. File resolution must include the extension for.mjsand.jsfiles inside ESM packages to resolve correctly. Fixes #27599.Fixed an issue where the correct
pnpprocess was not being discovered. Fixes #27562.Fixed incorrect type declarations for Cypress and Chai globals that asserted them to be local variables of the global scope rather than properties on the global object. Fixes #27539. Fixed in #27540.
Dev Servers will now respect and use the
portconfiguration option if present. Fixes #27675.
Dependency Updates:
- Security
Upgraded @cypress/request from
^2.88.11to^3.0.0to address the CVE-2023-28155 security vulnerability. Addresses #27535. Addressed in #27495.
- 12.x
12.17.4
15 Aug 202312.17.3
1 Aug 2023Reading the note…
12.17.2
20 Jul 2023Reading the note…
12.17.1
10 Jul 2023Reading 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.