cypress

Changelog: https://docs.cypress.io/guides/references/changelog#11-0-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-11-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-10-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-9-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-8-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-7-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-6-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-5-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-4-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-3-1

Changelog: https://docs.cypress.io/guides/references/changelog#10-3-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-2-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-1-0

Changelog: https://docs.cypress.io/guides/references/changelog#10-0-3

Changelog: https://docs.cypress.io/guides/references/changelog#10-0-2

Changelog: https://docs.cypress.io/guides/references/changelog#10-0-1

Changelog: https://docs.cypress.io/guides/references/changelog#10-0-0

Released 5/23/2022

Features:

• The Electron version and shipped Chromium browser version has been updated. Addressed in #21418.

Deprecations:

• The Cypress.Cookies.preserveOnce() and Cypress.Cookies.defaults() Cypress APIs have been deprecated. In a future release, support for Cypress.Cookies.preserveOnce() and Cypress.Cookies.defaults() will be removed. Consider using the experimental cy.session() command instead to cache and restore cookies and other sessions details between tests. Fixed #21333.

Bugfixes:

• Updated the cy.contains() command to correctly error and retry if the provided regex pattern begins with an equal sign and a match was not initially found. Previously the command would incorrectly fail with a syntax error. Fixed #21108.
• Corrected the cy.session() command log grouping and validation verbiage. This change provides better insights to logs associated with the command. Fixed #21377.
• Removed eventemitter2 third-party type definitions from cy and Cypress that were unintentionally exposed. Fixed #20556.

Dependency Updates:

• Upgraded the bundled node version shipped with Cypress from 16.5.0 to 16.13.2. Addressed in #21418.
• Upgraded the Chromium browser version used during cypress run and when selecting Electron browser in cypress open from 94.0.4606.81 to 100.0.4896.75. Addressed in #21418.
• Upgraded electron dependency from 15.5.1 to 18.0.4. Addressed in #21418.

Released 5/9/2022

Bugfixes:

• Cypress can now launch on systems where Firefox is installed via Snapcraft. Fixed #19793.
• Updates were made to ensure XHR calls are properly displaying the response body in the command log. Fixed #21361.
• Fixed cy.contains() and .should('contain', ...) to handle finding text that contains backslash characters. Fixed #19116
• Updated .type('{enter}') to support sending the Enter keystroke to submit buttons that are not rendered within a form html element, but are associated with a form via the form attribute. Fixed #21163.
• Fixed an issue with cy.session() such that re-running tests in open mode will now correctly recreate a session. Before this change, an error was thrown indicating the saved setup function was not a function because it was serialized. Fixed #17805.

Released 4/25/2022

Features:

• Now you can easily test multi-domain workflows by using the experimental cy.origin() command. This feature allows you to test across different origins or domains within a single test. This experiment was designed to work side-by-side with the cy.session() experimental feature. You can turn on use of this command by setting the experimentalSessionAndOrigin configuration option to true. For more details, read our blog post. Addressed #17336 and #944.
  • Added a new configuration option called experimentalSessionAndOrigin. This option enables support for cy.session() and cy.origin().
  • The experimentalSessionSupport configuration option has been removed and replaced by the experimentalSessionAndOrigin configuration option. Please update your configuration to use the new experimentalSessionAndOrigin option to continue to opt-in to this experimental feature.
  • When experimentalSessionAndOrigin is enabled, cross-origin requests will no longer immediately fail, but instead, time out based on the pageLoadTimeout configuration. This allows the request to be appropriately handled by the cy.origin() command.
  • When experimentalSessionAndOrigin is enabled, Cypress will no longer wait on page loads between hooks before moving on to the next test.

Bugfixes:

• Fixed an issue with Firefox 98+ where the Enter keystroke was not being sent to an input element when using .type('{enter}'). Fixed #21033.
• We now verify if an interruption while running tests was signaled by the user or if it came from an error in a plugin before showing the error message. Fixed #21010.
• Improved the error message observed on Windows platforms when unzipping the Cypress binary and the max file length is exceeded. Fixed in #21047.
• Updated the Cypress.Commands.add() TypeScript types to better reflect the attributes of the .add() utility and the JQuery element, a possible previous subject type. #20376.

Dependency Updates:

• Upgraded electron dependency from 15.3.5 to 15.5.1 to consume fixes related to improve performance on macOS Big Sur and later. Addressed #21068.

Released 4/11/2022

Bugfixes:

• Updates were made to silence Electron warnings related to being unable to connect to dbus. These errors are normal and expected, and do not result in test failures. Because they are always present when running Electron inside docker containers, it has incorrectly led people to believe it is the root-cause of an error within their test run. By silencing these errors, it will improve the debug experience to allow users to focus on meaningful warning and error messages. Fixed #19299.
• Updates were made to ensure that all *.enable events are sent if Cypress becomes disconnected from the Chrome DevTools Protocol and must re-establish a connection to ensure all command logs are displayed to the user. This fixes an issue where some command logs, like download or network events, are missing once Cypress has disconnected and then reconnected to the Chrome DevTools Protocol. Fixed #20618.
• Fixed an issue where cy.type('{enter}') was not sending the Enter key for Firefox v98+. This was not an issue with Firefox v97 and below. Fixed #20562.
• Fixed a regression in 9.3.0 where glob patterns provided to the --spec CLI parameter was incorrectly splitting the patterns in unexpected places when it should have split on commas. Fixes #20794.
• Fixed an issue with cy.root() to respect the timeout option passed to the command. Previously, when the timeout option was provided, it was ignored and the default timeout was used. Fixed #19985.
• Updates were made to decrease the length of the Cypress cache path for Windows to ensure installing pre-release versions of the Cypress binary are within the maximum path length of 260 characters. Fixed in #20961.
• Fixed a regression in 8.6.0 which prevented .pause() from correctly executing when passing the --headed --no-exit CLI flags to cypress run. Fixed #20745.
• Fixed a regression in 9.2.0 which would sometimes throw an expected error on navigation with cy.back() and cy.go(). Fixed #19749 and #20539.
• Corrected the Typescript type for a cookie which was incorrectly typed as any when the correct type is Cookie. Fixed in #20513.
• Added the missing Cypress.Command.addAll() Typescript types. Fixed #18886.
• Fixed an uncommon error observed in cy.session() where an error was thrown when no cookies had been set for the session and the user clicks the session command log to view additional details in the DevTools console. Fixed in #20946.

Misc:

• A minor visual update was made to the cy.session() command log visuals. Fixed #20433.

Dependency Updates:

• Upgraded ansi-regex dependency from 4.1.0 to 4.1.1 to address the CVE-2021-3807 NVD security vulnerability. Addressed in #20807.
• Upgraded plist dependency from 3.0.4 to 3.0.5 to address the CVE-2022-22912 NVD security vulnerability. Addressed in #20808.

Released 3/28/2022

Bugfixes:

• Corrected a logging issue with cy.intercept() where the response status code and response body were sometimes missing from the log details in open mode. Fixed #18757.
• Fixed an issue in cy.readFile() where the command would not retry or provide a meaningful error message if null encoding was used and the file was not found. Fixed #20683.
• Updated the Cypress Keyboard shortcuts to only run the shortcut when the pressed shortcut key was not used in conjunction with either the alt, ctrl, or shift modifier keys. This fixed an issue where the Cypress shortcut handler would override the browser native keyboard shortcut for search (ctrl + f). Fixed #20222.
• Updates were made to correctly escape dollar signs in the CYPRESS_DOWNLOAD_PATH_TEMPLATE environment variable. Issues were seen utilizing this template when the env was provided from a package manager file. Fixed #19914.
• Fix the Cypress.Buffer TypeScript type to reference the static constructor of Buffer, instead of incorrectly referencing the Buffer instance which caused Type errors. Fixes #20542.

Dependency Updates:

• Upgraded electron dependency from 15.3.4 to 15.3.5 to address the CVE-2022-21718 NVD security vulnerability. Addressed in #20750.
• Upgraded minimist dependency from 1.2.5 to 1.2.6. Addressed in #20756.
• Upgraded nanoid dependency from 3.1.20 to 3.1.31 to address the CVE-2021-23566 NVD security vulnerability. Addressed in #20726.
• Upgraded node-forge dependency from 1.0.0 to 1.3.0 to address the CVE-2022-24771 NVD security vulnerability. Addressed in #20727.

Released 3/14/2022

Bugfixes:

• Fixed an issue with .type() where click events could be fired on the incorrect target element because the target focus changed within a key-down event handler callback. Fixed in #20525.
• Fixed a regression in 9.5.0 where ANSI colors were not removed from the FireFox warning message about the chromeWebSecurity configuration option having no effect on the Firefox browser. Fixes #20496.
• Updates were made to the pre-release build setup such that Cypress will use a unique cache folder for each pre-release installation on a machine. This removes the need to run cypress clear cache before installing a new pre-release version of Cypress or before installing a new released version of Cypress after a pre-release version had been installed. Addressed in #20296.

Misc:

• Updates were made to explicitly disable the Origin-Agent-Cluster header for proxied responses to ensure document.domain can continue to be set with Chrome v106+. This was necessary because Chrome is planning to make document.domain immutable in v106+ to relax the same-origin policy by interpreting the Origin-Agent-Cluster as true, whereas it is currently interpreted as false. Addresses #20147.

Dependency Updates:

• Upgraded url-parse dependency from 1.5.6 to 1.5.9 to address these NVD security vulnerabilities, CVE-2022-0639, CVE-2022-0686 and CVE-2022-0691. Addressed in #20386 and #20439.

Released 2/28/2022

Bugfixes:

• Added a ready event to the Plugins process to ensure all plugins have successfully started before the configuration is loaded and the tests start. Fixed in #19792.
  • This fixes an issue where the plugin is never executed and leaves Cypress stuck in the initialization phase, where the user can only view the loading spinner.
  • This enables support for node's experimental --loader flag for plugins.
• Made a change to the DNS lookup to improve test performances and reliability on MacOS machines that leverage the VMWare CBCloud SaaS solution. Before this change, random test failures were observed, as well as hanging tests and initially pending HTTP and HTTPS responses. Fixed in #20062.
• Fixed a regression in 9.5.0 where ANSI colors were not removed from the cy.fixtures() error code frame. Fixes #20208.
• Fixed a regression in 9.5.0 where the test config override errors were formatted incorrectly. Fixes #20208.
• Fixed an issue where Cypress would throw an error when reporting or wrapping errors with booleans or numbers. Fixes #19561.

Dependency Updates:

• Upgraded url-parse dependency from 1.5.2 to 1.5.6 to avoid authorization bypass through user-controlled key to address this NVD security vulnerability. Addressed in #20270.

Released 2/15/2022

Features:

• Enhancements were made to the error experience in both run mode and open mode to improve readability and provide meaningful stack traces. Addressed in #20124.
• Updated the cy.request() log message to hide the origin when it matched the browser origin to make debugging easier. This reduces the length of the log message that could be partially hidden if a long url is requested. Addressed in #20009.
• Updates were made to log the ShadowRoot and Document elements as HTML elements. Previously these would be logged as enumerated objects, which were difficult to evaluate. Addressed in #20049.
• Updated the terminal output generated in Cypress run mode to de-emphasis the node path in the run header. Addressed in #20120.

Bugfixes:

• Fixed an issue where files attached during .selectFile() could have the wrong File prototype. Fixes #20003.
• Updated .select() to only dispatch the change and input events when the selected option is not the currently selected option. This change aligns .select() with the browser. Fixes #19494.
• Updated .type(' ') to align with the W3C standards where a click event should be dispatched when the Space key is pressed and the current focus is on a state-changing element with type button, image, submit or reset. Fixes #20067.

Released 1/31/2022

Bugfixes:

• Fixed a regression in 9.4.0 where the line endings in the public NPM package prevented some users from running Cypress. Fixes #19986.

Released 1/31/2022

Features

• Enhancements were made to .selectFile() after receiving feedback after its initial release in 9.3.0.
  • The default behavior was updated to automatically infer the mime type of files based on their extension to correctly encode file uploads. Addressed in #19751.
  • Added the mimeType property so you can explicitly set the mime type on files using the mimeType property. Addressed in #19751.
  • Updated file contents types to allow either a TypedArray instance or a Cypress.Buffer instance, where previously file contents were expected to only be an instance of Cypress.Buffer. Addressed in #19751.
  • Updated .selectFile() to retain the fileName of files read from disk to work with aliases. Addressed in #19803.

Bugfixes:

• Fixed a regression in 9.3.0 to correctly parse the --spec CLI parameter for glob patterns containing a range. Fixes #19783.
• Fixed regression in 9.2.1 where the --openssl-legacy-provider flag was not being passed to the plugins' child process when the user's system Node version was Node 17+ built with OpenSSL v3+ which resulted in Cypress crashing when trying to run tests. Fixes #19712.
• Update cy.type('{enter}') to align with the W3C standards where a click event should be dispatched when the Enter key is pressed and the current focus is on astate-changing element with type button, image, submit or reset. Fixes #19541.

Released 1/19/2022

Bugfixes:

• Fixed an issue where the bin file was released with windows line breaks. Fixes #19747.

Released 1/18/2022

Features:

• Added a new Cypress command, called .selectFile(), to select a file or files in an HTML5 input element or simulate dragging a file or files into the browser. The API is similar to cypress-file-upload and we have provided a migration guide for previous users of that plugin. For more details, see our blog post. Fixes #19524 and #170.
• Exposed the Buffer polyfill, as Cypress.Buffer, to enable working with binary data. Addressed in #19524.
• Added the CYPRESS_DOWNLOAD_PATH_TEMPLATE environment variable which can be set to a string template for building the download URL for the Cypress binary. This environment variable is useful for users who are downloading the Cypress binary from a proxy that is not one-to-one with the Cypress's default download url. More information can be found in the Install Binary documentation. Fixes #15697.

Bugfixes:

• Fixed an issue where the --spec CLI parameter was not working properly when passing multiple glob patterns that are separated by commas. Fixes #16102.
• Fixed an issue with how the CYPRESS_VERIFY_TIMEOUT environment variable was read so it can set in a project's package.json or it's .npmrc. Fixes #19559.

Dependency Updates:

• Upgraded graceful-fs from 4.2.0 to 4.2.9. This upgrade resolves issues observed with using graceful-fs v4.2.0 with resolve v1.21+. Addressed in #19676 and resolves #19610.
  • NOTE: This upgrade to graceful-fs breaks Cypress's compatibility with Yarn 2. We have observed errors with Yarn 2.4.2 with graceful-fs 4.2.9. Before this change, Cypress had minimal Yarn 2 support (see #6377). Between Yarn 3 fixing multiple bugs and the migration path from Yarn 2 to Yarn 3 being minimal, we felt the best step forward was to support and recommend Yarn 3 over Yarn 2.
• Upgraded electron from 15.2.0 to 15.3.4. Addressed in #19351.

Released 1/10/2022

Bugfixes:

• Fixed a regression in 9.2.0 to keep Cypress open after each spec finishes when the --headed --no-exit flags are passed to cypress run. Fixes #19485.
• Improve heuristic for verifying when the --openssl-legacy-provider option should be passed to the plugins' child process when the system Node version is v17+. This prevents Cypress from crashing when a user has Node 17 installed which was built with OpenSSL v1. Fixes #19320.
• Correctly cast the CYPRESS_VERIFY_TIMEOUT environment variable as a number so Cypress will no longer throw TypeError: Expected the timeout option to be a non-negative integer. Fixes #19476.

Dependency Updates:

• Update pinned resolution of cli-table3 from ~0.6.0 to ~0.6.1 to avoid problems with the bug introduced in the colors.js v1.4.44-liberty-2 release. Addresses #19624.

Released 12/20/2021

Features:

• Cypress will throw an error when a user attempts to update a configuration value at run-time using either the Test Configuration or using Cypress.config() that is a readonly option. Addresses #6407 and #19001.
• A timeout option has been added to the cy.writeFile() command, with a default value of defaultCommandTimeout. Addresses #3350.
• The default maxHttpBufferSize for the internal socket server has been increased to Node's maximum Buffer size (size varies by OS) to allow large file writes with cy.writeFile(). Addresses #19140.
• Add CYPRESS_VERIFY_TIMEOUT environment variable to override the timeout duration of the verify command. Addresses #18290.

Bugfixes:

• Prevent unnecessary snapshotting when running default assertions that would unnecessarily increase CPU use in cypress open mode which lead to out of memory crashes on certain browsers. Fixes #18549.
• Removed automatic retries for failed HTTP requests through the proxy. This fixes an issue where failed requests could be re-sent too many times in some conditions. This change could increase the number of failed requests that your app sees. Fixes #19043.
• Reduced the occurrence of an issue where logs for fetch and xhr requests could be associated with the wrong request. Fixes #19043.
• Tests that are skipped within then blocks will no longer throw errors causing the test to fail. Tests that are skipped outside of then blocks will no longer trigger the fail event. This will prevent screenshots from happening from errors thrown by the fail event.Fixes #14867 and #17660.
• Fixed a regression in 9.0.0 where a fixture provided in a static response to cy.intercept() did not support passing null to encoding to read the fixture as a Buffer. This identified an undocumented 9.0.0 Breaking Change where the default read behavior of a fixture changed from a Buffer to being read with utf8 encoding. Fixes #19344.
• Fixed a regression in 9.0.0 where cy.contains() attempted to ignore <script> and <style> elements found within <body>. by deleting them from the dom. This behavior was corrected to ignore the elements without deleting them. Fixes #19377.
• Cypress will no longer crash when proxying an ill formed request. For example, if the application under test has a resource of "http: //localhost/asset.js" (notice the extraneous space), Cypress will now log a debug message and the asset will fail to load. Fixes #9220.
• Correct Cypress.Command.add() and Cypress.Command.override() TypeScript types. Fixes #18879, #19095 and #18940.
  • Custom command implementations typings take into account prevSubject variants.
  • Custom command implementations now allows to NOT return a value.
  • Custom command overwrites typings take into account originalFn function.
• Add types for Cypress.session.clearAllSavedSessions(). Fixes #19363.

Dependencies:

• Upgraded ssri from 6.0.1 to 6.0.2 to mitigate ssri vulnerability. Addressed in #19351.

Released 12/03/2021

Bugfixes:

• Fixed a regression in 9.1.0 where our built binary didn't contain patches to some dependencies. Addressed in #19239. This fixed some issues including:
  • Requests containing ~ will no longer be improperly encoded. Fixes #19083, #19084, #19115, #19096, #19178.
  • A TypeError displaying data.hasOwnProperty is not a function will no longer throw in some situations. Fixes #19091.
  • Empty extra hooks will no longer be sent as data when recording to the Dashboard. Fixes #19087.
  • The Runner hanging when baseUrl is set to null to load a local file. Fixes #19105
• When using the default configuration of "nodeVersion": "system" with an installed system node >=17, Cypress will now work properly rather than throw an error incorrectly pointing to the user's plugin file. Fixes #18914.
• Shadow DOM elements no longer error as hidden during actionability when the element is covered by its parent shadow root. Fixes #18008.
• When using .type() events now correctly propagate out of the shadow DOM. Fixes #17531.
• The this context is now properly preserved when overwriting cy.clock(). Fixes #19158.

Dependencies:

• Upgraded @cypress/request from 2.88.7 to 2.88.10. Addressed in #19099.

Released 11/22/2021

Features:

• A CYPRESS environment variable will be set to true in child processes where Cypress runs user code in Node.js. You can now detect that you're running in Cypress by looking for process.env.CYPRESS. Addresses #18805.

Bugfixes:

• Specs with % in the filename will no longer fail to load and now behave as any other spec. Fixes #18871.
• When using the Selector Playground, the HTML attribute's value will be wrapped in double-quotes. Fixes #1884.
• The call count is now shown in the Command Log when using cy.stub().log(false). Fixes #18907.
• The warning message for retrying connection to a browser has been improved to indicate when it is still waiting. Fixes #18644.
• Cypress commands that rely on this context now have access to this when overridden. Fixes #18899.

Released 11/10/2021

Breaking Changes:

• The nodeVersion configuration option now defaults to system. The behavior of the system option has changed to always use the Node.js binary/version that launched Cypress. If Cypress was not launched via the terminal, Cypress will use the bundled Node.js version. This could change the behavior of code within your pluginsFile since it may be run in your system Node.js version. Addresses #18684.
• Windows 32-bit is no longer supported in Cypress. Addresses #17962.
• An error will now be thrown if an invalid value is passed to Cypress.config. Previously invalid values were ignored and could cause unexpected behavior. Addresses #18589.
• cy.contains() no longer yields the <body> element when it matches the content of <script> or <style> tags. Addresses #14861.
• Attempting to add an existing built-in Cypress command using Cypress.Commands.add() will now throw an error, indicating that Cypress.Commands.overwrite() should be used instead to overwrite the behavior of existing commands. Addresses #18572.
• Custom command implementations are now typed based on the declared custom chainables. Addresses #17496.
• The bundled Node.js version was upgraded from 14.17.0 to 16.5.0. This could change the behavior of code within the pluginsFile when using the bundled Node.js version of Cypress. Addressed in #18317.

Deprecations:

• The nodeVersion configuration option has been deprecated and will be removed in a future release.

Features:

• When null is passed as the encoding to cy.readFile() or cy.fixture(), the file is treated as binary and read as a Buffer. Similarly, null passed as the encoding to cy.writeFile() allows direct writing of buffers. If the encoding is unspecified, the default remains utf8, matching the current behavior. Addresses #18534.

Bugfixes:

• Sticky elements within a fixed container will now be able to be properly scrolled to during action commands. Fixes #4233.
• document.referrer will now correctly reflect the correct value from the application under test after cy.visit(). Fixes #4295.

Dependencies:

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 91 to 94. Addressed in #15292.
• Upgraded bundled Node.js version from 14.17.0 to 16.5.0. Addressed in #15292.
• Upgraded electron from 14.1.0 to 15.2.0. Addressed in #15292.

Released 10/25/2021

Features:

• There are changes to how "slow" tests are determined and displayed in Cypress. Addresses #18496.
  • Added a slowTestThreshold configuration option to customize when tests are considered "slow" during cypress run. A test that runs slower than the given threshold will display in orange text in the default 'spec' reporter. This configuration can be set in your Cypress config file or via specific test configuration.
  • The default slow test threshold was changed from 75ms (Mocha's default) to 10000ms for e2e tests and 250ms for component tests. To restore the old behavior, you can add "slowTestThreshold": 75 to your Cypress config file.
  • All tests will show the time the test ran in milliseconds during cypress run with the default 'spec' reporter.
• Users can pass an overwrite: true option to Cypress.Screenshot.defaults to change default behavior to overwrite existing screenshots without having to set overwrite for each cy.screenshot() command. Addresses #7955.

Bugfixes:

• Fixed a regression introduced in 8.6.0 where videos recorded in Electron to the Dashboard were not playable in the Firefox or Safari browser and were not compatible with QuickTime player in MacOS.
• Fixed a regression introduced in 8.6.0 so that the warning about the projectRoot directory not being writeable will now display correctly. Fixes #18485.
• Improved the error message when running Cypress without non-root permissions. Fixes #18445.
• An error now throws when invalid options are passed to the selectorPriority configuration option of Cypress.SelectorPlayground.defaults. Valid values are data-*, id, class, tag, attribute, or nth-child. Fixes #7745.

Dependency Updates:

• Pinned resolution of ua-parser-js to 0.7.24 to avoid dependency resolution to the compromised package versions. Please read the security advisory and take actions advised as soon as possible. Addressed in #18611

Released 10/11/2021

Features:

• cy.screenshot() now accepts overwrite: true as an option to overwrite existing screenshots with the same file name. Addresses #7955.
• cy.select([]) can now be used to clear any selected options in a multi-value select. Addresses #4318.
• Using cy.pause() when using cypress run --headed --no-exit will now pause a test. Addresses #4044.

Bugfixes:

• Fixed a regression introduced in 8.2.0 where certain XMLHttpRequests would not display their response bodies in the DevTools Console when clicked. Fixes #17656.
• Fixed a regression in 8.3.0 where capturing videos in Chrome versions earlier than 89 would result in choppy videos and skipped frames. Fixes #18021.
• Cypress displays the correct error when certain custom error types are thrown within a test. Fixes #18259.
• The Cypress App will no longer crash when passed a --spec: {} from the CLI and instead error when passed an invalid object argument. Fixes #3957.
• Logging a plain object no longer results in the error "Cannot convert object to primitive value". Fixes #18143.

Misc:

• Updated the cy.request() error message when conflicting failOnStatusCode and retryOnStatusCodeFailure options are passed to be clearer. Fixes #18271.

Dependency Updates:

• Upgraded the Chromium browser version used during cypress run and when selecting Electron browser in cypress open from 91.0.4472.164 to 93.0.4577.58.
• Upgraded electron from 13.2.0 to 14.1.0. Addressed in #18318 and #18384.

Released 09/27/2021

Features:

• You can now select an option by index within the .select() command. Addresses #757.
• Cypress now captures the repository URL on Drone CI. Addresses #18210.

Bugfixes:

• The download of Cypress now respects the NO_PROXY environment variable when one is set. Fixes #17702.
• When using a custom config file and setting it up to record to the Dashboard, Cypress now writes the projectId in the custom config file instead of cypress.json. Fixes #5747.

Misc:

• Windows 32-bit has been deprecated and support will be removed in a later release. A deprecation warning will now display when using Cypress in a Windows 32-bit OS. See #17962 for more detail. Addresses #18094.
• Improved the error messages when an invalid argument type is passed to the .select() command. Addressed in #18234.

Released 09/17/2021

Bugfixes:

• Cypress will no longer crash when setting up a project to record to the Dashboard or viewing the runs or record key for a previously set up project. Fixes #18129.
• The branch collected for Drone CI now correctly reflects the source PR branch for showing in the Cypress Dashboard. Fixes #17860.

Released 09/13/2021

Features:

• When the URL contains non-ASCII characters, you can use the new decode option of cy.url() to decode it. Addresses #17399.

Bugfixes:

• Cypress now better handles situations where the extension was installed in a read-only location. Fixes #3852.
• A clearer error message is now thrown for .check() or .uncheck() when there are no matching value attributes found. Fixes#7379.
• Hooks will no longer rerun on unrelated tests in some situations after a domain navigation. Fixes #17705.
• clientCertificate types have been added for the Cypress configuration. Fixes #17799.

Released 08/27/2021

Performance:

• Projects will now open much faster on MacOS Big Sur with improved browser detection performance. Fixes #17773.

Bugfixes:

• Fixed a regression in 8.3.0 where the correct exit code would not be issued during cypress run-ct while running in the Electron browser. Fixes #17752 and #17885.
• Fixed a regression in 8.3.0 where Cypress would cause a SIGSEGV error on Mac when closing the Cypress app opened via cypress open. Fixes #17766.
• The beforeinput event now correctly fires in Firefox during keyboard events. Fixes #17583.

Misc:

• cy.document() typings now allow for the timeout option. Fixes #17695.
• cy.title() typings now allow for the timeout option. Fixes #17781

Dependency Updates:

• Upgraded electron from 13.1.7 to 13.2.0. Addressed in #17772.
• Upgraded @cypress/request from 2.88.5 to 2.88.6. Addresses #17622.

Released 08/16/2021

Features:

• The instructions for recording a run have been updated for some users. Addressed in #17317.

Performance:

• We addressed an issue that increased CPU usage during video recording in Chrome 89+/Electron 12+. Fixes #16152.
• Fixed a regression in 7.2.0 that would cause cy.visit() to take longer to fire its load event in some circumstances. Fixes #16671.

Bugfixes:

• Fixed an issue that could cause intermittent OpenSSL errors when the local CA cert cache becomes corrupted. Fixes #8705.
• Fixed a regression in 7.2.0 causing the menu bar of Cypress to not be clickable in Windows. Fixes #16323.
• res.send of cy.intercept() will no longer override JSON-related content types. Fixes #17084.
• The times option of cy.intercept now works properly with req.reply. Fixes #17139.
• Fixed a regression in 8.0.0 where Cypress would always warn that chromeWebSecurity is set to "false" when it wasn't. Fixes #17614.

Dependency Updates:

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 89 to 91. Addressed in #17408.
• Upgraded bundled Node.js version from 14.6.0 to 14.17.0. Addressed in #17408.
• Upgraded electron from 12.0.0-beta.14 to 13.1.7. Addressed in #17408.
• Upgraded url-parse from 1.5.1 to 1.5.2. Addressed in #17719.

Released 08/04/2021

Features:

• You can now cache and restore cookies, localStorage, and sessionStorage in order to reduce test setup times by using cy.session(). The session API is experimental and can be enabled by setting the experimentalSessionSupport flag to true in your Cypress config. See our blog and the cy.session() doc for more detail.
• The logging experience around HTTP requests has been updated.
  • fetch requests are always displayed in the Command Log, regardless of if experimentalFetchSupport is enabled.
  • Duplicate logs for XHRs, fetches, and cy.intercept() have been consolidated - Fixes #14843.
  • The user experience around the information displayed in the console when clicking on cy.intercept() request logs has been improved.
  • Request logs now indicate if a request has gone to the origin or if it has been stubbed by displaying a filled or empty circle in the request log.
  • Request logs now display information about if the request and/or response was modified by a cy.intercept().
  • The tooltip displayed when mousing over a request log now displays information about the matched cy.intercept()/cy.route() rules.
  • Fixed an issue where pending request logs were not ended between tests. Fixes #14655.
• There's now a Cypress.currentTest property to access name the currently executing test via Cypress.currentTest.title and Cypress.currentTest.titlePath. Addresses #2972.

Bugfixes:

• A "removing cookie failed" error will no longer throw when cookies are cleared in Firefox. Fixes #6375.
• Cypress no longer throws the error "cannot read property split of undefined" in certain circumstances when application errors are thrown. Fixes #17378.
• Cypress now properly runs the final test when nested in a suite with a before hook. Fixes #9026.
• Fixed a regression in 8.0.0 where an error would longer throw when there is no /etc/passwd entry for the current user, such as in some Docker and GitHub Action setups. Fixes #17415.
• Cypress now throws if a function is incorrectly passed as the second argument to cy.wait(). Fixes #17436.

Released 07/29/2021

Features:

• When using experimentalStudio, you can now generate assertions in Cypress Studio by right clicking on an element. Addressed in #16295.
• When searching specs in the Test Runner during end-to-end testing, characters that are not letters will be ignored and don't have to be typed. Addressed in #17346.

Performance:

• The Test Runner's performance has been improved when running a large number of commands within a single test. Fixes #6783.

Bugfixes:

• Add Yarn v2 pnp support to our default webpack processor. Fixes #8008 and #16111.
• When running Cypress in global mode, an error will no longer be thrown when trying to add a new project to the Dashboard. Addressed in #17514.
• The Test Runner will no longer crash in some instances when creating a new spec file from the GUI. #17430.

Released 07/19/2021

Summary:

We've made some updates to ensure a consistent run experience across browsers. Now all browsers run via cypress run run 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 run previous to 8.0, some browsers would launch headed while others were launched headless by default. Cypress now runs all browsers during cypress run as 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 --headless Chrome browser via cypress 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 during cypress run and not allow opening the browser in cypress open when 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 type jQuery and instead have an any type. Fixes #16669.
• The Cypress.ConfigOptions, Cypress.ResolvedConfigOptions and Cypress.RuntimeConfigOption types have been updated so that ConfigOptions 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 a clientCertificates configuration option. See Client certificates for more detail.
• Setting the environment variable ELECTRON_RUN_AS_NODE now 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.log and console.error called within the plugins file will now be captured in the stdout sent to the Cypress Dashboard, making it visible in Output logs in the Dashboard. Fixes #7434.
• There are several fixes for cy.intercept() including:
  • The times option now works correctly with req.continue. Fixes #16821.
  • localhost is now accepted as a valid hostname in the RouteMatcher. Fixes #17015.
  • delay now works correctly with a statusCode of 204. Fixes #15188.
• 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 proper this context on nested object methods. Fixes #3871.
• We no longer trigger unnecessary snapshot re-renders when hovering over the Command Log. Fixes #17257.

Released 07/07/2021

Features:

• When using experimentalStudio, Cypress Studio can now copy all commands generated to your clipboard. Addressed in #16912.

Bugfixes:

• Cypress now respects preventScroll options passed to element.focus() calls within the application under test. Fixes #15294.
• Using .contains(0) will now show the zero in the Command Log. Fixes #1119.
• Cypress will no longer show a warning about allowed keys for the showedOnBoardingModal when running cypress open. Fixes #17095.
• The Cypress Studio introduction modal will now display with the correct styling. Fixes #17102.
• The types for .contains() now correctly allow for the includeShadowDom option. Fixes #17066.

Misc:

• We updated the messaging when Cypress fails to start to be clearer that it's not always due to a dependency missing. Addresses #17112.

Released 06/23/2021

Features:

• You can now override the default delay between typing characters for .type() with Cypress.Keyboard.defaults() or via test configuration. Addresses #566.
• The experience when opening a new project via cypress open has been improved. Addressed in #15826.
  • The scaffolded example files have been updated to include examples tests of the TodoMVC project.
  • You can now easily delete all of the scaffolded example files directly from the Test Runner GUI.
  • There's now a button to create a new spec file when no spec files are found in the project.
  • A new onboarding banner with be present with helpful links for new users and new projects.
• The incoming request object yielded to request handler functions passed to cy.intercept() (req) now has a req.query property, which is a getter/setter for the query parameters on the request URL. Addresses #16327.
• You can now pass an ArrayBuffer as a request / response body with cy.intercept(). Addresses #16722

Bugfixes:

• Cypress no longer hangs intermittently when using webpack 5. Fixes #15447.
• It is no longer necessary to return the config from the plugins function when using the dev-server:start event for component testing. Fixes #16860.
• cy.intercept() now correctly sets the response body as a string instead of an ArrayBuffer when it contains multi-byte characters. Fixes #16292.
• cy.intercept() won't corrupt certain binary responses. Fixes #16722.
• On Windows, the Cypress executable is now code signed by "Cypress.io, Inc.". This fixes spawn UNKNOWN errors when launching Cypress with code signing required by policy on Windows. Fixes #2543
• We now warn on EPERM errors when accessing the project directory instead of erroring. Fixes #16933.
• Cypress now better handles running when browsers with unconventional versions are present on the machine. Fixes #15485.
• Expanded the types for CyHttpMessages.BaseMessage.headers to support the value being an array of strings. Fixes #16734.

Dependency Updates:

• Added enquirer dependency. Fixes #16846.

Released 06/07/2021

Features:

• The Test Runner has a new 'Docs' menu with links and prompts specific to helping you get started writing tests, set up in CI, and running tests in the Dashboard. Addressed in #16433.
• cy.request() now accepts a generic in TypeScript for specifying the type of the request body. Addresses #9109.

Bugfixes:

• Cypress will not longer crash with a hasBinary infinite recursive call. Fixes #16476.
• The --config-file option now correctly handles absolute paths. Fixes #6136.
• cy.location(<key>) will now retry if the remote location returns an empty string, which is possible during otherwise harmless redirects. Fixes #16463.
• Cypress now passes a flag to Chrome browsers to prevent update notifications from displaying in some cases. Fixes #16693.
• TypeScript will now properly error when attempting to use the chai <value>.should() syntax. Fixes #16548.

Dependency Updates:

• Replaced deprecated listr with listr2. Addressed in #16663.

Released 05/24/2021

Features:

• Cypress now detects and supports testing in the Chrome Beta browser. Addresses #16376.
• There are new keyboard shortcuts to continue (c) and to go to the next test (n) when the Test Runner is paused via .pause() and to toggle auto-scrolling of the Test Runner (a). Addresses #248.

Bugfixes:

• cy.request() can now send binary files in form data. Fixes #1647.
• cy.request() can now send blob data. Fixes #6178.
• Fixed an issue where cy.wait() could yield the incorrect result when used with cy.intercept() and several simultaneous requests. Fixes #16451.
• Improved the way that cy.intercept() matchers are displayed in the Command Log when using RouteMatcher properties besides url and method. Fixes #9403.
• cy.intercept() argument validation has been improved. Invalid hostnames and extra arguments passed to cy.intercept() now result in an error. Addressed in #16577.
• cy.screenshot() no longer incorrectly captures parts of the Test Runner UI during component testing. Fixes #16543.
• Spec files that containing spaces in the path will now properly open during cypress open-ct. Fixes #16278.
• Cypress now correctly uses the componentFolder and testFiles values from returned from plugins in the component testing runner. Fixes #16424.
• Video recordings in Chrome, Chromium, and Electron browsers will no longer drop frames, with the frequency increasing along with the length of the video. Fixes #16648.
• Tests located outside of the projectRoot will now open in IDE and generate studio commands when saved. Fixes #16255.
• config in the plugins file will now display in alphabetical order. Fixes #16564.

Dependency Updates:

• Upgraded dependency-tree from 7.0.2 to 8.1.0. Addressed in #16464.
• Upgraded extract-zip from 1.7.0 to 2.0.1. Fixes #6896

Released 05/10/2021

Features:

• Component tests can now be launched via the Module API by passing testingType: 'component' via the new testingType property. The testingType will default to e2e. Addresses #16302.
• cy.intercept() now accepts a times option in the RouteMatcher. times will specify the number of times that a particular cy.intercept() should be applied. Addresses #4460 and #8531.
• cy.intercept() now accepts invocation using cy.intercept(url, routeMatcher, handler), where url is a regular expression. Previously, this only worked if url was a string. Addresses #16390.
• Cypress will now automatically get environment variables for LayerCI when recording to the Dashboard. Addresses #16101.
• Setting the env var DEBUG=cypress:server:record:ci-info will print commit information and CI provider information that's sent to the Dashboard as debug logs. Addresses #16236.
• Cypress can now use the certificate authority specified in NPM config if CYPRESS_DOWNLOAD_USE_CA is specified. See "Using a custom CA" for more information. Addresses #8825.

Bugfixes:

• Cypress will no longer incorrectly redirect the AUT window to /__/ when location.href is set to a relative path within the call stack of an XHR event handler. Fixes #3975 and #7439.
• Cypress now properly handles when a form submit or anchor tag target is set to _top or _parent so that it no longer redirects the parent frame. Fixes #1244.
• Fixed a regression in 6.5.0 that could cause Cypress to crash with a RangeError: Maximum call stack size exceeded at _deconstructPacket error. Most commonly, this occurred when handling network errors with cy.request(). Fixes #15101.
• Fixed a regression in 7.0.0 that caused the Test Runner to crash with an ERR_INVALID_ARG_TYPE type error when testing a binary file upload. Fixes #15898 and #16223.
• When verifying Cypress, we now listen for the 'close' event instead of the 'exit' event in an effort to fix some situations where the browser cannot be found even though it is on the system. Addressed in #16312.
• Fixed a regression in 6.5.0 that caused a node warning about .then() only accepting functions to display. Fixes #15281.
• cy.intercept() now adds a access-control-expose-headers: '*' header by default for CORS requests unless overridden. Fixes #15050.
• Improved the way that cy.intercept() and cy.route() requests with multiple aliases are displayed in the command log. Addressed in #16382.
• Cypress.cookies.debug(true) will now correctly show cookie-related messages on the console. Fixes #15032.
• cy.log() will now show all arguments, not only the first 2. Fixes #16068.
• .select() now correctly selects option elements with values that have   characters. Fixes #16045.
• The e2e and component configuration values will now correctly show when previewing resolved configuration in the Test Runner. Fixes #16282.
• When passing the —quiet flag, Cypress will no longer print uploading output to Stdout. Fixes #16268.
• When pressing the / hotkey in Firefox, Cypress will select the SpecList's SearchInput as it does in other browsers. Fixes #16309.
• Cypress will now detect the default installation location of the Visual Studio Code editors on Windows machines. Fixes #15080.
• Changing files extensions when creating a new test file should no longer add extra dots to the filename on Windows machines. Fixes #16131.

Dependency Updates:

• Upgraded classnames from 2.2.6 to 2.3.1. Addressed in #8337.
• Upgraded color-string from 1.5.4 to 1.5.5. Addressed in #16362.
• Upgraded lodash from 4.17.19 to 4.17.21. Addressed in #16406.
• Upgraded registry-js from 1.13.0 to 1.15.0. Addressed in #16409.
• Upgraded url-parse from 1.4.7 to 1.5.0. Addressed in #16408.

Released 04/26/2021

Features:

• You can now navigate through folders in the Test Runner using the Tab keyboard input and open or close the folder's content with the Enter & Space keyboard inputs. Addresses #3741.

Performance:

• Fixed a regression in 7.0.0 that caused tests to run slowly, especially when run with constrained CPU resources. Fixes #15853.
• Fixed a regression in 7.0.0 causing decreased performance in Chromium browsers due to requesting screencast frames when video is disabled. Fixes #16030.

Bugfixes:

• Fixed a regression in 7.0.0 that caused the Test Runner to crash with an ERR_INVALID_ARG_TYPE type error. We now correctly detect a utf8 request body with multi-byte Unicode characters. Fixes #15901.
• Reusing cy.intercept() aliases will now work as expected. Fixes #15823.
• Fixed an issue in 7.0 where users could get a misleading "must pass a handler as the 3rd argument" error when using cy.intercept. Fixes #16117.
• cypress run-ct no longer hangs on Windows machines. Fixes #15976.
• Hovering over a command log without a snapshot will no longer cause the error Cannot read property 'name' of null. Fixes #15816.
• We now throw an error when attempting to .select() an <option> within a disabled <fieldset>. Fixes #5951.
• .type() will no longer change the value attribute of button-like inputs with type button, submit, reset, image, radio, or checkbox. Fixes #15913.
• Specs will now load when using a relative directory for componentFolder outside of the root project when specifying --project. Fixes #16053.
• The search input will now display when there are many component spec files. Fixes #16089.

Misc:

• Lodash types have been updated. Addressed in #15860.
• Types for the selector playground have been added. Addressed in #15834.
• Cypress.Cookies.defaults() now returns the correct type instead of void. Addresses #15426.
• .then() will show the correct type when a collection of HTMLElements is provided. Addressed in #15869.
• Improved types for cy.intercept(). Addressed in #16167.

Dependency Updates:

• Downgraded the Chromium browser version used during cypress run and when selecting Electron browser in cypress open from 89.0.4348.1 to 89.0.4328.0. This was done to address a performance regression introduced in 7.0.0. Addressed in #16113.
• Upgraded systeminformation from 5.3.1 to 5.6.4. Addressed in #15819.
• Replaced lolex with @sinonjs/fake-timers. Addressed in #15595.

Released 04/12/2021

Features:

• The events before:spec, after:spec, before:run, and after:run now fire in interactive mode in addition to run mode. This requires the experimentalInteractiveRunEvents flag to be enabled. Addressed in #15787.

Bugfixes:

• Viewport configuration set in cypress.json is 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.

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 stderr in production builds of Cypress. Addressed in #15817.
• Cypress no longer prints a warning to stdout when 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.json file present. Addressed in #15828.

Misc:

• The "New Spec File" in the Desktop GUI has a less pronounced style. Addressed in #15835.

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 calling cy.intercept() again. This matches the previous behavior that was default in cy.route(). Addresses #9302.
  • cy.intercept() now automatically parses more JSON MIME types, including 'application/vnd.api+json'. You can now remove JSON.parse(req.body) or JSON.parse(res.body) from some tests that previously required it. Addresses #14763.
  • Falsy values (with the exception of undefined) supplied as the body of a StaticResponse to cy.intercept() will now be JSONified and sent as the body. Previously, an empty string was sent instead. Addresses #15234 and #14205.
  • The matchUrlAgainstPath RouteMatcher property has been removed from cy.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 delay option for StaticResponses used with cy.intercept() has been removed. Please go back to using the delayMS option. Addresses #15255.
  • cy.route2() was previously aliased to cy.intercept(). Now the alias cy.route2() has been removed. Please update usage of cy.route2() to cy.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 open or cypress run. Now, they need to be executed by running cypress open-ct or cypress run-ct. Addressed in #15701.
  • experimentalComponentTesting must be removed from yoru configuration file, cypress.json by default, or it will throw an error. Addressed in #15701.
  • The file:preprocessor event is no longer used to compile component tests. Now, a dev-server:start event 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:exception event 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 redirectionLimit config. Addresses #14445.
• The default preprocessor now targets a more modern version of ECMAScript. Addressed in #15274.
• We now enable contextIsolation by default in the Electron browser. You can override this option if needed within the before:browser:launch API. 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.3 to 14.16.0. This could change the behavior of code within the pluginsFile when using the bundled Node.js version of Cypress. Addressed in #15292.
• 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() including before:response, response, and after:response.
  • Response handlers (supplied via event handlers or via req.continue(cb)) supplied to cy.intercept() will be called in reverse order until res.send is called or until there are no more response handlers.
  • A new option, middleware, has been added to the RouteMatcher type. 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 by cy.intercept(). It is functionally the same as req.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). routeMatcher will be merged with url, and the handler is required.
• cy.visit() can now visit pages with application/xhtml* content-type. Addresses #15738.
• You can now pass runner specific configuration in order to pass different configuration values to component tests versus e2e tests. 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.
• cy.tick() now accepts a log option. Addresses #15180.
• The Cypress proxy now adds a keep-alive header to all proxy responses. Addressed in #15292
• Cypress no longer forces specific NODE_OPTIONS. Addressed in #15292

Bugfixes:

• The response.body of cy.intercept() is now correct after stubbing a response using res.send({ fixture }) in a req.continue callback or a before:response or response handler. 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 style are gone from the console in open-ct during Component Testing. Addressed in #15661.
• Some memory leaks were fixed in @cypress/vue. Addressed in #15275.

Misc:

• The types for set-cookie allow string[], 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 #14875
• The 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

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 87 to 89. Addressed in #15292.
• Upgraded bundled Node.js version from 12.18.3 to 14.16.0. Addressed in #15292.
• Upgraded electron from 11.3.0 to 12.0.0. Addressed in #15292.

Released Apr 05, 2021

This release contains the same features as 6.8.0 . It was published to provide a non-breaking alternative to 6.9.0 , which was mistakenly published with breaking changes.

Released Apr 05, 2021

This release was mistakenly published with breaking changes, is deprecated, and should not be used. Upgrade to 6.9.1 or 7.0.0 , or stay on 6.8.0 .

Released 3/17/2021

User Experience:

• Improved the specs list user interface with a new icon set and accessibility features when in Component Testing mode (alpha). Addressed in #15513

Bugfixes:

• Cypress will no longer exit with an error when recording a run to the Dashboard with empty specfiles. Fixes #15512.
• When using experimentalStudio, Cypress Studio the icon to add commands will now fully display on long test titles. Fixes #15182.

Released 3/15/2021

Bugfixes:

• Interacting with an element that requires scrolling within an element with scroll-behavior: smooth no longer fails Cypress's actionability check. Fixes #15453.
• A regression in 6.7.0 has been fixed so that the projectId will be written correctly to the cypress.json file on initial creation without an extra config object. Fixes #15497.

Released 3/15/2021

Features:

• The experimentalRunEvents configuration flag has been removed. You can now listen to before:run, after:run, before:spec and after:spec events in the plugins file without needing the experimentalRunEvents configuration option. See the before:run, after:run, before:spec and after:spec docs for more information. Addressed in #15276.
• When canceling a run from the Dashboard, previously only parallelized runs would cancel correctly. Now all recorded runs will respect cancelation and exit early. Addresses #1691.
• Test configuration is now captured and sent when recording to the Dashboard. Addresses #15487.
• Cypress now sends test details to the Dashboard at the beginning of a recorded run, so historical test code and other data can be provided to the Dashboard upfront. Addressed in #14925.
• The full stack trace from errors thrown in the preprocessor are now displayed. Addressed in #15198.
• Configuration values which are changed at runtime prior to tests running are now properly shown as resolved from the spec code within the Module API to indicate where the change originated from. Addresses #15486.

Bugfixes:

• FFmpeg will no longer error ("width not divisible by 2") during video recording in Chromium-family browsers, including Chrome, Electron, and Edge. Fixes #3491 and #15300.
• cy.wait() no longer falsely returns a timeout when the user aborts an XHR. Fixes #9549.
• .clear() and .type('{selectall}{del}') now behave the same when they're used against elements that contain text inputs. Fixes #8447.
• When using experimentalStudio, Cypress Studio now records typing by using the value of the input rather than the keys that were pressed. Studio also no longer records pressing special keys (such as arrows or ctrl) except for Enter. Fixes #15023.
• Empty jQuery objects are now properly shown in error messages in the Command Log. Fixes #14279.
• Length assertions on DOM elements now properly show the user-defined assertion message if specified. Fixes #14484.
• Cypress no longer scrolls on mouse down event, fixes #8279.

Misc:

• "Test recordings" recorded to the Cypress Dashboard are now referred to as recorded "test results." Addresses #15376.
• Errors shown from plugins files now display top-aligned. Addressed in #15347.

Dependency Updates:

• Upgraded electron from 11.2.3 to 11.3.0. Addressed in #15201.