Packages

cypress

16.3.0 · 10 Nov 2026MIT7.6M / weekRepositoryHomepagenpmAtom feed

Your version

16.0.0

major1 Sep 2026Where it was published

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

    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.

  • Breaking

    Removed support for Angular 18, 19, and 20. The minimum supported version is now 21.0.0. Addresses #33005, #33655, and #33656.

  • Breaking

    Removed support for Vite 5, Vite 6, and Vite 7 when using the Vite dev server for component testing. The minimum supported Vite version is now 8.0.0. Upgrade Vite (and any @vitejs/* plugins that pin older major versions) before upgrading Cypress. Addresses #33724, #33725, and #33726.

  • 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 yielding null. A Cypress chain is already terminated when the next cy.<command>() starts a new chain, so existing .end() calls can simply be removed. See the Migration Guide. Addressed in #33696.

  • Removed

    Removed the experimentalSourceRewriting configuration 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-preprocessor no longer bundles coffee-loader or coffeescript, and .coffee is 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.httpVersion is 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.0 to 24.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. The env key is no longer supported in per-test or suite config overrides; use expose: { KEY: value } instead if absolutely necessary. The allowCypressEnv configuration option has also been removed. See the Migration Guide. Addresses #33889. Addressed in #33963.

  • Removed the cy.exec() command and the execTimeout configuration option, both deprecated in Cypress 15.21.0. Use cy.task() and taskTimeout instead — a task runs in Node without depending on the operating system, shell, or terminal of the machine running Cypress. Calling cy.exec() now throws, and setting execTimeout prints 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 yielding null. A Cypress chain is already terminated when the next cy.<command>() starts a new chain, so existing .end() calls can simply be removed. See the Migration Guide. Addressed in #33696.

  • The experimentalMemoryManagement configuration option has graduated out of experimental status and been replaced by manageBrowserMemory, which defaults to true. Memory management is now enabled by default in Chromium-based browsers. Setting experimentalMemoryManagement prints a warning and is otherwise ignored. If you previously set experimentalMemoryManagement: false to opt out, you must now set manageBrowserMemory: false. See the Migration Guide. Addresses #34385.

  • Removed

    Removed the experimentalSourceRewriting configuration 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 keystrokeDelay for cy.type() has been changed from 10 to 0 to improve performance of typing-heavy test runs. Users who relied on the implicit 10ms delay can restore it by setting keystrokeDelay: 10 in their Cypress configuration or via Cypress.Keyboard.defaults(). Addresses #33523.

  • Deprecated

    The experimental experimentalFastVisibility flag 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 native Element.checkVisibility() API) is now the default for all users. visibilityStrategy is deprecated, so set visibilityStrategy: '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, or it block 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 blockHosts in the test configuration of a describe, context, or it block 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 timeout option 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 info command no longer prints proxy environment variables (HTTP_PROXY, HTTPS_PROXY, NO_PROXY) or CYPRESS_* 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-preprocessor no longer bundles coffee-loader or coffeescript, and .coffee is 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-zoneless has been merged upstream into cypress/angular. In a corresponding change, the @cypress/angular-zoneless npm package is deprecated and no longer supported and cypress/angular-zoneless is no longer shipped with the Cypress binary. Addresses #33007.

      • The zoneless testing harness is now the default in cypress/angular. zone.js is no longer required to be installed for your Cypress project.

      • @angular/platform-browser-dynamic has been replaced with @angular/platform-browser. Addresses #33006.

      • autoSpyOutputs and autoDetectChanges have been removed from cypress/angular.

      • @cypress/schematic now requires cypress ^16.0.0, @angular/cli >=21.0.0 and @angular/core >=21.0.0, and no longer scaffolds the cypress/angular-zoneless mount handler. Addresses #33007.

    • Vite

      • Removed support for Vite 5, Vite 6, and Vite 7 when using the Vite dev server for component testing. The minimum supported Vite version is now 8.0.0. Upgrade Vite (and any @vitejs/* plugins that pin older major versions) before upgrading Cypress. Addresses #33724, #33725, and #33726.

    • 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.

  • Angular version 22 is now supported within component testing, including Launchpad project detection and the @cypress/schematic Angular CLI integration. Addresses #33753.

Bugfixes:

  • Fixed an issue where Firefox tests could intermittently fail with errors like Cannot get AUT url: no AUT context initialized when 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 open mode 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 specs and cypress tap run failed against a Cypress session whose project sets the internal namespace configuration option, reporting that the session was older than the CLI when it was not. Addresses #34660.

Dependency Updates:

  • Upgraded electron from 37.6.0 to 41.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.