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.
- 16.x · latest line
16.3.0
10 Nov 2026- Security
Upgraded
electronfrom41.7.0to43.8.4to address the compromised eMudhra intermediate certificates vulnerability reported in security scans. Connections that Cypress makes itself, such as to Cypress Cloud, now reject certificates issued through these intermediates. Node code in the config process, such as setupNodeEvents, runs on the Node.js version that runs thecypressCLI, so it needs a Node.js release that includes the same fix. Addresses #35124. - Security
Upgraded
systeminformationto5.33.18to address the SNYK-JS-SYSTEMINFORMATION-21771271 (CVE-2026-116576) vulnerability reported in security scans. Addresses #35196. - Security
Upgraded
node-forgefrom1.4.0to1.4.3to address the Improper Certificate Validation vulnerability reported in security scans. Addressed in #35279.
16.3.0
Released Nov 10, 2026
Performance:
In
cypress run, specs now start sooner when Cypress launches a new browser for them. In Electron, this is every spec unless component testing'sexperimentalSingleTabRunModeis enabled. In other browsers, it is the first spec and any spec after the browser exits unexpectedly. Fixed in #35186.The Cypress binary no longer includes a copy of TypeScript that it never used, since Cypress loads TypeScript from your project. This makes the download smaller and takes less disk space once installed. On Linux arm64, Cypress also starts faster, because it no longer tries to load TypeScript as it launches. Fixed in #35184.
cypress runnow spends less time finding the browsers installed on your machine before it starts the first spec, so runs start sooner. Fixed in #35181.Installing the Cypress binary from an interactive terminal, such as with
npx cypress install, now finishes unzipping sooner and uses less CPU, especially on Windows. Installs in CI, and package manager installs that run without a terminal, are unchanged. Fixed in #35243.
Features:
Registering the same event more than once in setupNodeEvents now runs every handler in registration order, instead of only the last one, for before:run, after:run, before:spec, after:spec, before:browser:launch, and after:screenshot.
before:browser:launchandafter:screenshothandlers each receive the result of the handler before them. If a handler throws, later handlers do not run. If you re-registered one of these events to replace a plugin's handler, both now run; to keep only yours, pass the plugin anonthat skips that event. Addresses #5240, #19809 and #27524.
Bugfixes:
Fixed a regression in 16.0.0 where changes a cy.intercept() response handler made to
Set-Cookieheaders did not reach the browser in Chromium-based browsers. The browser stored the cookies exactly as the server sent them, so a handler that rewrote a cookie's attributes, such as addingSameSite=Noneso a cross-site login cookie is accepted, or that removed a cookie, had no effect. Cookies in the browser now match theSet-Cookieheaders the handler leaves on the response. Fixes #34902.Fixed an issue where Cypress could use a port that browsers refuse to load, such as 10080, when the port option was not set. The runner then failed with
ERR_UNSAFE_PORT. Cypress now redraws a blocked randomly assigned port, and a blocked port in configuration is reported as a configuration error that names the port before the runner server starts. Fixes #30869.Fixed an issue where a spec whose bundled file includes a large inline source map could crash the browser tab, leaving
cypress runhanging with no error until it was killed. The crash could happen while the spec first loaded, or when it loaded again after its first cy.visit() to another origin. Specs with inline source maps now also load faster and use less memory. Fixes #35201.Fixed an issue where
cypress runcould hang until it was killed, or exit with an unrelatedsocket hang uperror, when the process that loads your config file and runs your Node events exited, for example because the operating system ran out of memory orsetupNodeEventscalledprocess.exit(). In component testing this process also runs the dev server. Cypress now stops the run with an error that says the process exited, with its exit code or signal. Fixes #25507 and #35223.Fixed an issue where, in Chrome 158 and later,
cypress runstopped with the error* is not a valid URLwhen it opened a second spec. Fixes #35195.Fixed an issue where, in Chrome 158 and later with injectDocumentDomain enabled, navigating the application under test within cy.origin() could fail with errors such as
Blocked a frame with originordoes not have permission to navigate the target frame. Chrome 158 stopped firingunloadevents, which Cypress uses to track navigations. Fixed in #35198.Fixed an issue where cy.intercept() silently ignored a header matcher when the same header name appeared more than once with different casing, such as
Content-Typeandcontent-type. Only the last matcher was applied.cy.intercept()now throws an error that names the duplicated header. Fixes #34975.The error shown when Cypress cannot start on Linux because of a missing system library now lists each library and the package that provides it, and a missing or failing Xvfb now shows install commands or the likely causes. Addressed in #35116.
Fixed an issue where
cypress tapcommands could delete the record of a runningcypress opensession, and report that no session was running, when run from a process that cannot see the session's process ID, such as a different PID namespace in a container or sandbox. The record is now kept while the session responds. Fixed in #35103.cypress opennow prints configuration errors and warnings, including the stack trace of a config file that fails to load, to the terminal. Previously they only appeared in the Cypress window, so a script or AI agent runningcypress opensaw nothing while it waited. Fixed in #35104.cypress open --project <path> --e2e --browser <browser>run by an AI coding agent now launches the browser without waiting for the welcome screen to be dismissed in the Cypress window. SetCYPRESS_AGENT_MODE=1to force this behavior for an agent Cypress does not detect, orCYPRESS_AGENT_MODE=0to turn it off. Fixed in #35105.cypress open --e2e --project <path>run by an AI coding agent in a project with no Cypress configuration file now creates the configuration and support files and starts the project in one launch, and prints the files it created. Previously the project did not start until Continue was pressed in the Cypress window. Fixed in #35106.cypress tap statusnow reports anerrorstage, with the reason, whencypress opencould not load the project, for example because the configuration file has a syntax error, and the othercypress tapcommands say that the project could not load instead of that no session is running. Previouslycypress tap statusreportednot connected. Fixed in #35107.When the path given to
--browseris not recognized as a browser, the warning now includes what running the path with--versionprinted, so a missing library or an unsupported binary can be told apart. Fixed in #35108.Fixed an issue where
cypress opendid not open the app window when theELECTRON_RUN_AS_NODEenvironment variable was set, as in some AI agent environments.cypress opennow ignores the variable and prints a warning, whilecypress runstill honors it. Fixed in #35111.Fixed an issue where the Cypress app started with
cypress open --detachedcould stop working or exit shortly after the command returned, particularly on Linux where Cypress starts its own virtual display. The app's output is now written to files in the system temp directory, and the command prints where those files are. Because the virtual display now keeps running with the app,cypress open --detachedno longer uses the display set byXVFB_DISPLAY_NUM, and prints a warning when it is set. Fixed in #35112.Fixed an issue where installing the Cypress binary could hang or fail outright when the connection was reset or the download server returned a temporary error. The download is now retried up to 3 times with an increasing delay before the install fails. Fixed in #35115.
Fixed an issue where
cypress openandcypress runon Linux failed to start with a "Missing X server or $DISPLAY" error whenDISPLAYpointed to an X server that was not running. Cypress now starts its own Xvfb and retries. Fixed in #35114.Improved the
--helpoutput ofcypress tapand its subcommands to identify arguments and flags that are required or have dependencies on others. Fixed in #35227.When the Cypress binary cannot be saved while it downloads, such as when the disk is full, cypress install and
npm install cypressnow fail with the underlying error, such asENOSPC: no space left on device, and delete the partially downloaded file, instead of crashing with a Node.js stack trace and leaving the file behind in the temporary folder. Fixed in #35219.Fixed an issue where, in
cypress openandcypress run, the browser launched by Cypress kept loading forever with no error when the Cypress installation was missing some of its files. Cypress now shows an error that names the missing file after a few seconds. Fixed in #35232.Fixed an issue where, in
cypress runwith Firefox, a spec where the browser never connected caused the next spec to crash the whole run. The next spec now launches a new browser. Failed attempts to connect to Firefox also no longer leave Firefox processes running. Fixed in #35246.Fixed an issue where the browser tab running Cypress could stop responding when a test's command log held an object with a circular reference reachable by more than one path, such as an object passed to cy.wrap() or stubbed with cy.stub(). Fixes #35231.
Fixed an issue where cy.scrollTo() and .scrollIntoView() ignored a
durationgiven as a string, such as'2000', and always animated the scroll for 400ms. A stringdurationis now read as milliseconds, the same as a number. Fixed in #35248.Fixed an issue where .select() did not fire
inputandchangeevents on a<select multiple>when the selection changed but its first selected option stayed the same, such as selecting['apple', 'banana']whenapplewas already selected. Fixed in #35254.Fixed an issue where
cypress runin Firefox on Windows could print part of anEPERMerror, such ascode: 'EPERM'andsyscall: 'rm', after the run finished. The error came from deleting the Firefox profile while Firefox still had files in it open. Cypress now retries the deletion, and if the profile still cannot be deleted, it no longer prints an error and a latercypress runcan remove the profile. Fixes #35293.Fixed an issue where an assertion's failure message showed the wrong value when the value being asserted on, the expected value, or the actual value contained
#{this},#{act}or#{exp}. For example,expect('#{exp}').to.equal('x')failed withexpected ''x'' to equal 'x', and now fails withexpected '#{exp}' to equal 'x', both in the error and in the Command Log. Fixed in #35301.Fixed an issue where an assertion failed with an unrelated
TypeErrorinstead of its own message when the value had adocumentgetter that threw something other than anError. Fixed in #35301.Fixed an issue where cy.fixture() did not cache a fixture whose content is empty or falsy, such as an empty
.txt,.csv, or.htmlfile, or a.jsonfile that contains only0,false,"", ornull. Every call read the file from disk again, so each call could time out, and a later call could yield different content if the file had changed since the first call. These fixtures are now cached like any other fixture. A.jsfixture that evaluates toundefinednow yieldsundefinedinstead of failing with"undefined" is not valid JSON. Fixed in #35327.
Misc:
The TypeScript types for .scrollIntoView() no longer accept the
ensureScrollableoption, which only cy.scrollTo() uses..scrollIntoView()always ignored it, so TypeScript code that passesensureScrollableto.scrollIntoView()now fails to compile. Remove the option to fix the error; scrolling behaves the same without it. Addressed in #35331.The error shown when cy.session() is passed an unknown option now lists every valid option,
cacheAcrossSpecsandvalidate. Previously it listed onlyvalidate, suggesting thatcacheAcrossSpecswas not a valid option. Addressed in #35233.The editor chooser now lists only the editors Cypress detects, and the Custom option has been removed. To use an editor that isn't listed, set the
LAUNCH_EDITORenvironment variable before starting Cypress. Addressed in #35208.
Dependency Updates:
- Security
Upgraded
electronfrom41.7.0to43.8.4to address the compromised eMudhra intermediate certificates vulnerability reported in security scans. Connections that Cypress makes itself, such as to Cypress Cloud, now reject certificates issued through these intermediates. Node code in the config process, such as setupNodeEvents, runs on the Node.js version that runs thecypressCLI, so it needs a Node.js release that includes the same fix. Addresses #35124. Upgraded bundled Node.js version from
24.15.0to24.22.1. Addresses #35124.Upgraded bundled Chromium version from
146.0.7680.216to150.0.7871.250. Addresses #35124.- Security
Upgraded
systeminformationto5.33.18to address the SNYK-JS-SYSTEMINFORMATION-21771271 (CVE-2026-116576) vulnerability reported in security scans. Addresses #35196. - Security
Upgraded
node-forgefrom1.4.0to1.4.3to address the Improper Certificate Validation vulnerability reported in security scans. Addressed in #35279. - Security
Upgraded
jimpfrom0.22.12to1.6.1to address an infinite loop vulnerability (CVE-2026-31808) in itsfile-typedependency reported in security scans. This also removesxml2js0.4.23, which has a prototype pollution vulnerability (CVE-2023-0842). Addresses #35271.
16.2.1
28 Oct 202616.2.0
14 Oct 2026- Security
Upgraded
shell-quotefrom1.10.0to1.11.0to address a Command Injection vulnerability reported in security scans.shell-quoteis a transitive dependency oflaunch-editor. Addressed in #34960. - Security
Upgraded
simple-gitfrom3.36.0to4.0.2to address a Command Injection vulnerability and two Arbitrary Command Injection vulnerabilities (SNYK-JS-SIMPLEGIT-20335524, SNYK-JS-SIMPLEGIT-20335540) reported in security scans. This also upgrades its@simple-git/argv-parserdependency from1.1.1to2.0.1, which addresses a Command Injection vulnerability reported in security scans. Addressed in #34960. Added the cy.getByRole() query, which finds elements by their ARIA role and, optionally, their accessible name, for example
cy.getByRole('tab', { name: 'Billing' }). Elements hidden from the accessibility tree are skipped unless you pass{ hidden: true }. For a role that HTML has an element for, only that element matches by default, socy.getByRole('button')finds a<button>but not a<div role="button">. Pass{ native: false }to also match elements with aroleattribute. Like cy.get(), it yields every match and retries until its assertions pass. When nothing matches, the error lists the roles and accessible names on the page. Addressed in #34937.
16.2.0
Released Oct 13, 2026
Features:
Added the cy.getByRole() query, which finds elements by their ARIA role and, optionally, their accessible name, for example
cy.getByRole('tab', { name: 'Billing' }). Elements hidden from the accessibility tree are skipped unless you pass{ hidden: true }. For a role that HTML has an element for, only that element matches by default, socy.getByRole('button')finds a<button>but not a<div role="button">. Pass{ native: false }to also match elements with aroleattribute. Like cy.get(), it yields every match and retries until its assertions pass. When nothing matches, the error lists the roles and accessible names on the page. Addressed in #34937.
Bugfixes:
Fixed a regression in 16.0.0 where a configured clientCertificates entry was not presented for requests the browser issued in Chrome, Chromium, and Edge, so an origin requiring mutual TLS showed a certificate prompt in
cypress openand hung incypress run. Fixes #34807.Fixed a regression in 15.20.0 where a cookie changed by cy.request() or cy.setCookie() was sent to the server with its earlier value on the next navigation of the application under test, even though cy.getCookie() reported the new one. Fixes #34891.
Fixed a regression in 15.0.0 where cy.go() finished before the page it navigated to had loaded. The next command could run against the page being navigated away from, so tests that went back or forward could fail intermittently.
cy.go()also yieldedundefinedinstead of the window, and ignored itstimeoutoption and pageLoadTimeout.cy.go()now waits for the page to load, yields the window, and fails if the page does not load within the timeout. Fixes #32460.Fixed a regression in 15.0.0 where output written to stderr from your config file, such as
console.error()insetupNodeEvents, could intermittently be missing from the terminal output ofcypress runwhen written right after another line. Fixed in #35022.cy.get() now fails right away when you ask for index
0of a cy.intercept() alias, such ascy.get('@getUsers.0'). Previously, Cypress retried until the command timed out before it showed the error, even though retrying could never succeed. Fixed in #34936.Fixed an issue where chapter markers in videos recorded during
cypress runin Chrome-based browsers, Electron, and Firefox were placed later than the tests they label when the browser was slow to show its first frame. In that case the video could also report a longer length than its footage and show a frozen final frame. Fixed in #35018.Fixed an issue where an error whose
messagecannot be overwritten — such as theDOMExceptiona browser throws for a cross-origin access or a Content Security Policy violation — was reported asTypeError: setting getter-only property "message"from inside Cypress, hiding the error that actually failed the test. Fixes #34818.Fixed an issue where, after one request missed its browser pre-request, every later request with the same method and URL waited the full 2 second pre-request timeout for the rest of the spec. Fixes #34966.
Fixed an issue where cy.prompt and Studio could fail to load. Fixed in #35013.
Calling a query that needs a subject, such as .eq(), .first(), .find(), or .shadow(), directly off
cyinstead of chaining it off a command that yields a subject now fails right away with an error that names the command and explains that it must be chained. Previously, Cypress retried until the command timed out and then reported that the subject was not a DOM element, or, when the query was the first command in a test, failed withCannot read properties of undefined (reading 'get'). Child commands called directly offcy, such ascy.click(), show the same reworded error. Fixed in #35024.Fixed an issue where
cypress runchanged the browser thatcypress openselects by default for a project to whichever browser the run used, such as the one passed with--browser. Fixed in #34924.
Misc:
TypeScript now types the object yielded by cy.location() as the plain object Cypress actually yields, instead of the browser's
window.location.searchParamsis now typed, socy.location('searchParams')andloc.searchParams.get('q')no longer report a type error. Addressed in #34956.Masked the environment variable values on the Project settings page. Addressed in #35004.
Dependency Updates:
- Security
Upgraded
shell-quotefrom1.10.0to1.11.0to address a Command Injection vulnerability reported in security scans.shell-quoteis a transitive dependency oflaunch-editor. Addressed in #34960. - Security
Upgraded
simple-gitfrom3.36.0to4.0.2to address a Command Injection vulnerability and two Arbitrary Command Injection vulnerabilities (SNYK-JS-SIMPLEGIT-20335524, SNYK-JS-SIMPLEGIT-20335540) reported in security scans. This also upgrades its@simple-git/argv-parserdependency from1.1.1to2.0.1, which addresses a Command Injection vulnerability reported in security scans. Addressed in #34960.
16.1.1
29 Sep 202616.1.0
15 Sep 2026Fixed a memory leak in the Cypress server where every service worker started by the application under test held onto state until the browser closed, so memory use climbed over the course of a run in Chrome, Chromium, Edge, and Electron. Addressed in #34721.
Added the trustedCertificates configuration option. On the native browser network path (Chrome, Chromium, and Edge), declare a certificate your application under test presents — a self-signed development certificate, an internal certificate authority, or a precomputed SPKI fingerprint — and Chrome treats connections to that origin as trusted rather than merely tolerating its certificate errors. Static assets from the origin are then cached across navigations as they are in production; previously nothing from an untrusted-certificate origin was ever written to the browser's disk cache, so asset-heavy specs re-downloaded every asset on each cy.visit(). Origins you do not declare continue to load exactly as before. Firefox, WebKit, Electron, and forceHttp1 runs are unaffected. Addresses #34760.
cypress tap runnow reports that the spec is running and to usecypress tap statusfor progress, instead of printing the launched spec's testing type and browser. #34777.
16.1.0
Released Sep 15, 2026
Performance:
Fixed a memory leak in the Cypress server where every service worker started by the application under test held onto state until the browser closed, so memory use climbed over the course of a run in Chrome, Chromium, Edge, and Electron. Addressed in #34721.
Features:
Added the trustedCertificates configuration option. On the native browser network path (Chrome, Chromium, and Edge), declare a certificate your application under test presents — a self-signed development certificate, an internal certificate authority, or a precomputed SPKI fingerprint — and Chrome treats connections to that origin as trusted rather than merely tolerating its certificate errors. Static assets from the origin are then cached across navigations as they are in production; previously nothing from an untrusted-certificate origin was ever written to the browser's disk cache, so asset-heavy specs re-downloaded every asset on each cy.visit(). Origins you do not declare continue to load exactly as before. Firefox, WebKit, Electron, and forceHttp1 runs are unaffected. Addresses #34760.
Bugfixes:
cypress tap runnow reports that the spec is running and to usecypress tap statusfor progress, instead of printing the launched spec's testing type and browser. #34777.Fixed an issue where adding a
--disable-featuresargument in before:browser:launch silently dropped every feature Cypress disables in Chrome, Chromium, and Edge, because the browser honors only the last occurrence of that argument. Cypress now merges its own values with yours. Fixes #34775.Fixed a regression in 16.0.0 where, in
cypress openon Chrome, Chromium, and Edge, testing a site that registers an origin-wide service worker could render the site's own content — such as its 404 page — in place of the Cypress app after clicking a spec or reloading the browser tab. A service worker registered by the site under test can no longer answer for Cypress's own pages and assets. Fixes #34789. Addressed in #34762.Fixed an issue where a variant of A/B tested content in the Cypress app that was weighted never to be shown could become the only variant shown. Fixes #34814.
Fixed a regression in 12.0.0 where an assertion on a cy.contains() command that matched no element did not say what was searched for, reporting
expected undefined not to exist in the DOMin the Command Log. The searched content is now shown, such asexpected Saving not to exist in the DOM. Fixes #25962.Fixed a regression in 16.0.0 where blockHosts was not enforced in Chrome, Chromium, and Edge. Requests to a blocked host reached the network instead of failing with a
503status. Scripts and other resources from those hosts still loaded. Fixes #34785.Fixed a regression in 16.0.0 where the headless Electron browser window was sized smaller than requested on Windows during
cypress run, so failure screenshots and recorded videos were smaller than the expected 1280x720. Settingpreferences.widthandpreferences.heightin before:browser:launch had no effect on the result. Fixes #34771.
Misc:
Fixed an issue where setting keystrokeDelay in a TypeScript configuration file failed to compile with
'keystrokeDelay' does not exist in type 'ConfigOptions', even though Cypress read and validated the option at runtime. Fixes #34796. Addressed in #34798.When a Test Replay recording fails while being prepared for a spec during
cypress run, Cypress now recommends increasing available disk space and confirming that the temporary directory used for Test Replay recordings is readable and writable, instead of printing only the underlying error such asSqliteError: unable to open database file. Addressed in #34763.
16.0.0
1 Sep 2026- Removed
Removed the
cy.end()command, which ended a chain of commands by yieldingnull. A Cypress chain is already terminated when the nextcy.<command>()starts a new chain, so existing.end()calls can simply be removed. See the Migration Guide. Addressed in #33696. - Removed
Removed the
experimentalSourceRewritingconfiguration option. The default regex-based source rewriting handles every case the AST-based rewriter did, so default behavior is unchanged and the option can be deleted from your config. If you were using it to work around Subresource Integrity errors, enable removeSRIAttributes instead. See the Migration Guide. Addresses #34213.
16.0.0
Released Sep 1, 2026
Summary
Faster tests, less flake, and a few breaking changes that may require updates.
Most of this release's speed arrives without you editing a single test: requests run over HTTP/2 by default in Chrome, Chromium, and Edge browsers,
cy.type()drops its 10ms keystroke delay, visibility checks use a faster algorithm, cookie and storage commands now retry the way queries do, and browser memory management is on by default so long runs stop crashing partway through. Read the full Cypress 16 announcement for what changed and why.Breaking Changes:
info
Refer to the 16 Migration Guide for help migrating your code. The upgrade guide also includes a ready-made prompt for your AI assistant to assist you with the upgrade.
Chrome, Chromium, and Edge intercept test traffic on the native browser network rather than routing it through Cypress. A small number of
cy.intercept()behaviors differ as a result. Most notably,req.httpVersionis no longer reported, and compression headers are no longer present on an intercepted response. Firefox, WebKit, and Electron continue to use the legacy network path, and forceHttp1 routes every browser back through it while you migrate. See Native network interception and the Migration Guide. Addresses #3708.- Breaking
Removed support for Node.js 20 and Node.js 25. Cypress now requires Node.js 22.x, 24.x, or >=26.x. Addresses #33705 and #33778.
Upgraded the bundled Node.js version from
22.19.0to24.15.0. Addressed in #33494.Removed
Cypress.env(). Use Cypress.expose() for non-sensitive values that need to be readable in the browser, and cy.env() for sensitive values that must remain in the Node process. Theenvkey is no longer supported in per-test or suite config overrides; useexpose: { KEY: value }instead if absolutely necessary. TheallowCypressEnvconfiguration option has also been removed. See the Migration Guide. Addresses #33889. Addressed in #33963.Removed the cy.exec() command and the
execTimeoutconfiguration option, both deprecated in Cypress15.21.0. Use cy.task() andtaskTimeoutinstead — a task runs in Node without depending on the operating system, shell, or terminal of the machine running Cypress. Callingcy.exec()now throws, and settingexecTimeoutprints a warning and is otherwise ignored. See the Migration Guide. Addresses #34694.- Removed
Removed the
cy.end()command, which ended a chain of commands by yieldingnull. A Cypress chain is already terminated when the nextcy.<command>()starts a new chain, so existing.end()calls can simply be removed. See the Migration Guide. Addressed in #33696. The
experimentalMemoryManagementconfiguration option has graduated out of experimental status and been replaced by manageBrowserMemory, which defaults totrue. Memory management is now enabled by default in Chromium-based browsers. SettingexperimentalMemoryManagementprints a warning and is otherwise ignored. If you previously setexperimentalMemoryManagement: falseto opt out, you must now setmanageBrowserMemory: false. See the Migration Guide. Addresses #34385.- Removed
Removed the
experimentalSourceRewritingconfiguration option. The default regex-based source rewriting handles every case the AST-based rewriter did, so default behavior is unchanged and the option can be deleted from your config. If you were using it to work around Subresource Integrity errors, enable removeSRIAttributes instead. See the Migration Guide. Addresses #34213. The default
keystrokeDelayfor cy.type() has been changed from10to0to improve performance of typing-heavy test runs. Users who relied on the implicit 10ms delay can restore it by settingkeystrokeDelay: 10in their Cypress configuration or via Cypress.Keyboard.defaults(). Addresses #33523.- Deprecated
The experimental
experimentalFastVisibilityflag has been replaced by a new visibilityStrategy configuration option that accepts'legacy'or'modern'and defaults to'modern'. The modern visibility algorithm (based on the browser's nativeElement.checkVisibility()API) is now the default for all users.visibilityStrategyis deprecated, so setvisibilityStrategy: 'legacy'only as a temporary migration path. See the Visibility Strategy guide for migration help. Addressed in #33794. cy.getCookie(), cy.getCookies(), and cy.getAllCookies() are now retry-able query commands. They re-read cookies and retry any chained assertions until they pass or time out, are governed by defaultCommandTimeout, and can no longer be overwritten with Cypress.Commands.overwrite(). Use Cypress.Commands.overwriteQuery() instead. See the Migration Guide. Addresses #4802.
viewportWidth and viewportHeight can no longer be set via Cypress.config() during test execution. Setting them this way affected the next test rather than the current one and was not reflected in Test Replay. Use cy.viewport() or set them in the test configuration of a
describe,context, oritblock instead. See the Migration Guide. Addresses #31592. Addressed in #34262.blockHosts can no longer be set via Cypress.config() during test execution. Setting it this way affected the next test rather than the current one. Set
blockHostsin the test configuration of adescribe,context, oritblock instead. See the Migration Guide. Addressed in #34553.cy.getAllLocalStorage() and cy.getAllSessionStorage() are now retry-able query commands. They re-read storage from all origins and retry any chained assertions until they pass or time out, accept a
timeoutoption governed by defaultCommandTimeout, and can no longer be overwritten with Cypress.Commands.overwrite(). Use Cypress.Commands.overwriteQuery() instead. See the Migration Guide. Addresses #26422. Addressed in #34318.The
cypress infocommand no longer prints proxy environment variables (HTTP_PROXY,HTTPS_PROXY,NO_PROXY) orCYPRESS_*environment variables, so its output is safe to paste into a bug report. The command now reports only Cypress-specific details such as file paths, version, and system information. Addresses #34103. Fixed in #34314.- Removed
Removed built-in CoffeeScript support. The default
@cypress/webpack-batteries-included-preprocessorno longer bundlescoffee-loaderorcoffeescript, and.coffeeis no longer resolved for specs, support files, or cy.fixture(). Use JavaScript or TypeScript, or add CoffeeScript to your own webpack config via @cypress/webpack-preprocessor. See the Migration Guide. Addressed in #33654. Component Testing breaking changes:
Angular
Removed support for Angular 18, 19, and 20. The minimum supported version is now
21.0.0. Addresses #33005, #33655, and #33656.cypress/angular-zonelesshas been merged upstream intocypress/angular. In a corresponding change, the@cypress/angular-zonelessnpm package is deprecated and no longer supported andcypress/angular-zonelessis no longer shipped with the Cypress binary. Addresses #33007.The zoneless testing harness is now the default in
cypress/angular.zone.jsis no longer required to be installed for your Cypress project.@angular/platform-browser-dynamichas been replaced with@angular/platform-browser. Addresses #33006.autoSpyOutputsandautoDetectChangeshave been removed fromcypress/angular.@cypress/schematicnow requirescypress^16.0.0,@angular/cli>=21.0.0and@angular/core>=21.0.0, and no longer scaffolds thecypress/angular-zonelessmount handler. Addresses #33007.
Vite
Next.js
Removed support for Next.js 14. Next.js 15.0.4+ or 16+ is now required. Addressed in #33641.
Deprecations:
- Breaking
Deprecated the Electron browser as a test browser. The Electron browser will be removed in a future major version of Cypress; switch to Chrome or another installed browser to avoid a breaking change when you upgrade. See Migrating away from the Electron browser. Addresses #33560. Addressed in #34074.
- Deprecated
Added the forceHttp1 configuration option, which routes every browser through the legacy network path. It is deprecated at introduction and prints a warning when set: it exists to give suites time to migrate to the native browser network, and will be removed once that path is supported long term in both Chrome and Firefox. Addresses #33847.
Features:
Cypress now supports HTTP/2/3 in Chrome, Chromium, and Edge. Your application is tested over the same protocol it uses in production, with multiplexed requests and no six-connection ceiling, so modern apps load faster under test and behave the way your users actually experience them. Cypress also stops terminating TLS for the application under test, so the browser validates your origin's real certificate instead of one Cypress generates. See Native network interception and the Migration Guide. Addresses #3708.
Angularversion 22 is now supported within component testing, including Launchpad project detection and the@cypress/schematicAngular CLI integration. Addresses #33753.
Bugfixes:
Fixed an issue where Firefox tests could intermittently fail with errors like
Cannot get AUT url: no AUT context initializedwhen a command ran while Cypress was still identifying the application frame — for example right after a reload, a navigation, or moving to the next spec. Cypress now waits for the frame to be identified, and re-derives it if the browser event announcing it was missed. Fixes #34705.Fixed an issue where the after:run event handler would not run when a project was closed in
cypress openmode and experimentalInteractiveRunEvents was set. Addressed in #34700.Fixed an issue where a single cleanup step that stalled while Cypress shut down, such as waiting on a browser that was slow to close, could hold up the rest of shutdown. Addressed in #34699.
Fixed an issue where
cypress tap specsandcypress tap runfailed against a Cypress session whose project sets the internalnamespaceconfiguration option, reporting that the session was older than the CLI when it was not. Addresses #34660.
Dependency Updates:
Upgraded
electronfrom37.6.0to41.7.0.Upgraded bundled Chromium version to
146.0.7680.216.Upgraded dayjs from 1.10.4 to 1.11.23. Date comparisons are significantly faster, reducing background work while a run is in progress. Addressed in #34748.
- 15.x
15.21.0
18 Aug 2026- Deprecated
cy.exec()has been deprecated and will be removed in a future major release of Cypress. Use cy.task() instead, which runs in Node without depending on the operating system, shell, or terminal of the machine running Cypress. The execTimeout configuration option is deprecated alongside it, in favor of taskTimeout. Addresses #34639. Added a
CYPRESS_DISABLE_GUEST_TELEMETRYenvironment variable, which disables any reporting Cypress sends for non-logged sessions. This includes anonymous usage events within Cypress open-mode and the Cypress CLI. Addressed in #34540.Fixed an issue where WebKit runs could hang indefinitely when more parallel requests than the browser's per-host connection pool were intercepted by a cy.intercept() route with a request handler. Fixes #33926 and addresses #23807.
15.21.0
Released Aug 18, 2026
Deprecations:
- Deprecated
cy.exec()has been deprecated and will be removed in a future major release of Cypress. Use cy.task() instead, which runs in Node without depending on the operating system, shell, or terminal of the machine running Cypress. The execTimeout configuration option is deprecated alongside it, in favor of taskTimeout. Addresses #34639.
Features:
Added a
CYPRESS_DISABLE_GUEST_TELEMETRYenvironment variable, which disables any reporting Cypress sends for non-logged sessions. This includes anonymous usage events within Cypress open-mode and the Cypress CLI. Addressed in #34540.
Bugfixes:
Fixed an issue where WebKit runs could hang indefinitely when more parallel requests than the browser's per-host connection pool were intercepted by a cy.intercept() route with a request handler. Fixes #33926 and addresses #23807.
Fixed an issue where overriding blockHosts with test configuration (for example
describe('...', { blockHosts: [...] }, ...)) had no effect, so requests were still blocked or allowed according to the project-level value. Test-levelblockHostsoverrides now take effect at runtime and are restored between specs. Fixes #21151.Fixed an issue where
cypress runprinted the(Attempt N of M)line twice for the same attempt when abeforeEachand anafterEachhook both failed during that attempt. Fixes #26143.Fixed an issue where passing an object to the have.attr, have.css, or have.prop assertions, such as
.should('have.css', { backgroundColor: 'rgb(128, 0, 0)' }), applied those styles, attributes, or properties to the element and passed instead of asserting on them. These assertions now fail with an error stating that the name must be a string. Fixes #26451.Fixed an issue where the console props output for a cy.env() command listed the requested environment variable names under numbered keys instead of a single
Env varslabel. Addressed in #34615.Fixed an issue on Windows where adding, renaming, moving or deleting a spec file while
cypress openwas running was not reflected in the specs list, leaving stale specs until Cypress was restarted. Clicking a spec that had been renamed or moved could then fail to run. Projects whose specPattern contains a directory, such as the End-to-End Testing defaultcypress/e2e/**/*.cy.{js,jsx,ts,tsx}, were affected. Fixes #22303.
Dependency Updates:
Upgraded
@sinonjs/fake-timersfrom11.3.1to14.0.0. While cy.clock() is active, the fakedperformanceobject now implementsperformance.mark()andperformance.measure()(previously no-ops that returnedundefined) and reports a fakedperformance.timeOrigin. Addressed in #34377.
15.16.0
26 May 2026- Security
Upgraded
esbuildto^0.28.0to address CVE-2025-68121 in the bundledesbuildGo binary (incorrect TLS certificate validation during session resumption), as reported in container and image security scans. Fixes #33599. Addressed in #33816. Cypress Cloud sign up is supported from the Cypress desktop app in addition to log in. Addressed in #33805.
The Cypress Cloud log in and sign up modals in the Cypress desktop app now automatically start the browser-based authentication flow when opened, removing the extra "Log in" click. Addressed in #33831.
15.16.0
Released May 26, 2026
Features:
Cypress Cloud sign up is supported from the Cypress desktop app in addition to log in. Addressed in #33805.
The Cypress Cloud log in and sign up modals in the Cypress desktop app now automatically start the browser-based authentication flow when opened, removing the extra "Log in" click. Addressed in #33831.
Bugfixes:
Fixed an issue on Node
24.16.0+ and Node26.1.0+ where installing Cypress could silently extract only the first file from the binary archive, causing the test runner to fail to launch with a "Cypress binary is missing" error. Addresses #33891. Addressed in #33887.Fixed a regression in 15.14.2 where the
cypress installandcypress verifytask list output could render one character per line in CI environments that allocate a pseudo-TTY without settingCOLUMNS. Fixed in #33890.Fixed an issue where Cypress would abort the process and show a crash dialog when it received a SIGINT. Fixes #29228. Fixed in #33542.
Fixed an issue where the clientCertificates config option failed to load ECDSA (EC) PEM or PKCS#12 client certificates. Fixes #33767. Fixed in #33799.
Fixed an issue where clicking "back to projects" or switching projects while a project's initial config load was still in flight could fail. Fixed in #33810.
Fixed an intermittent
ENOENT: no such file or directory, open <path>/bundle.tar-<rand>error during cy.prompt and Studio bundle initialization. Fixed in #33748.Fixed a regression in 14.3.3 where deleting
results.videoinafter:specto keep videos only for failing specs could leave an empty*-compressed.mp4file incypress/videos. Fixes #32883.Fixed an issue where Cypress's bundled TypeScript type definitions could fail to compile in a project that also installed
@sinonjs/fake-timers@>=15.3.0, because the bundled@types/sinonfile importedFakeTimersfrom@sinonjs/fake-timersand TypeScript would prefer the user's installed copy over the bundled@types/sinonjs__fake-timers. The shipped types now reference the@typespackage directly so resolution is independent of the user's installed version. Fixes #33829. Fixed in #33886.
Dependency Updates:
- Security
Upgraded
esbuildto^0.28.0to address CVE-2025-68121 in the bundledesbuildGo binary (incorrect TLS certificate validation during session resumption), as reported in container and image security scans. Fixes #33599. Addressed in #33816.
15.15.0
12 May 2026- Deprecated
The
cy.end()command has been deprecated and will be removed in a future release. Instead of using.end()to break a chain, start a new chain of commands off ofcy. Addressed in #33707. - Security
Upgraded
socket.iofrom4.0.1to4.8.3,socket.io-clientfrom4.0.1to4.8.3, andsocket.io-parserfrom4.0.5to4.2.6to address a Denial of Service vulnerability reported in security scans. Theengine.io,engine.io-client, andengine.io-parserdirect deps in@packages/socketwere also bumped to keep transitive copies aligned and the existing browser-side patches applied. Addressed in #33719. - Security
Upgraded
uuidfrom8.3.2to11.1.1to address an Improper Validation of Specified Index, Position, or Offset in Input vulnerability reported in security scans. Addressed in #33765.
15.15.0
Released May 12, 2026
Deprecations:
- Deprecated
The
cy.end()command has been deprecated and will be removed in a future release. Instead of using.end()to break a chain, start a new chain of commands off ofcy. Addressed in #33707.
Bugfixes:
Fixed an issue where the proxy stripped
Content-Length: 0from empty responses (e.g. aDELETE 200with no body) and the resulting empty body was re-emitted withTransfer-Encoding: chunked, breaking clients that assume a fixed-length response. Partially addresses #16469. Fixed in #33754.Fixed an issue where component specs that defined local React components could register every
describe/itblock twice incypress openwhen using Vite 8, because React refresh treated those specs as HMR self-accepting modules.@cypress/vite-dev-servernow excludes component spec files from JSX refresh while leaving Fast Refresh enabled for application source. Fixes #33750.Fixed an issue where multi-origin tests using cy.origin could fail to talk to a secondary origin after test isolation, when the spec-bridge iframe was already present, or when more than one secondary origin became ready around the same time. Cached spec-bridge window targets are now cleared at the correct lifecycle points, improving performance of specs with cy.origin calls. Addressed in #33704.
Fixed an issue where a CSS selector built internally from element attributes could throw an uncaught
Syntax error, unrecognized expressionand crash the runner when an attribute value contained CSS-special characters (for example, an<input>with apatternattribute containing regex metacharacters). Fixes #26967 and #29345.Fixed an issue where transient HTTP 500 responses from Cypress Cloud were not retried for idempotent requests. Fixed in #33718.
Fixed an issue in Angular component testing where multiple projects in a monorepo sharing the same directory basename (e.g.
libs/feature-a/feat-shellandlibs/feature-b/feat-shell) would intermittently fail with spec-resolution errors when run in parallel. The temporarytsconfig.jsongenerated by@cypress/webpack-dev-serverwas keyed only on the directory basename, so parallel runs would race on the same file. The temp directory is now suffixed with a short hash of the full project root path, giving each project its own isolated config. Fixes #33634.Fixed a race during
cypress openconfig reload where rapid changes tocypress.config.jscould leave the specs list stale. Two overlapping config-reload calls would tear down each other's IPC child processes (surfacing asERR_STREAM_DESTROYED), causing both reloads to fail and the specs list to never refresh. Fixed in #33775.Fixed an issue where a transient Firefox launch failure caused Cypress to exit instead of retrying the browser launch. Fixed in #33770.
Dependency Updates:
- Security
Upgraded
socket.iofrom4.0.1to4.8.3,socket.io-clientfrom4.0.1to4.8.3, andsocket.io-parserfrom4.0.5to4.2.6to address a Denial of Service vulnerability reported in security scans. Theengine.io,engine.io-client, andengine.io-parserdirect deps in@packages/socketwere also bumped to keep transitive copies aligned and the existing browser-side patches applied. Addressed in #33719. - Security
Upgraded
uuidfrom8.3.2to11.1.1to address an Improper Validation of Specified Index, Position, or Offset in Input vulnerability reported in security scans. Addressed in #33765.
15.14.0
16 Apr 2026- Security
Upgraded
axiosto1.15.0to address CVE-2025-62718 and CVE-2026-40175 vulnerabilities reported in security scans. Fixes #33590. Reduced browser memory growth during long interactive runs by clearing stored command log data (messages, URLs, snapshots, console props, and other fields—including custom
Cypress.logproperties) once tests age out ofnumTestsKeptInMemory, so the runner can reclaim memory and stay more responsive. Addressed in #33601.
15.14.0
Released Apr 16, 2026
Performance:
Reduced browser memory growth during long interactive runs by clearing stored command log data (messages, URLs, snapshots, console props, and other fields—including custom
Cypress.logproperties) once tests age out ofnumTestsKeptInMemory, so the runner can reclaim memory and stay more responsive. Addressed in #33601.
Features:
Cypress now officially supports TypeScript 6. Addresses #33385 and #33511.
Adds Vite 8 support for component testing. Addresses #32550 and #33078.
Bugfixes:
Fixed an issue where Cypress tests in open mode would not pick up on modified
envvalues in the user's config file. Fixed in #33567. Fixes #33372.
Dependency Updates:
- Security
Upgraded
axiosto1.15.0to address CVE-2025-62718 and CVE-2026-40175 vulnerabilities reported in security scans. Fixes #33590.
15.13.1
7 Apr 202615.13.0
24 Mar 2026- Security
Upgraded
simple-gitfrom3.27.0to3.32.3to address Improper Handling of Case Sensitivity (CVE-2026-28292) vulnerability reported in security scans. Addressed in #33470. - Security
Upgraded
minimatchto3.1.3to address CVE-2026-26996, CVE-2026-27903, and CVE-2026-27904 ReDoS vulnerabilities reported in security scans. Addressed in #33461. - Security
Upgraded
serialize-javascriptto7.0.3to address GHSA-5c6j-r48x-rmvq vulnerability reported in security scans. Addressed in #33461.
15.13.0
Released Mar 24, 2026
Features:
cy.prompt is now in beta and available without any configuration.
cy.promptis an AI-powered command that lets you write test steps in plain English instead of code. TheexperimentalPromptCommandflag was removed and can be deleted from your config. Addressed in #33497.Studio now allows adding a new test when focused on a single test, supporting a workflow to add new tests as you record. Addressed in #33481.
Bugfixes:
Fixed an issue where Cypress may hang when running component tests and a connection to the dev server can no longer be made. Addressed
Misc:
When a test is isolated in Studio, the 'rerun' button now properly says 'Run test'. Addressed in #33466.
Studio now warns users before navigating if they try to exit when they have unsaved changes in the editor. Addressed in #33457.
Dependency Updates:
- Security
Upgraded
simple-gitfrom3.27.0to3.32.3to address Improper Handling of Case Sensitivity (CVE-2026-28292) vulnerability reported in security scans. Addressed in #33470. - Security
Upgraded
minimatchto3.1.3to address CVE-2026-26996, CVE-2026-27903, and CVE-2026-27904 ReDoS vulnerabilities reported in security scans. Addressed in #33461. - Security
Upgraded
serialize-javascriptto7.0.3to address GHSA-5c6j-r48x-rmvq vulnerability reported in security scans. Addressed in #33461. - Security
Upgraded
flattedfrom3.2.9to3.4.2to address Prototype Pollution (CVE-2026-33228) vulnerability reported in security scans. Addressed in #33501.
15.12.0
13 Mar 2026- Security
Upgraded
basic-ftpto5.2.0to address CVE-2026-27699 vulnerability reported in security scans. Addresses #33436. - Security
Upgraded
fast-xml-parserto4.5.4to address CVE-2026-25896 vulnerability reported in security scans. Addresses #33434. Adds an option to enable word wrap for Studio panel code. Addressed in #33411.
15.12.0
Released Mar 13, 2026
Features:
Adds an option to enable word wrap for Studio panel code. Addressed in #33411.
Bugfixes:
Fixed an issue where sending SIGINT (e.g. Ctrl+C) to exit Cypress left the terminal displaying raw characters. Fixes #33367. Addressed in #33431.
Fixed an issue in develop mode (when running Cypress via gulp with file watching) where closing the Electron window did not exit the gulp process, leaving it running. Addressed in #33431.
Fixed an issue where internal tags on stderr streams were surfacing to the end user CLI during component testing. Addresses #32769. Addressed in #33400.
Fixed an issue where Cypress may hang when waiting on multiple intercepts and the page navigates causing a stability change. Addressed in #33446.
Dependency Updates:
- Security
Upgraded
basic-ftpto5.2.0to address CVE-2026-27699 vulnerability reported in security scans. Addresses #33436. - Security
Upgraded
fast-xml-parserto4.5.4to address CVE-2026-25896 vulnerability reported in security scans. Addresses #33434.
15.11.0
25 Feb 2026- Security
Upgraded
qsto6.14.2to address CVE-2026-2391 vulnerability reported in security scans. Addresses #33363. - Security
Upgraded
rimrafto6.1.1to address CVE-2026-25547 vulnerability reported in security scans. Addressed in #33336. - Security
Upgraded
squirrellyto9.1.0to address CVE-2021-32819 vulnerability reported in security scans. Addresses #33354.
15.11.0
Released Feb 25, 2026
Features:
Adds
--pass-with-no-testscommand line flag. Addresses #23019. Addressed in #33384.Introduces manual bootstrap script injection via a
<script data-cy-bootstrap>tag. This is a workaround to fix React SSR hydration mismatches, and enables React apps to usesuppressHydrationWarningto ignore the mismatch. Addresses #27204. Addressed in #33295.Added Brotli compression support to the proxy. Addresses #6197.
Improved CI environment detection and CI/commit metadata capture for Cypress Cloud recorded runs. Added support for Harness CI, AWS Amplify Console, Buddy, Bitrise, and Cloudbees Unify and removed support for EOL providers. Addressed in #33396.
Bugfixes:
Fixed an issue where a cancelled or incomplete login attempt would not properly open a browser window or tab, and required a restart of Cypress to enable a new login attempt. Fixed in #33366. Fixes #33350.
Fixed an issue on Windows where extracting the Studio or Prompt bundle could fail with
EPERM: operation not permittedwhen renaming extracted files. The extract step now retries on EPERM/EACCES with a short delay to handle transient file locks. Addressed in #33330.The capture protocol is now properly cleaned up when the protocol is re-initialized or when the run closes, ensuring CDP client listeners and resources are removed. Addressed in #33391.
Misc:
The Node.js path is now displayed correctly in run log headers for typical GitHub Actions paths. ANSI escape sequences are no longer incorrectly displayed for longer Node.js paths. Addresses #32736.
Fixed an issue that caused a Node.js DEP0169 deprecation warning to be output when executing
cypress installto download and install the Cypress binary. Addresses #33347.
Dependency Updates:
- Security
Upgraded
qsto6.14.2to address CVE-2026-2391 vulnerability reported in security scans. Addresses #33363. - Security
Upgraded
rimrafto6.1.1to address CVE-2026-25547 vulnerability reported in security scans. Addressed in #33336. - Security
Upgraded
squirrellyto9.1.0to address CVE-2021-32819 vulnerability reported in security scans. Addresses #33354. - Security
Upgraded
systeminformationto5.31.1to address CVE-2026-26280 and CVE-2026-26318 vulnerabilities reported in security scans. Addresses #33389.
15.10.0
3 Feb 2026- Security
Upgraded
expressto4.22.0andbody-parserto1.20.4. This removes the CVE-2025-15284 vulnerability being reported in security scans. Addressed in #33305. - Security
Upgraded
lodashto4.17.23. This removes the CVE-2025-13465 vulnerability being reported in security scans. Addresses #33269. - Security
Upgraded
shell-envto4.0.1and@cypress/commit-infoto2.2.2. This removes the GMS-2020-2 vulnerability being reported in security scans. Addressed in #33226 and #33263.
15.10.0
Released Feb 03, 2026
Deprecations:
Cypress.env()is now deprecated and will be removed in a future major release of Cypress. To understand why, and how to migrate, read our Migration Guide. Addressed in #33181.Features:
Introduced a new cy.env() command that can be used to asynchronously and securely access Cypress environment variables. Addressed in #33181.
Added a allowCypressEnv configuration option that disallows use of the deprecated
Cypress.env()API. Addressed in #33181.Introduced the new
Cypress.expose()API, intended for use of public configuration of non-sensitive values. Addressed in #33238.Displays the resolved
exposevalues in the App's resolved configuration user interface. Addressed in #33322.
Bugfixes:
Fixed an issue where the user did not always have the ability to create a new test in Studio. Also, fixed an issue where creating a new test from an empty spec would display the welcome to studio screen instead of the form to name the new test. Addressed in #33236.
Misc:
The icon in the 'Open in IDE' button in the command log is now the correct size. Addresses #32779. Addressed in #33217.
Dependency Updates:
- Security
Upgraded
expressto4.22.0andbody-parserto1.20.4. This removes the CVE-2025-15284 vulnerability being reported in security scans. Addressed in #33305. - Security
Upgraded
lodashto4.17.23. This removes the CVE-2025-13465 vulnerability being reported in security scans. Addresses #33269. - Security
Upgraded
shell-envto4.0.1and@cypress/commit-infoto2.2.2. This removes the GMS-2020-2 vulnerability being reported in security scans. Addressed in #33226 and #33263.
15.2.0 – 15.9.011 releases without a noteShow each
15.1.0
2 Sep 2025Fixed an issue where Cypress would fail to run on GNOME if GTK 4 and GTK 2/3 were detected in the Electron process. Addresses #32361.
15.1.0
Released Sep 02, 2025
Features:
Bugfixes:
Fixed an issue where OS distributions and releases were sometimes not properly populated for Module API results and Cloud recordings. Fixes #30533. Addressed in #32283.
Fixed an issue where Cypress would fail to run on GNOME if GTK 4 and GTK 2/3 were detected in the Electron process. Addresses #32361.
Fixed an issue where the open Studio button would incorrectly show for component tests. Addressed in #32315.
Fixed an issue where the TypeScript compiler wasn't being resolved correctly when
@cypress/webpack-batteries-included-preprocessorwas used as a standalone package. Fixes #32338.Fixed an issue where
tsxwas not being loaded correctly into the Cypress configuration process due to spaces being present in the path. Fixes #32398.
Misc:
Updated the Cypress Studio panel to have a darker gray background. Addressed in #32333.
Dependency Updates:
15.0.0
20 Aug 2025- Removed
Removed support for Node.js 18 and Node.js 23. Addresses #31302.
- Removed
Removed support for Linux distributions with
glibcolder than2.31. This support is in-line with Node.js' support for Linux in Node v20+. Addressed in #31912. - Removed
Removed support for Chrome DevTools Protocol with the Firefox browser. Addresses #31189.
15.0.0
Released Aug 20, 2025
Summary
This release prepares Cypress Studio for the next era of AI-assisted test creation. You can record interactions, add assertions by right-clicking, and now edit tests inline without leaving Cypress. Turn on
experimentalStudioin your config to try it out and share your feedback. Read more about the foundation for what's next in our blog post.Breaking Changes:
info
Refer to the v15 Migration Guide for help migrating your code.
- Removed
Removed support for Node.js 18 and Node.js 23. Addresses #31302.
- Removed
Removed support for Linux distributions with
glibcolder than2.31. This support is in-line with Node.js' support for Linux in Node v20+. Addressed in #31912. - Removed
Removed support for Chrome DevTools Protocol with the Firefox browser. Addresses #31189.
- Removed
Removed support of the deprecated 3 argument signature of
cy.stub. Usecy.stub(object, name).callsFake(fn)instead. Addresses #31346. - Breaking
@cypress/webpack-preprocessorno longer supportswebpackversion 4. Addresses #31344. If you still need to usewebpackversion 4, see our migration guide. To better align with best practices,
@cypress/webpack-batteries-included-preprocessorno longer includes certain browser built-ins that were automatically provided by Webpack 4. The removed built-ins areassert,constants,crypto,domain,events,http,https,punycode,querystring,string_decoder,sys,timers,tty,url,util,vm, andzlib. However, we know that certain built-ins are popular, given that many users have files that are shared between their Cypress tests and node context. Because of this,@cypress/webpack-batteries-included-preprocessorwill ship with built-in support forbuffer,path,process,os, andstream. If there is a built-in that isn't supported by default and you need to add support, refer to the Webpack resolve.fallback documentation and the @cypress/webpack-batteries-included-preprocessor README. Addresses #31039.The application under test's
pagehideevent in Chromium browsers will no longer trigger Cypress'swindow:unloadevent. Addressed in #31853.The
Cypress.SelectorPlaygroundAPI has been renamed toCypress.ElementSelector. This API was renamed to accommodate its use for definingselectorPriorityin Cypress Studio and our future cy.prompt release. Additionally, thegetSelectormethod and theonElementoption ofdefaultswere removed from this API. Addresses #31801. Addressed in #31889 and #32098.The direct download option for installing Cypress is no longer supported. Users should install via a package manager. Addressed in #32249.
Updated
execafrom1.0.0to4.1.0. This changes thecodeproperty returned bycy.exec()toexitCode. Addressed in #32238.Component Testing breaking changes:
Removed support for Angular 17. The minimum supported version is now
18.0.0. Addresses #31303.@cypress/angularnow requires a minimum ofzone.js0.14.0. Addresses #31582.The Cypress configuration wizard for Component Testing supports TypeScript 5.0 or greater. Addresses #31187.
@cypress/vite-dev-serveris now an ESM only package. You will no longer be able to use this package from a CommonJS context. Addresses #28373, #29557 and #31882.Removed support for Vite 4 inside
@cypress/vite-dev-server. The minimum Vite version is5. Addresses #32038.
@cypress/webpack-dev-serverno longer supportswebpack-dev-serverversion 4. Addresses #31605. If you still need to usewebpack-dev-serverversion 4, see our migration guide.
Features:
cy.url(), cy.hash(), cy.go(), cy.reload(), cy.title(), and cy.location() now use the automation client (CDP for Chromium browsers and WebDriver BiDi for Firefox) to return the appropriate values from the commands to the user instead of the window object. This is to avoid cross origin issues with cy.origin() so these commands can be invoked anywhere inside a Cypress test without having to worry about origin access issues. Experimental WebKit still will use the window object to retrieve these values. Also, cy.window() will always return the current window object, regardless of origin restrictions. Not every property from the window object will be accessible depending on the origin context. Addresses #31196.
Selectors accepted in the
selectorPriorityof theSelectorPlayground(renamed toElementSelector) API have been expanded to acceptnameandattributes:*. Additionally, the default selector priority used by Cypress now includesname. Addresses #31801 and #6876. Addressed in #31889.tsx is now used in all cases to run the Cypress config, replacing ts-node for TypeScript and Node.js for CommonJS/ESM. This should allow for more interoperability for users who are using any variant of ES Modules. Addresses #8090, #15724, #21805, #22273, #22747, #23141, #25958, #25959, #26606, #27359, #27450, #28442, #28696, #29186, #30318, #30718, #30907, #30915, #30925, #30954, and #31185.
Component Testing features:
@cypress/vite-dev-servernow supports vite version 7. Addresses #31882.Angularversion 20 is now supported within component testing. As of now,cypress/angularstill requireszone.jsand@angular-devkit/build-angular. Addresses #31304.
Bugfixes:
Fixed an issue where Create from Component feature might not be able to parse React components from project files. Fixed in #31457.
Fixed an issue where
isSecureContextwould befalseon localhost when testing with Cypress. Addresses #18217.Fixed an issue where Angular legacy
Output()decorators were broken when making component instance field references safe. Fixes #32137.Fixed an issue where
.fixture()would not return updated content after the underlying file was modified via.writeFile(). The fixture cache is now properly invalidated when the backing file is written to, ensuring updated content is returned in subsequent.fixture()calls. Fixes #4716.Fixed an issue where
.fixture()calls with a specified encoding would sometimes still attempt to parse the file based on its extension. Files with an explicit encoding are now always treated as raw content. Fixes #32139.Fixed an issue where
.fixture()calls with different encoding options would return inconsistent content based on execution order. Fixes #32138.Filters content written to stderr to prevent Electron from spamming with inconsequential errors/warnings. This stderr content can be viewed by enabling the
cypress:internal-stderrdebug namespace. Fixes #32070.Fixed an issue where Angular Component Testing was printing extraneous warnings to the console by default. By default, errors only will now print to the console. This can still be overridden by passing in a custom webpack config or setting the
verboseoption inside yourangular.json. Addresses #26456.Fixed an issue where
ts-loaderwas improperly being detected inside@cypress/webpack-preprocessor. Fixes #32265.Fixed an issue where
.fixture()calls withnullandundefinedencoding options would incorrectly share cache entries, causing unexpected content to be returned. Cache keys now properly distinguish between these encoding values. Fixes #32274.
Misc:
The Cypress Command log has a new design when viewing a list of tests. Addresses #31677. Addressed in #31914.
Migration helpers and related errors are no longer shown when upgrading from Cypress versions earlier than 10.0.0. To migrate from a pre-10.0.0 version, upgrade one major version at a time to receive the appropriate guidance. Addresses #31345. Addressed in #31629.
Dependency Updates:
Upgraded
electronfrom33.2.1to36.4.0. Addresses #31257. Addressed in #31912.Upgraded bundled Node.js version from
20.18.1to22.15.1. Addresses #31257. Addressed in #31912.Upgraded bundled Chromium version from
130.0.6723.137to136.0.7103.149. Addresses #31257. Addressed in #31912.- Security
Upgraded
body-parserfrom1.20.2to1.20.3. This removes the SNYK-JS-BODYPARSER-7926860 vulnerability being reported in security scans. Addressed in #32225. Upgraded
systeminformationfrom5.22.8to5.27.7. Addressed in #32234.- Security
Upgraded
tmpfrom~0.2.3to~0.2.4. This removes the CVE-2025-54798 vulnerability being reported in security scans. Addresses #32176.
- 14.x
14.5.0
17 Jun 2025Install Cypress
win32-x64binary on Windowswin32-arm64systems. Cypress runs in emulation. Addresses #30252.Fixed an issue when using
Cypress.stop()where a run may be aborted prior to receiving the required runner events causing Test Replay to not be available. Addresses #31781.
14.5.0
Released Jun 17, 2025
Features:
Install Cypress
win32-x64binary on Windowswin32-arm64systems. Cypress runs in emulation. Addresses #30252.
Bugfixes:
Fixed an issue when using
Cypress.stop()where a run may be aborted prior to receiving the required runner events causing Test Replay to not be available. Addresses #31781.
14.4.1
3 Jun 202514.4.0
20 May 2025- Breaking
Chrome 137+ no longer supports
--load-extensionin branded Chrome, breaking the@cypress/puppeteerplugin inopenmode and headedrunmode and launchOptions.extensions. We recommend using Electron, Chrome for Testing or Chromium to continue using these features. See Cypress Docker image examples for Chrome for Testing and Chromium. Addresses #31702 and #31703. Fixed an issue where framebusting was occurring when
top.window.locationwas being set explicitly. This fix does not require theexperimentalModifyObstructiveThirdPartyCodeconfiguration option. Addresses #31687.cy.press()now has a return type ofChainable<null>instead ofvoidto match the convention of other commands that yieldnull. Addressed in #31698.
14.4.0
Released May 20, 2025
Features:
Bugfixes:
Fixed an issue where framebusting was occurring when
top.window.locationwas being set explicitly. This fix does not require theexperimentalModifyObstructiveThirdPartyCodeconfiguration option. Addresses #31687.cy.press()now has a return type ofChainable<null>instead ofvoidto match the convention of other commands that yieldnull. Addressed in #31698.Fixed an issue with the experimental usage of WebKit where Cypress incorrectly displayed
0as the WebKit version. Addresses #31684.
Misc:
- Breaking
Chrome 137+ no longer supports
--load-extensionin branded Chrome, breaking the@cypress/puppeteerplugin inopenmode and headedrunmode and launchOptions.extensions. We recommend using Electron, Chrome for Testing or Chromium to continue using these features. See Cypress Docker image examples for Chrome for Testing and Chromium. Addresses #31702 and #31703. Cursor is now available as an IDE option for opening files in Cypress, if it is installed on your system. Addressed in #31691.
The error shown when the
--recordflag is missing has been updated to be shorter. Addressed in #31676.
Dependency Updates:
Upgraded
@sinonjs/fake-timersfrom8.1.0to10.3.0. Addressed in #31725 and #31737.Upgraded
trashfrom5.2.0to7.2.0. Addressed in #31667.Upgraded
webdriverfrom9.11.0to9.14.0. Addressed in #31689.
14.3.0
8 Apr 2025The cy.press() command is now available.
cy.press()supports dispatching native Tab keyboard events to the browser. Addresses #31050. Addresses #299. Addressed in #31398.Allows for
babel-loaderversion 10 to be a peer dependency of@cypress/webpack-preprocessor. Fixed in #31218.Fixed an issue where Firefox BiDi was prematurely removing prerequests on pending requests. Fixes #31376.
14.3.0
Released Apr 08, 2025
Features:
The cy.press() command is now available.
cy.press()supports dispatching native Tab keyboard events to the browser. Addresses #31050. Addresses #299. Addressed in #31398.
Bugfixes:
Allows for
babel-loaderversion 10 to be a peer dependency of@cypress/webpack-preprocessor. Fixed in #31218.Fixed an issue where Firefox BiDi was prematurely removing prerequests on pending requests. Fixes #31376.
Fixed an issue with Electron causing slow animations and increased test times by starting a CDP screencast with a noop configuration. Fixes #30980.
Misc:
Added an automation command for dispatching key press events to CDP and BiDi automated browsers. Addressed in #31366.
Updated error message around
injectDocumentDomainremoval to mention a future version of Cypress instead of Cypress 15. Addresses #31373. Addressed in #31375.
Dependency Updates:
14.2.1
26 Mar 2025
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.