@cypress/webpack-preprocessor
8.0.0 · 26 Aug 2026MIT1.6M / weekRepositoryHomepagenpmAtom feed
82 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 8.x · latest line
8.0.0
26 Aug 2026When running
cypress runprevious to 8.0, some browsers would launch headed
while others were launched headless by default. Cypress now runs all browsers
duringcypress runas headless by default. Addresses
#16832.The default screen size when running a headless browser has been reverted back
to 1280x720 pixels (pre 7.0 behavior). Addresses
#16853.When running the
--headlessChrome browser viacypress run, the device
pixel ratio will now be 1 by default, matching the behavior of all other
browsers. This behavior can be overridden through the
browser launch API.
Addresses #17375.
Released 07/19/2021
Summary:
We've made some updates to ensure a consistent run experience across browsers.
Now all browsers run viacypress runrun headlessly, with a device pixel ratio
of 1, and a screen size of 1280x720 by default.Breaking Changes:
<Icon name="exclamation-triangle" color="red"></Icon> Please read our
Migration Guide which explains the changes
in more detail and how to change your code to migrate to Cypress 8.0.When running
cypress runprevious to 8.0, some browsers would launch headed
while others were launched headless by default. Cypress now runs all browsers
duringcypress runas headless by default. Addresses
#16832.The default screen size when running a headless browser has been reverted back
to 1280x720 pixels (pre 7.0 behavior). Addresses
#16853.When running the
--headlessChrome browser viacypress run, the device
pixel ratio will now be 1 by default, matching the behavior of all other
browsers. This behavior can be overridden through the
browser launch API.
Addresses #17375.Cypress now enforces version checks for browser launching and will error
duringcypress runand not allow opening the browser incypress openwhen
attempting to open unsupported browser versions. Cypress supports Chrome >=
64, Firefox >= 86, and Edge >= 79. Addressed in
#17355.Arguments returned from a chained function will no longer incorrectly be of
typejQueryand instead have ananytype. Fixes
#16669.The
Cypress.ConfigOptions,Cypress.ResolvedConfigOptionsandCypress.RuntimeConfigOptiontypes have been updated so thatConfigOptions
match the JSON schema. Addressed in
#17251.
Features:
You can now configure certificate authority (CA) and client certificates to
use within tests on a per-URL basis via aclientCertificatesconfiguration
option. See Client certificates for
more detail.Setting the environment variable
ELECTRON_RUN_AS_NODEnow starts Cypress as
a normal Node.js process rather than an Electron process. See
Running headless tests without Xvfb
for more details. Addresses
#16505.
Bugfixes:
console.logandconsole.errorcalled within the
plugins file
will now be captured in thestdoutsent to the Cypress Dashboard, making it
visible in Output logs in the Dashboard. Fixes
#7434.There are several fixes for
cy.intercept()
including:When using the experimental
Cypress Studio, there should be a
reduced occurrence of "Studio failed to save commands" error messages. Fixes
#14767.cy.invoke()now retains the properthiscontext on
nested object methods. Fixes
#3871.We no longer trigger unnecessary snapshot re-renders when hovering over the
Command Log. Fixes
#17257.
- 7.x
7.1.0
13 Apr 2026The events
before:spec,after:spec,before:run, andafter:runnow fire in interactive mode in addition to run mode. This requires theexperimentalInteractiveRunEventsflag to be enabled. Addressed in #15787.Viewport configuration set in
cypress.jsonis now correctly applied in the Component Test Runner. Fixes #15899.Running specs on Windows is now supported in the Component Test Runner. Fixes #15842.
Released 04/12/2021
Features:
The events
before:spec,after:spec,before:run, andafter:runnow fire in interactive mode in addition to run mode. This requires theexperimentalInteractiveRunEventsflag to be enabled. Addressed in #15787.
Bugfixes:
Viewport configuration set in
cypress.jsonis now correctly applied in the Component Test Runner. Fixes #15899.Running specs on Windows is now supported in the Component Test Runner. Fixes #15842.
Fixed an issue where crashes in Cypress would cause a misleading "Unknown signal: true" error after the actual crash message. Fixes #15943.
Fixed an issue introduced in 7.0.0 where requests with responses stubbed via
cy.intercept(routeMatcher, staticResponse)would still be sent to the destination server. Fixes #15841.
7.0.2
7 Nov 20257.0.1
19 Aug 2025Fixed a regression in 7.0.0 that caused the test runner not to check for updates. Fixes #15829.
The component testing spec list search input no longer throws an exception when hitting
Enter. Addressed in #15833.The preferred file opener modal no longer appears behind the command log. Addressed in #15831.
Released 04/07/2021
Bugfixes:
Fixed a regression in 7.0.0 that caused the test runner not to check for updates. Fixes #15829.
The component testing spec list search input no longer throws an exception when hitting
Enter. Addressed in #15833.The preferred file opener modal no longer appears behind the command log. Addressed in #15831.
Cypress no longer crashes in certain circumstances when running in Docker without
--ipc=host. Fixes #15814 and #350.Node.js warnings are no longer incorrectly printed to
stderrin production builds of Cypress. Addressed in #15817.Cypress no longer prints a warning to
stdoutwhen the video cannot be found after a run. Addressed in #15828.A warning is no longer displayed when running a TypeScript spec without a
tsconfig.jsonfile present. Addressed in #15828.
Misc:
The "New Spec File" in the Desktop GUI has a less pronounced style. Addressed in #15835.
7.0.0
8 Aug 2025- Breaking
Installing Cypress on your system now requires Node.js 12+. Addresses #9545.
We introduced several breaking changes to cy.intercept(). See the cy.intercept() docs for full usage examples. Breaking changes:
Component tests have been migrated to use a dedicated test runner and are bundled differently. See the Migration Guide for full examples on how to migrate. Addressed in #14479.
Released 04/05/2021
Summary:
🎉 Introducing the Cypress Component Test Runner - now in alpha. Today's release includes a brand new test runner designed to replace your Node-based component tests. Our Component Test Runner tests your components in the browser, just like a user would. And, since it runs in the browser, you get to debug your components using your favorite developer tools. Read our Component Testing Guide for more details.
Breaking Changes:
<Icon name="exclamation-triangle" color="red"></Icon> Please read our Migration Guide which explains the changes in more detail and how to change your code to migrate to Cypress 7.0.
We introduced several breaking changes to cy.intercept(). See the cy.intercept() docs for full usage examples. Breaking changes:
Request handlers supplied to
cy.intercept()are now matched starting with the most recently defined request interceptor. This allows users to override request handlers by callingcy.intercept()again. This matches the previous behavior that was default incy.route(). Addresses #9302.cy.intercept()now automatically parses more JSON MIME types, including 'application/vnd.api+json'. You can now removeJSON.parse(req.body)orJSON.parse(res.body)from some tests that previously required it. Addresses #14763.Falsy values (with the exception of
undefined) supplied as the body of aStaticResponsetocy.intercept()will now be JSONified and sent as the body. Previously, an empty string was sent instead. Addresses #15234 and #14205.The
matchUrlAgainstPathRouteMatcherproperty has been removed fromcy.intercept().The "substring match" from
cy.intercept()URL matching has been removed. Previously, a URL would match if it contained the supplied string anywhere. Now, the URL (including querystring) only matches if it is an equality match or a minimatch.The
delayoption for StaticResponses used withcy.intercept()has been removed. Please go back to using thedelayMSoption. Addresses #15255.cy.route2()was previously aliased tocy.intercept(). Now the aliascy.route2()has been removed. Please update usage ofcy.route2()tocy.intercept(). Addressed in #14709.
Component tests have been migrated to use a dedicated test runner and are bundled differently. See the Migration Guide for full examples on how to migrate. Addressed in #14479.
Component tests will not be executed when running
cypress openorcypress run. Now, they need to be executed by runningcypress open-ctorcypress run-ct. Addressed in #15701.experimentalComponentTestingmust be removed from yoru configuration file,cypress.jsonby default, or it will throw an error. Addressed in #15701.The
file:preprocessorevent is no longer used to compile component tests. Now, adev-server:startevent must be registered.
Cypress now catches uncaught errors and fails the test even if the application under test has defined
window.onerror. Addresses #8802.Cypress now fails tests if there is an unhandled promise rejection in the application under test. Unhandled rejections will trigger the
uncaught:exceptionevent with the promise as the third argument. Addresses #243.Cypress now throws an error if the application under test redirects more than 20 times. The number of times allowed to redirect is configurable via the
redirectionLimitconfig. Addresses #14445.The default preprocessor now targets a more modern version of ECMAScript. Addressed in #15274.
We now enable
contextIsolationby default in the Electron browser. You can override this option if needed within thebefore:browser:launchAPI. Addressed in #15493.Cypress.moment()has been removed. Please migrate to a different datetime formatter. See our recipe for example replacements. Addresses #8714.The bundled Node.js version was upgraded from
12.18.3to14.16.0. This could change the behavior of code within thepluginsFilewhen using the bundled Node.js version of Cypress. Addressed in #15292.- Breaking
Installing Cypress on your system now requires Node.js 12+. Addresses #9545.
The default headless browser window size has been increased to 1920x1080 pixels to capture High-definition videos and screenshots. Addresses #15752, #15730, and #15481.
Features:
A command log entry is now displayed when there is an uncaught exception or unhandled rejection. Addresses #8236.
We added several features to cy.intercept(). See the cy.intercept() docs for full usage examples. Addressed in #14543. New features:
There are new events on the req object for
cy.intercept()includingbefore:response,response, andafter:response.Response handlers (supplied via event handlers or via
req.continue(cb)) supplied tocy.intercept()will be called in reverse order untilres.sendis called or until there are no more response handlers.A new option,
middleware, has been added to theRouteMatchertype. If true, the supplied request handler will be called before any non-middleware request handlers.A new function,
req.continue(cb), is available on request objects yielded bycy.intercept(). It is functionally the same asreq.reply(cb)- the request will stop propagating to other event handlers, will be sent outgoing, and the response will be handled by cb.cy.intercept()can now be called with a new overload:cy.intercept(url, routeMatcher, handler).routeMatcherwill be merged withurl, and the handler is required.
cy.visit()can now visit pages withapplication/xhtml*content-type. Addresses #15738.You can now pass runner specific configuration in order to pass different configuration values to
componenttests versuse2etests. Addressed in #15526.There's a new keyboard shortcut (
ctrl/cmd + f) to search spec files in the Test Runner based on your OS. Addresses #6229.You can now create a new spec file directly from the Test Runner in the Desktop. Addressed in #15335.
The Cypress proxy now adds a
keep-aliveheader to all proxy responses. AddressedCypress no longer forces specific
NODE_OPTIONS. Addressed
Bugfixes:
The
response.bodyofcy.intercept()is now correct after stubbing a response usingres.send({ fixture })in areq.continuecallback or abefore:responseorresponsehandler. Addressed in #14543.Fixed an issue where only the first matching alias for a route would yield a response object on
cy.wait(). Fixes #14522..click()will no longer fail with "coordsHistory must be at least 2 sets of coords" when specifying{ multiple: true }. Fixes #3738.Cypress now checks visibility correctly when an element has CSS "position: sticky". Fixes #14938.
After selecting a project in global mode and clicking the back button, Cypress will no longer crash. Fixes #15089.
Errors
Refused to apply styleare gone from the console inopen-ctduring Component Testing. Addressed in #15661.Some memory leaks were fixed in
@cypress/vue. Addressed in #15275.
Misc:
The types for
set-cookieallowstring, so the header's type has been changed to reflect this. Addresses #15419.The type definition for
cy.writeFile()now allows 4 arguments. Addresses #15353..then()will show the correct type when raw HTMLElements are provided. Addresses #14875The Cypress Studio icon now displays properly for tests with long titles. Addresses #15182.
There were some minor improvements made to the UI when setting up a project in the Test Runner. Addressed in #15665.
Dependency Updates
- 6.x
6.0.1
26 Dec 2023Chromium based browsers on version 87 will no longer show recorded videos as frozen or blank. Fixes #9265.
cy.screenshot()no longer throws an"offset" is out of rangeerror when Cypress attempts to crop the image. Fixes #2034.
Released 11/30/2020
Bugfixes:
Chromium based browsers on version 87 will no longer show recorded videos as frozen or blank. Fixes #9265.
We fixed a regression introduced in 5.0.0 that would cause an
Option 'sourceMap' cannot be specified with option 'inlineSourceMap'error to throw when settingsourceMapin your tsconfig. Fixes #8477.cy.screenshot()no longer throws an"offset" is out of rangeerror when Cypress attempts to crop the image. Fixes #2034.cy.screenshot()types won't mistakenly display the command as deprecated. Fixes #9303.Lower-cased HTTP methods can now be used with
cy.intercept(). Fixes #9313.
6.0.0
29 Aug 2023- Deprecated
cy.server()andcy.route()have been deprecated. In a future release, support forcy.server()andcy.route()will be moved to a plugin. We encourage you to usecy.intercept()instead. Addressed in #9185. - Deprecated
experimentalFetchPolyfillhas been deprecated. We encourage you to usecy.intercept()to intercept requests using the Fetch API instead. Cypress now always throws an error when asserting on an element that doesn't exist in the DOM (unless you're asserting that the element should
not.exist). Assertions such asnot.visible,not.contains,not.have.class, etc will now fail when used on non-existent DOM elements. Addresses #205.
Released 11/23/2020
Summary:
Cypress now offers full network stubbing support with the introduction of the
cy.intercept()command (previouslycy.route2()). Withcy.intercept()your tests can intercept, modify and wait on any type of HTTP request originating from your app.Breaking Changes:
Please read our Migration Guide which explains the changes in more detail and how to change your code to migrate to Cypress 6.0.
Cypress now always throws an error when asserting on an element that doesn't exist in the DOM (unless you're asserting that the element should
not.exist). Assertions such asnot.visible,not.contains,not.have.class, etc will now fail when used on non-existent DOM elements. Addresses #205.DOM elements where the CSS style (or ancestors) are
opacity: 0are no longer considered visible. However these are still considered actionable and "any action commands" interacting-with-elements#Actionability used to interact with the element will perform the action. This matches browser's implementation on how they regard elements withopacity: 0. Addresses #4474.The type yielded by
cy.wait(alias)has changed in order to support use ofcy.intercept(). Addressed in #9266.The
experimentalNetworkStubbingoption has been removed and made the default behavior. You can safely removed this configuration option. Addressed in #9185.When using
.type()and.click()on elements inside acontenteditableelement, the events are now properly triggered on the inside elements. This may cause unintended consequences if you were relying on the previous behavior. Addressed in #9066.We removed several deprecation errors around APIs that were removed in versions of Cypress prior to 4.0.0. This will not cause any changes for anyone upgrading from a 4.0+ version of Cypress. For a full list of all APIs affected see #8946.
We updated our HTTP status codes and reason phrases to match Node.js
http.STATUS_CODES. If you have code that relies on a reason phrase, then this could affect you. Addressed in #8969.JSON request and response bodies captured by
cy.intercept()are now automatically parsed, removing the need to manually doJSON.parse. Addressed in #9280.
Deprecations:
Deprecations still work as before but will be removed from Cypress in a future release. We encourage you to update your code now to remove uses of deprecations.
- Deprecated
cy.server()andcy.route()have been deprecated. In a future release, support forcy.server()andcy.route()will be moved to a plugin. We encourage you to usecy.intercept()instead. Addressed in #9185. - Deprecated
experimentalFetchPolyfillhas been deprecated. We encourage you to usecy.intercept()to intercept requests using the Fetch API instead. cy.route2()was renamed tocy.intercept(). We encourage you to update usages ofcy.route2()to usecy.intercept(). Addressed in #9182.
Features:
The new
cy.intercept()command can be used to manage the behavior of HTTP requests at the network layer. Addressed in #9182.We now pass
—disable-dev-shm-usageto the Chrome browser flags by default. This will write shared memory files into/tmpinstead of/dev/shm. If you're passing this flag in yourpluginsfile, you can now remove this code. Addresses #5336.A warning is now displayed when passing invalid configuration keys through the CLI. Addresses #428.
The
cypress versioncommand now also displays the current Electron and bundled Node versions. Addresses #9180.The
cypress versioncommand now accepts a--componentflag that allows you to print the version of specific components of Cypress. ie Electron, Node, etc. Addresses #9214.
Bugfixes:
We fixed a regression introduced in 3.5.0 that would cause
.type()to not type the entire string when focus was called away from the target element. Fixes #9254..type()and.click()now properly work on elements inside acontenteditableelement. Fixes #2717 and #7721.We fixed a regression introduced in 5.6.0 that would cause the Test Runner to crashes and display a white page when switching tabs while tests are running. Fixes #9151.
Fixed an issue where
Content-Lengthforcy.route2request bodies could be incorrectly recalculated. Fixes #9166.
Documentation Changes:
Our Migration Guide has a new section for 6.0 migration.
Many of our docs examples have been updated to use
cy.intercept()in place ofcy.route()including our Network Requests doc.
Misc:
Added the type of
redirectsand changedredirectedToUrloptional for Response types. Addresses #9275.
Dependency Updates
- 5.x
5.7.0 – 5.17.127 releases without a noteShow each
- 5.17.11 May 2023no note
- 5.17.015 Feb 2023no note
- 5.16.36 Feb 2023no note
- 5.16.22 Feb 2023no note
- 5.16.129 Dec 2022no note
- 5.16.019 Dec 2022no note
- 5.15.79 Dec 2022no note
- 5.15.62 Dec 2022no note
- 5.15.510 Nov 2022no note
- 5.15.47 Nov 2022no note
- 5.15.32 Nov 2022no note
- 5.15.21 Nov 2022no note
- 5.15.131 Oct 2022no note
- 5.15.019 Oct 2022no note
- 5.14.04 Oct 2022no note
- 5.13.14 Oct 2022no note
- 5.13.029 Sep 2022no note
- 5.12.215 Aug 2022no note
- 5.12.111 Aug 2022no note
- 5.12.01 Jun 2022no note
- 5.11.18 Feb 2022no note
- 5.11.016 Dec 2021no note
- 5.10.010 Nov 2021no note
- 5.9.124 Jun 2021no note
- 5.9.026 May 2021no note
- 5.8.013 May 2021no note
- 5.7.05 Apr 2021no note
5.6.0
16 Feb 2021You can now dynamically add aliases for requests intercepted via
cy.route2(). See an example. Addresses #387.You can now run all integration specs or all component specs separately (or a filtered list of specs) by clicking the appropriate button in the Test Runner in the Tests tab. Addresses #8203.
Released 11/09/2020
Features:
You can now dynamically add aliases for requests intercepted via
cy.route2(). See an example. Addresses #387.You can now run all integration specs or all component specs separately (or a filtered list of specs) by clicking the appropriate button in the Test Runner in the Tests tab. Addresses #8203.
Added a new modifier syntax to
cy.type(). You can now type shortcuts like{ctrl+z}. Addressed in #5694.We now show a modal with release notes when available when there is a new version of Cypress. Addressed in #9006.
In the Test Runner's Settings and Runs tab you can now quickly copy the project id configuration and record key using a copy to clipboard icon. Addresses #9002.
Bugfixes:
Fixed a regression introduced in 4.12.0 where snapshotting caused images to load too many times. Fixes #8679.
Using
cy.visit()on sites withcontent-typeoftext-htmlfollowed by parameters (liketext/html;charset=utf-8) will no longer throw an error about visiting a site with an invalid content-type. Fixes #8506The
Cannot access 'continueSent' before initializationerror will no longer throw when usingcy.route2(). Fixes #8926.Awaiting a request body when providing a static response stub in
cy.route2()should now work properly. Addressed in #9059.The way that intercepted
cy.route2()requests are displayed in the Command Log has been improved, including showing the progress bar correctly. Addresses #9053.The
Cannot read property 'replace' of undefinederror will no longer throw when attempting to generate the stack trace from an error thrown in the application. Fixes #7915.Stack traces in the Command Log originating from application errors where the location is unavailable will no longer show as a clickable link to open in IDE. Fixes #9106.
When using the
fixture:prefix as a stubbed response tocy.route(), JSON fixtures containing only a number or boolean will no longer throw an error. Fixes #4899.Fixed an issue causing failed subresource integrity checks for external scripts. Fixes #8983, #9049, and #8992.
Misc:
Typings for
.invoke()and.its()now allow for atimeoutoption. Addresses #9079.Typings for
cy.task()now allow for parameterizing the task return type. Addresses #7136.A clearer error is printed during
cypress cache listwhen no cached versions are found. Addresses #6303.
Dependency Updates:
Upgraded
commanderfrom^4.1.1to^5.1.0. Addressed in #8979.Upgraded
semverfrom6.3.0to7.3.2. Addressed in #9068.Upgraded
systeminformationfrom4.26.9to4.27.11. Addressed in #8979.Removed
node-webkit-updater. This should remove some security warnings that were shown during install. Addresses #8314.
5.5.0
30 Nov 2020cy.viewport()has a newmacbook-16preset. Addresses #8889.Updated the Cypress proxy layer to proxy HTTPS traffic from non-AUT origins. Addressed in #8827.
Released 10/26/2020
Features:
cy.viewport()has a newmacbook-16preset. Addresses #8889..type()now fires thebeforeInputevent during typing. Note: Firefox does not support thebeforeinputevent. Addresses #7088.
Bugfixes:
Updated the Cypress proxy layer to proxy HTTPS traffic from non-AUT origins. Addressed in #8827.
This fixed an issue with
cy.route2where HTTPS requests to a non-AUT origin would not be intercepted as expected.
cy.route2()now properly handles passing a method as its first argument. Fixes #8729.Fixed an issue with
cy.route2()where a "Cannot set property response of undefined" error would occasionally occur. Fixes #8858.Headers field names passed to [`cy.route2()](on.cypress.io/route2) now case-insensitively match against the field names of incoming HTTP requests. Fixes #8921.
Routes that stub fixtures for binary resources (including images) made with
cy.route2()now serve the correct mime-type and content. Fixes #8623.When
experimentalNetworkStubbingis enabled, usingcy.visit()to URLs that redirect and set Transfer-Encoding: chunked will no longer fail in Cypress with a "Parse Error". Fixes #8497.cypress.run()through the Module API now has astatusproperty in the results matching the correct CLI types ("failed"or"finished"). Addresses #8798.When a value containing an
echaracter is passed to the--ci-build-idflag, Cypress now properly reads it as a string. Fixes #8874.
Misc:
Updated type definitions to allow for passed either
runModeoropenModetoretriesalone. Addresses #8869.
Dependency Updates:
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.