cypress
16.3.0 · 10 Nov 2026MIT7.6M / weekRepositoryHomepagenpmAtom feed
16.3.0 is the newest release of 16.x.
In short
5 breaking4 removed3 deprecated4 fixed18 changed1 internal
- Breaking
Faster tests, less flake, and a few breaking changes that may require updates.
- Breaking
- Breaking
- Breaking
- 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.
- 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. - 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.
Release note
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.
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.