cypress

Released 2/1/2021

Features:

• Added a command log entry for when a file is donwloaded. Addresses #14749.
• The delayMs option for cy.intercept() has been renamed to delay. delayMs will still work, but it is deprecated and will be removed in a future release. Addresses #14822.

Bugfixes:

• Fixed an issue with handling spec paths containing special characters. Addresses #14659.
• Fixed an issue where Cypress Studio would not prompt to start adding commands after visiting an inputted url. Addresses #14688.
• Fixed an issue where Cypress Studio could generate empty cy.type() commands. Addresses #14684.
• Fixed an issue where Cypress Studio prompts user to enter a URL even if an error has already occured. Addresses #14686.
• Fixed an issue where Cypress Studio would not reload tests with watchForFileChanges: false. Addresses #14744.
• Fixed an issue where Cypress studio would add a cy.click() before cy.type(). Addresses #14685.
• Fixed an issue where Cypress Studio could use the wrong selector for a click event. Addresses #14658.
• Fixed multi-select support for Cypress Studio. Addresses #14743.
• Improved the UI for command failures within Cypress Studio. Addresses #14691.
• The Selector Playground is now closed automatically when Cypress Studio is opened. #14689.
• Fixed an issue with cy.intercept where aliases set via req.alias containing a period character would not work as expected. Addresses #14444.
• Fixed an issue where delays set using cy.intercept would not work as expected. Addresses #14446 and #14511.
• Reverted a change to how the Chrome DevTools Protocol is established. Instead of using stdio and then falling back to TCP, Cypress now only uses TCP to try to connect to Chrome DevTools Protocol. Addresses #14819.
• Fixed an issue causing a webpack compilation error when a browserslist is present in project root. Addresses #8864.

Misc:

• Added more details to the "no specs found" error. Addresses #14532.
• Added more resolved config property types. Addresses #14392.
• Added UTM parameters to external links. Addresses #14741.

Dependency Updates:

• Upgraded recast to version 0.20.4. Addresses #14623.
• Upgraded registry-js to version 1.13.0. Addresses #14668.
• Upgraded @cypress/get-windows-proxy to version 1.6.2. Addresses #14711.
• Upgraded systeminformation to version 4.31.1. Addresses #14715.
• Upgraded semantic-release to version 17.2.3. Addresses #14713.
• Upgraded electron to version 11.2.1`. Addresses #14764.

Released 1/19/2021

Features:

• Cypress Studio provides a visual way to generate tests within the Test Runner, by recording interactions against the application under test. Cypress Studio is an experimental feature that can be enabled by adding the experimentalStudio attribute to your configuration, cypress.json by default. Address #73.
• You can now test file downloads in Cypress without the download prompt displaying. Any files downloaded while testing file downloads will be stored in the downloadsFolder which is set to cypress/downloads by default. The downloadsFolder will be deleted before each run unless trashAssetsBeforeRuns is set to false. Addresses #949.

Bugfixes:

• When an uncaught exception is thrown outside a suite with an .only, the error will now correctly display in the Command Log. Fixes #14455.
• Cypress will no longer crash when no record key is provided to the --key flag when followed by other CLI flags. Fixed #14593.
• Extra screenshots will no longer be taken when tests are retried when there is a failure in an afterEach hook. Fixes #9209.
• Having waitForAnimations set to false no longer affects whether Cypress fires actions on inner elements. Fixes #14370.
• We fixed a regression in 5.0.0 that would cause string CYPRESS_ prefixed env variables containing commas to be parsed as multiple values. Fixes #8818.
• We fixed a regression in 4.9.0 where asserting have.value on an undefined subject would throw an error. Fixes #14359.
• We updated the CDP connection to attempt to use the stdio transport first with Chrome 72 and above, before falling back to using TCP. This should remediate issues causing sporadic "Cypress failed to make a connection to the Chrome DevTools Protocol after retrying" errors. Fixes #6540, #7450, #8674, and #8986.

Misc:

• We removed several Chrome flags that are no longer supported. Addressed in #14582.

Dependency Updates:

• Replaced deprecated node-sass with sass. Addressed in #14415.
• Upgraded debug from 4.1.1 to 4.3.1. Addressed in #14583.
• Upgraded electron from 11.0.3 to 11.2.0. Addressed in #14567.
• Upgraded electron-builder from 22.8.0 to 22.9.1. Addressed in #14493.
• Upgraded shell-env from 3.0.0 to 3.0.1. Addressed in #14622.
• Upgraded uuid from 8.2.0 to 8.3.2. Addressed in #14170.

Released 1/4/2021

Bugfixes:

• Test retries, when retrying on several failed tests, will no longer cause hanging during cypress run. Fixes #9040.
• multipart/form-data is no longer wrongly encoded when using cy.intercept(). This should prevent Unexpected end of multipart data errors on the back end service where the request was pointing to. Fixes #9359.
• cy.contains() no longer throws an error when a single quote is used inside its argument when RegExp. Fixes #8626.
• Passing capture: 'runner' to a cy.screenshot() command inside .within() now screenshots the entire Test Runner as expected. Fixes #14253.
• Cypress.dom.isJquery() now always returns a boolean instead of undefined sometimes. Fixes #14278.
• calledOnceWith and calledOnceWithExactly sinon matchers no longer throw an error when used within Cypress. Fixes #9644.
• We now pass --disable-backgrounding-occluded-windows as a default flag to Chrome to prevent backgrounding rendering when the Cypress window is occluded. Fixes #9604.

Misc:

• After login, if a name is undefined on your profile, the Test Runner will show the profile's email and link to instructions to update the name. Addresses #14288.

Dependency Updates:

• Upgraded devtools-protocol from 0.0.734984 to 0.0.839267. Addressed in #14353.
• Upgraded electron from 11.0.3 to 11.1.1. Addressed in #14352.

Released 12/21/2020

Features:

• You can now listen to before:run and after:run events in the plugins file. See the before:run and after:run docs for more information. Addressed in #14238 and #14263.
• You can now listen to before:spec and after:spec events in the plugins file. See the before:spec and after:spec docs for more information. Addressed in #9646 and #14178.
• The Timed out retrying error message now displays the amount of time Cypress retried. Addresses #5781.

Bugfixes:

• Getting an alias of cy.intercept() using cy.get() will no longer always yield null. Fixes #9306.
• cy.intercept() will now automatically responds to CORS preflight requests (HTTP OPTIONS requests) that match defined routes. Fixes #9599.
• Response errors from forceNetworkError can now be awaited using cy.intercept() and cy.wait(). Fixes #9062.
• Using cy.log() inside .then() no longer breaks the subject value in the command chain. Fixes #8084.
• Using Cypress.Commands.overwrite to overwrite .then() now preserves the proper this context and sets aliases correctly. Fixes #5101.
• Using Cypress.Commands.overwrite to overwrite cy.route() or cy.intercept() and wait on its alias now properly works. Fixes #3890 and #9580.
• Cypress no longer fails to find specs if you set the fixtures folder to be the same as the integration folder. Fixes #14226.
• Cypress no longer fails to show error code frames if the spec filename has a space in it, fixes #7553.

Misc:

• scrollBehavior is now an allowed type when passed as test configuration. Addresses #9643.
• The FileObject type for the file argument of the file:preprocessor event now includes the EventEmitter type. Addresses #9276.

Dependency Updates:

• Upgraded electron from 11.0.2 to 11.0.3. Addressed in #9409.

Released 12/07/2020

Features:

• There's a new scrollBehavior configuration option that controls the viewport position when an element is scrolled prior to action commands. Possible values are 'top', 'bottom', 'center', 'nearest', and false, with 'top' being the default. scrollBehavior: false disables scrolling altogether. scrollBehavior can be specified in global configuration, test configuration or individual action commands via options. Addresses #871 and #4356.
• The Tests tab in the Test Runner now orders folders before files. This matches the ordering of most IDEs' file explorers. Addresses #7334.

Bugfixes:

• Responses stubbed from cy.intercept() will now automatically set Access-Control-Allow-Origin and Access-Control-Allow-Credentials to permissive values unless explicitly overridden. Fixes #9264.
• The Cannot read property "fireChangeEvent" of undefined error will no longer throw during a race condition when using cy.intercept(). https://github.com/cypress-io/cypress/issues/9170
• HTTP responses that cannot have a body (like HTTP 304 and HTTP 204) can now be awaited using cy.intercept(). Fixes #8934 and #8999.
• We fixed an issue where HTTP redirects could not be awaited using cy.intercept() unless dynamically intercepted. Addressed in #9097.
• Tests will no longer hang in certain situations when there's an error in a before() hook. Fixes #9162.
• We no longer strip / from URLs when they are explicitly passed with query paramaters. Fixes #9360.
• Fixed the regression in Cypress.dom.isVisible behavior for elements with position: fixed, addresses #8998 and #9031.

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.

• Cypress.moment has been deprecated and will be replaced in a future release. Consider migrating to a different datetime formatter. Addresses #8714.

Misc:

• We collect more environment variables from Bitbucket to better detect reruns. Addresses #9309.
• waitForAnimations and animationDistanceThreshold types are now included for all actionable commands. Addresses #8854.

Dependency Updates:

• Upgraded mocha-junit-reporter from 1.23.1 to 2.0.0. Addressed in #9528.

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 setting sourceMap in your tsconfig. Fixes #8477.
• cy.screenshot() no longer throws an "offset" is out of range error 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.

Released 11/23/2020

Summary:

Cypress now offers full network stubbing support with the introduction of the cy.intercept() command (previously cy.route2()). With cy.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 as not.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: 0 are 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 with opacity: 0. Addresses #4474.
• The type yielded by cy.wait(alias) has changed in order to support use of cy.intercept(). Addressed in #9266.
• The experimentalNetworkStubbing option 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 a contenteditable element, 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 do JSON.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.

• cy.server() and cy.route() have been deprecated. In a future release, support for cy.server() and cy.route() will be moved to a plugin. We encourage you to use cy.intercept() instead. Addressed in #9185.
• experimentalFetchPolyfill has been deprecated. We encourage you to use cy.intercept() to intercept requests using the Fetch API instead.
• cy.route2() was renamed to cy.intercept(). We encourage you to update usages of cy.route2() to use cy.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-usage to the Chrome browser flags by default. This will write shared memory files into /tmp instead of /dev/shm. If you're passing this flag in your plugins file, 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 version command now also displays the current Electron and bundled Node versions. Addresses #9180.
• The cypress version command now accepts a --component flag 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 a contenteditable element. 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-Length for cy.route2 request 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 of cy.route() including our Network Requests doc.

Misc:

• Added the type of redirects and changed redirectedToUrl optional for Response types. Addresses #9275.

Dependency Updates

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 85 to 87. Addressed in #9222.
• Upgraded bundled Node.js version from 12.16.3 to 12.18.3. Addressed in #9222.
• Upgraded electron from 10.1.5 to 11.0.2. Addressed in #9222.

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 with content-type of text-html followed by parameters (like text/html;charset=utf-8) will no longer throw an error about visiting a site with an invalid content-type. Fixes #8506
• The Cannot access 'continueSent' before initialization error will no longer throw when using cy.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 undefined error 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 to cy.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 a timeout option. Addresses #9079.
• Typings for cy.task() now allow for parameterizing the task return type. Addresses #7136.
• A clearer error is printed during cypress cache list when no cached versions are found. Addresses #6303.

Dependency Updates:

• Upgraded commander from ^4.1.1 to ^5.1.0. Addressed in #8979.
• Upgraded semver from 6.3.0 to 7.3.2. Addressed in #9068.
• Upgraded systeminformation from 4.26.9 to 4.27.11. Addressed in #8979.
• Removed node-webkit-updater. This should remove some security warnings that were shown during install. Addresses #8314.

Released 10/26/2020

Features:

• cy.viewport() has a new macbook-16 preset. Addresses #8889.
• .type() now fires the beforeInput event during typing. Note: Firefox does not support the beforeinput event. 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.route2 where 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() 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 experimentalNetworkStubbing is enabled, using cy.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 a status property in the results matching the correct CLI types ("failed" or "finished"). Addresses #8798.
• When a value containing an e character is passed to the --ci-build-id flag, Cypress now properly reads it as a string. Fixes #8874.

Misc:

• Updated type definitions to allow for passed either runMode or openMode to retries alone. Addresses #8869.

Dependency Updates:

• Upgraded electron from 10.1.3 to 10.1.5. Addresses #8927, #8975.
  • This addresses a Chrome security issue, CVE-2020-15999. Addresses #8922.
• Upgraded color-string from 1.5.3 to 1.5.4. Addresses #8945.
• Upgraded pretty-bytes from ^5.3.0 to ^5.4.1. Addresses #8964.

Released 10/14/2020

Features:

• You can now run cypress cache prune to delete all installed Cypress versions from the cache except for the currently-installed version. Addresses #5972.
• There's a new --size option for the cypress cache list command that prints the sizes of the Cypress cache folders. Addresses #6404.
• For video recordings of runs, there is now a video chapter key for each test. If your video player supports chapters, you can move to the start of each test right away. Addresses #3626.
• In Windows, you can now append the browser type to the end of the path passed to the --browser flag, like cypress open --browser C:/User/App/browser.exe:chrome, to help detect the browser type. Addresses #6389.
• cy.viewport() has new iphone-7, iphone-8, and iphone-se2 presets. Addressed in #8624
• When there is a new version of Cypress available, the update modal has a new design with 'copy to clipboard' buttons to copy the upgrade commands. Addressed in #8751.
• The Command Log can be hidden by passing the CYPRESS_NO_COMMAND_LOG=1 environment variable during cypress open or cypress run to be used as a tool to debug performance issues. Addressed in #8689.

Bugfixes:

• We fixed a regression in 5.0.0 where the chromeWebSecurity option had no effect in Electron. Fixes #8399.
• Tests will no longer hang and now properly throw when there is an error thrown from a test:after:run event listener. Fixes #2271 and #8701.
• When a command is chained after .within() and "cy.get()" is called inside it, the scope will no longer permanently change. Fixes #2106, #4672, #4757, and #5183.
• Dual commands like cy.contains() when used after an .each() commands now query as expected. Fixes #4921.
• / is no longer added to the URL when baseUrl has param(s). Fixes #2101.
• When using cy.route2() the route handler timeouts will no longer leak into other tests and cause random failures. Addressed in #8727.
• Re-running failed build steps in Bitbucket will no longer create a new run on the Cypress Dashboard. Fixes #8720.
• The forced garbage collection timer will no longer display when using a version of Firefox newer than 80. Fixes #8725.
• The browser dropdown is no longer covered when opened from the Runs tab in the Test Runner. Fixed in #8745.
• Fixed an issue where preprocessor-related plugins would cause tests not to run and a duplicate instance of Cypress to be spawned. Fixes #8634.

Misc:

• Improved type definitions for cy.route2(). Addresses #8694 and #8782.
• The Test Runner now shows an indicator in the footer and a toast notification if there is a new version available. Addressed in #8702 and #8803.

Dependency Updates:

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 83 to 85. Addressed in #8406.
• Upgraded bundled Node.js version from 12.14.1 to 12.16.3. Addressed in #8406.
• Upgraded electron from 9.2.1 to 10.1.3. Addressed in #8406.
• Upgraded firefox-profile from 2.0.0 to 4.0.0. Addressed in #8786.
• Upgraded node-forge from 0.9.0 to 0.10.0. Addressed in #8800.

Released 9/28/2020

Features:

• Firefox support is now out of beta! 🎉 Firefox 80 and newer are now officially stable when used with Cypress. Addresses #8241.
  • Versions of Firefox older than 80 can still be used, but will be subject to the firefoxGcInterval workaround. The desktop GUI will display a warning if such versions are used.

Bugfixes:

• Fixed a bug where cy.route2 would not automatically JSONify an empty array handler. Addresses #8532.
• Fixed a bug where objects yielded by using cy.wait on a cy.route2 alias would not always have a response property. Addresses #8536.
• Fixed an issue where cy.route2 routes would not be able to intercept requests to HTTPS destinations on a different origin. Addresses #8487.
• Fixed an issue where subjects became undefined after certain assertion failures. Addresses #5763.
• Fixed an issue where a cy.task with no arguments passed would receive null as the first argument instead of undefined. Addresses #5913.
• Fixed an issue preventing users from passing the config-file argument when starting cypress through the node module API. Addresses #8632.
• Fixed an issue where cy.visit()s to a relative URL containing .. would not work. Addresses #5090.
• Fixed an issue where Mocha hooks could still be triggered after the Test Runner was manually stopped. Addresses #8621.
• Fixed an issue where cy.setCookie failed when given a cookie name with a __Host- prefix. Addresses #8261.
• Fixed an issue where a misleading error was displayed when test code threw an exception with a non-Error object. Addresses #7870.

Misc:

• The proxy now omits the Content-Security-Policy-Report-Only header the same way that it does for Content-Security-Policy. Addresses #7936.
• Added a status property to CypressRunResult objects. Addresses #8580.
• Updated types to no longer use deprecated Mocha interfaces. Addresses #5795.
• Passing an empty string to CYPRESS_INSTALL_BINARY now takes precedence over npm config. Addresses #8488.

Released 9/15/2020

Features:

• Added the configuration option includeShadowDom for enabling shadow DOM querying globally, per-suite, per-test, or programmatically. Addresses #8442.
• Added a followRedirect option to request interception with cy.route2(), allowing redirects to be followed before continuing to response interception. Addresses #7967.
• Added the capability to specify delayMs and throttleKbps when stubbing static responses with cy.route2(). Addresses #7661.
• Installing Cypress pre-releases no longer requires setting the CYPRESS_BINARY_INSTALL environment variable. Addresses #8482.

Performance Improvements:

• Fixed a performance issue which led to CPU bottlenecking during Cypress runs. Addresses #8012 and #8297.

Bugfixes:

• Fixed an issue where using TypeScript path aliases in the plugins file would error. Addresses #8555.
• Fixed an issue where using cy.contains() within a shadow root would not yield the correct element. Addresses #8494.
• Fixed an issue where querying the shadow DOM in a cy.within() callback would throw the error root.getRootNode is not a function. Addresses #8478.
• Fixed an issue with cy.type() {moveToStart}/{moveToEnd} special characters moving the cursor to the current line instead of the entire text editable when typing in a contenteditable element. Addresses #8465.
• Fixed an issue where typing into a manually-focused number input would prepend the number instead of appending it. Addresses #7170.
• cy.type() now fires a KeyboardEvent event instead of an Event event. Addresses #6125 and #5650.
• Fixed long selectors in the selector playground text input overflowing other page elements. Addresses #8247 and #4184.
• Fixed an issue where assertions on cy.getCookie() would be called twice. Addresses #6672.
• Fixed an issue that caused the "Open in IDE" button on hooks and tests not to appear in Firefox. Addresses #8257.
• Fixed an issue causing Cypress to hang on test retry in run mode with certain assertions. Addresses #8363.

Documentation Changes:

• Fixed examples of delaying and throttling responses with cy.route2(). Addresses #8489.
• Added examples of using a response function with cy.route2(). Addresses #8468.
• Removed unmaintained languages. English docs is the only supported language by the Cypress team. We greatly appreciate the contributions from the community for other languages, but these docs are largely stale, unmaintained, and partial. The Cypress team will seek out more scalable docs internalization implementation in the future.

Misc:

• The experimentalShadowDomSupport configuration flag has been removed. It is no longer necessary to enable shadow DOM testing.
• Improved the error message when the subject provided to cy.shadow() is not a shadow host. Addresses #8530.
• Improved the error message when the Cypress binary is not executable. It now recommends trying to clear the cache and re-install. Addresses #8397.
• Added missing type declarations for the cy.route2() command.
• Updated the type declaration for Cypress.Commands.add(), adding Promise to the list of allowed return types. Addresses #7807.

Released 9/1/2020

Features:

• Introducing experimental full network stubbing support 🎉.
  • With experimentalNetworkStubbing enabled, the cy.route2 command is available.
  • By using cy.route2(), your tests can intercept, modify, and wait on any type of HTTP request originating from your app, including XMLHttpRequests, fetch requests, beacons, and subresources (like iframes and scripts).
  • Outgoing HTTP requests can be modified before reaching the destination server, and the HTTP response can be intercepted as well before it reaches the browser.
  • See the cy.route2() docs for more information on how to enable this experiment.
• cy.trigger() now accepts an eventConstructor option for specifying the constructor with which to create the event to trigger. Addresses #5650.

Bugfixes:

• Improved warnings for when user is exceeding test limits of the free Dashboard plan. Addresses #8409.
• Added retries to TestOptions types. Addresses #8405.
• Added types for specType field on Cypress.spec. Addresses #8256.
• Fixed a typo in type definitions. Addresses #8417.
• Cypress now resolves and loads tsconfig.json for TypeScript projects starting from the plugins directory. Addresses #8359.
• Fixed an issue where, if npm config's noproxy is set, unexpected behavior could occur. Addresses #8287.
• Fixed an issue where nesting hooks within other hooks caused the test to never finish. Addresses #8350.
• Fixed an issue in where tests would unexpectedly fail with a "Can't resolve 'async_hooks'" error. Addresses #8375.
• Fixed an issue where return values from blob utils were mistaken for promises and could cause errors. Addresses #8365.
• Fixed an issue with loading .mjs files. Addresses #8361.
• Fixed an issue causing tests to run slowly in Electron. Addresses #7930.
• Using .should with only chainer assertions will now throw an error. Addresses #883.
• cy.trigger() now includes the view property in the event object when appropriate. Addresses #3686.
• Fixed an issue where Cypress would not detect newer 64-bit installations of Chrome on Windows. Addresses #8425.
• Fixed an issue where Cypress would not detect per-user Firefox installations on Windows. Addresses #8432.

Dependency Updates:

• Updated dependency iconv-lite to version 0.6.2. Addresses #8387.
• Updated dependency command-exists to version 1.2.9. Addresses #8388.
• Updated dependency electron to version 9.2.1. Addresses #8436.

Released 8/19/2020

Summary:

Cypress now includes support for test retries! Similar to how Cypress will retry assertions when they fail, test retries will allow you to automatically retry a failed test prior to marking it as failed. Read our new guide on Test Retries for more details.

Breaking Changes:

Please read our Migration Guide which explains the changes in more detail and how to change your code to migrate to Cypress 5.0.

• The cypress-plugin-retries plugin has been deprecated in favor of test retries built into Cypress. Addresses #1313.
• The Cypress.Cookies.defaults() whitelist option has been renamed to preserve to more closely reflect its behavior. Addressed in #7782.
• The blacklistHosts configuration has been renamed to blockHosts to more closely reflect its behavior. Addressed in #7622.
• The cy.server() whitelist option has been renamed to ignore to more closely reflect its behavior. Addresses #6642.
• libgbm-dev is now a requirement to run Cypress on Linux. Addressed in #7791.
• Values yielded by cy.setCookie(), cy.getCookie(), and cy.getCookies() will now contain the sameSite property if specified. Addresses #6892.
• The experimentalGetCookiesSameSite configuration flag has been removed, since this behavior is now the default. Addresses #6892.
• The return type of the Cypress.Blob methods arrayBufferToBlob, base64StringToBlob, binaryStringToBlob, and dataURLToBlob have changed from Promise<Blob> to Blob. Addresses #6001.
• Cypress no longer supports file paths with a question mark ? in them. We now use the webpack preprocessor by default and it does not support files with question marks. Addressed in #7982.
• For TypeScript compilation of spec, support, and plugins files, the esModuleInterop option is no longer coerced to true. If you need to utilize esModuleInterop, set it in your tsconfig.json. Addresses #7575.
• Cypress now requires TypeScript 3.4+. Addressed in #7856.
• Installing Cypress on your system now requires Node.js 10+. Addresses #6574.
• In spec files, the values for the globals __dirname and __filename no longer include leading slashes. Addressed in #7982.

Features:

• There's a new retries configuration option to configure the number of times to retry a failing test. Addresses #1313.
• .click(), .dblclick(), and .rightclick() now accept options altKey, ctrlKey, metaKey, and shiftKey to hold down key combinations while clicking. Addresses #486.
• You can now chain .snapshot() off of cy.stub() and cy.spy() to disabled snapshots during those commands. For example: cy.stub().snapshot(false). Addresses #3849.

Bugfixes:

• The error Cannot set property 'err' of undefined will no longer incorrectly throw when rerunning tests in the Test Runner. Fixes #7874 and #8193.
• Cypress will no longer throw a Cannot read property 'isAttached' of undefined error during cypress run on Firefox versions >= 75. Fixes #6813.
• The error Maximum call stack size exceeded will no longer throw when calling scrollIntoView on an element in the shadow dom. Fixes #7986.
• Cypress environment variables that accept arrays as their value will now properly evaluate as arrays. Fixes #6810.
• Elements having display: inline will no longer be considered hidden if it has child elements within it that are visible. Fixes #6183.
• When experimentalShadowDomSupport is enabled, .parent() and .parentsUntil() commands now work correctly in shadow dom as well as passing a selector to .parents() when the subject is in the shadow dom. Fixed in #8202.
• Screenshots will now be correctly taken when a test fails in an afterEach or beforeEach hook after the hook has already passed. Fixes #3744.
• Cypress will no longer report screenshots overwritten in a cy.screenshot() onAfterScreenshot option as a unique screenshot. Fixes #8079.
• Taking screenshots will no longer fail when the screenshot names are too long for the filesystem to accept. Fixes #2403.
• The "last used browser" will now be correctly remembered during cypress open if a non-default-channel browser was selected. Fixes #8281.
• For TypeScript projects, tsconfig.json will now be loaded and used to configure TypeScript compilation of spec and support files. Fixes #7006 and #7503.
• reporterStats now correctly show the number of passed and failed tests when a test passes but the afterEach fails. Fixes #7730.
• The Developer Tools menu will now always display in Electron when switching focus from Specs to the Test Runner. Fixes #3559.

Documentation Changes:

• We have a new guide on Test Retries.
• Our Migration Guide has a new section for 5.0 migration.

Misc:

• Cypress now uses the webpack preprocessor by default to preprocess spec files.
• The Runs tab within the Test Runner has a new improved design when the project has not been set up or login is required. Addressed in #8141.
• The type for the Window object returned from cy.window() is now correct. Addresses #7856.
• The type definition for Cypress's ApplicationWindow can now be extended. Addresses #7856.
• The type definition for reporterOptions has been added. Addresses #7877.

Dependency Updates

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 80 to 83. Addressed in #7791.
• Upgraded bundled Node.js version from 12.8.1 to 12.14.1. Addressed in #7791.
• Upgraded chalk from 2.4.2 to 4.1.0. Addressed in #7650.
• Upgraded cli-table3 from 0.5.1 to 0.6.0. Addressed in #7650.
• Upgraded electron from 8.3.1 to 9.2.0. Addressed in #7791 and #8235.
• Upgraded execa from 1.0.0 to 4.0.2. Addressed in #7650.
• Upgraded express from 4.16.4 to 4.17.1. Addressed in #8179.
• Upgraded fs-extra from 8.1.0 to 9.0.1. Addressed in #7650.
• Upgraded log-symbols from 3.0.0 to 4.0.0. Addressed in #7650.
• Upgraded tmp from 0.1.0 to 0.2.1. Addressed in #7650.

Released 8/5/2020

Bugfixes:

• The error Cannot set property 'err' of undefined will no longer incorrectly throw when rerunning tests in the Test Runner. Fixes #7874.
• Skipping the last test before a nested suite with a before hook will now correctly run the tests in the suite following the skipped test. Fixes #8086.

Dependency Updates:

• Upgraded md5 from 2.2.1 to 2.3.0. Addressed in #8161.
• Upgraded electron-context-menu from 0.15.1 to 2.2.0. Addressed in #8180.

Released 8/3/2020

Features:

• Now you can control whether screenshots are automatically taken on test failure during cypress run by setting screenshotOnRunFailure in your configuration. Addresses #5029.
• The pluginsFile now has access to a readonly version property within the config object that returns the current Cypress version being run. This will allow plugins to better target specific Cypress versions. Addresses #6352.
• During cypress open, you can now run a subset of all specs by entering a text search filter and clicking 'Run n tests'. Addresses #6581.

Bugfixes:

• position: fixed elements that have a parent with pointer-events: none will now correctly evaluate as visible. Fixes #6675.
• Applications using custom elements will no longer trigger infinite XHR request loops. Fixes #1068.
• When snapshotting the DOM, Cypress no longer causes attributeChangedCallback to be triggered on custom elements. Fixes #7187.
• Spec files containing + characters now properly run in Cypress. Fixes #5909.
• When using the fx shortcut in cy.route(), an error is now thrown when the fixture file cannot be found. Fixes #7818.
• Cypress no longer thrown Cannot read property '__error' of null error when passing a file containing null content to cy.fixture(). Fixes #8010.
• Values containing exponential operators passed to --env via the command line are now properly read. Fixes #6891.
• The "Open in IDE" button no longer disappears from hooks when the tests are manually rerun. Fixes #8094.
• When experimentalSourceRewriting is enabled, AST rewriting will no longer return an output before the body is done being written. This would happen when the response body was too large and the response would be sent while the body was still being modified. Fixes #8043.
• When using .type(), Cypress now properly types into an input within an iframe that auto focuses the input. Fixes #8111.

Misc:

• Dependencies for our cypress npm package are no longer pinned to a specific version. This allows the use of npm audit fix to fix security vulnerabilities without needing a patch release from Cypress. Addresses #8046.
• We now collect environment variables for AWS CodeBuild when recording to the Dashboard. Addressed #8101.
• Types inside Module API are now accessible via the CypressCommandLine namespace. Addresses #7309.
• We added more type definitions for the .should() command. Addresses #5573.
• Cookie command's expiry property type is now a Number instead of a String. Addresses #8144.
• There are some minor visual improvements to the Test Runner's Command Log when hovering, focusing and clicking on hook titles and pending tests. Addressed in #8153.

Dependency Updates:

• Upgraded jimp from 0.13.0 to 0.14.0. Addressed in #8102.
• Upgraded moment from 2.26.0 to 2.27.0. Addressed in #8122.

Released 7/21/2020

Features:

• You can now pass an ensureScrollability: false option to .scrollTo() to skip checking whether the element is scrollable. Addresses #1924.
• cy.clock() now accepts Dates as well as a Number for now. Fixes #7786.

Bugfixes:

• Running multiple specs within Firefox during cypress run on Windows will no longer fail trying to make a connection to the browser. Fixes #6392.
• Cypress will no longer throw a Cannot read property 'isAttached' of undefined error during cypress run on Firefox versions >= 75. Fixes #6813.
• Fixed an issue where Cypress tests in Chromium-family browsers could randomly fail with the error "WebSocket is already in CLOSING or CLOSED state." Fixes #7180.
• Taking a screenshot of an element that changes height upon scroll will no longer throw an invalid for option "size" error. Fixes #6099.
• Setting viewportHeight or viewportWidth from within the test configuration now properly changes the viewport size for the duration of the suite or test.
• Setting deep objects and arrays on config within the pluginsFile now sets the values correctly. Fixes #7959.
• The progress bar for cy.wait() now reflects the correct requestTimeout and responseTimeout of the command. Fixes #7881.
• The command's progress bar will not longer restart when its parent test is collapsed in the Command Log. Fixes #7912.
• Key value pairs sent to ELECTRON_EXTRA_LAUNCH_ARGS as key=value will now be properly read in. Fixes #7994.
• Stubbed responses responding with an empty string to cy.route() now correctly display as 'xhr stub' in the Test Runner's Command Log. Fixes #8018.
• Quickly reclicking the "Run All Tests" button in the Test Runners' Command Log will no longer throw errors about undefined properties and the tests will no longer hang. Fixes #7968.

Misc:

• The error messages thrown from pluginsFile and supportFile now mention that .ts extensions are supported. Addresses #7940.
• The style when focusing on tests in the Command Log has been updated. Addresses #7855.

Dependency Updates:

• Upgraded @benmalka/foxdriver from 0.4.0 to 0.4.1. Addressed in #8040.
• Upgraded firefox-profile from 1.3.1 to 2.0.0. Addressed in #8000.
• Upgraded fix-path from 2.1.0 to 3.0.0. Addressed in #8028.
• Upgraded human-interval from 0.1.6 to 1.0.0. Addressed in #8031.
• Upgraded lodash from 4.17.15 to 4.17.19. Addressed in #7954.
• Upgraded plist from 2.1.0 to 3.0.1. Addressed in #8045.
• Upgraded proxy-from-env from 1.0.0 to 1.1.0. Addressed in #7900.
• Upgraded resolve from 1.13.1 to 1.17.0. Addressed in #7989.
• Upgraded systeminformation from 4.21.1 to 4.26.9. Addressed in #7975.
• Upgraded uuid from 3.3.2 to 8.2.0. Addressed in #7976, #8002, and #8011.

Released 7/7/2020

Features:

• You can open a before, beforeEach, after, and afterEach hook definition in your IDE from the Test Runner's Command Log by clicking the Open in IDE button. Addresses #7793.
• before, beforeEach, after, and afterEach hook definitions now display separately in the Test Runner's Command Log when defined in separate hook definitions. Addresses #7779.
• You can now open a spec file directly from the Tests tab in the Test Runner by clicking the Open in IDE button. Addresses #7713

Bugfixes:

• HTTP requests taking longer than the default responseTimeout will no longer be prematurely canceled by the Cypress proxy layer. Fixes #6426.
• Using Cypress commands to traverse the DOM on an application with a global parent variable will no longer throw Illegal Invocation errors. Fixes #6412.
• When experimentalShadowDomSupport is enabled, using .type() on an input in the Shadow DOM will not result in an error. Fixes #7741.
• When experimentalShadowDomSupport is enabled, checking for visibility on a shadow dom host element will no longer hang if the host element was the foremost element and had an ancestor with fixed position. Fixes #7893.
• Debug logs from the @benmalka/foxdriver module will no longer appear if any DEBUG environment variable was set. Fixed #7723.

Misc:

• We made some minor UI updates to the Test Runner. Addresses #7732 and #7803.

Dependency Updates:

• Upgraded recast from 0.18.8 to 0.19.1. Addressed in #7898.

Released 6/23/2020

Features:

• An animated progress bar now displays on every command in the Command Log indicating how long the command has left to run before reaching its command timeout. Addresses #7642.
• There is now an experimentalFetchPolyfill configuration option. When this option is true, Cypress will automatically replace window.fetch with a polyfill that Cypress can spy on and stub. Addresses #7710.
• You can now pass a --quiet flag to cypress run to silence any Cypress specific output from stdout. Addresses #7714.

Bugfixes:

• cy.wait() now correctly resolves when waiting for XHR requests that contain resource-like text in the XHR's query params or hash (like .js, .html, .css). #7280.
• We fixed a regression in 4.6.0 where errors thrown from the application under test as strings would not be correctly handled. Fixes #7590.
• We fixed a regression in 4.8.0 where .click() would hang if the subject had a shadow root and experimentalShadowDomSupport was not enabled. Fixes #7679.
• We fixed a regression in 4.6.0 so that .should('have.value') now properly asserts against <progress>, <meter> or <li> element's values. Fixes #7603.
• Cypress no longer responds with 413 responses during a recorded cypress run when the stdout is too large. Fixes #7548.
• We fixed an issue where Cypress could exit successfully even with failing tests when launched in global mode. Fixes #7755.
• Assertion logs now properly display as parent commands in the Command Log regardless of what is in the beforeEach hook. Fixes #7731.
• When experimentalShadowDomSupport is enabled, querying shadow dom in certain situations will no longer cause the error Cannot read property 'length' of undefined during cypress run. Fixes #7676.
• Highlighting of elements upon hover of a command in the Command Log are now visible when targeting absolute positioned elements. Fixes #7762.
• cypress run will no longer crash when provided an empty string to the --project flag. Fixes #7743.

Misc:

• There is now a loading state to indicated when tests are loading in the Command Log. Addresses #7700.
• The type definitions for fixturesFolder, pluginsFile, screenshotsFolders and videoCompression have been updated to allow false TypeScript types. Addresses #7654.
• The type definitions for cy.wait(ms) now correctly yield the type of the previous subject. Addresses #7682.
• The type definitions now allow for the 'key' keyword when chaining off 'any' or 'all' assertion chainers. Addresses #7665.

Dependency Updates:

• Upgraded arch from 2.1.1 to 2.1.2. Addressed in #7672.
• Upgraded eventemitter2 from 4.1.2 to 6.4.2. Addressed in #7705 and #7707.
• Upgraded getos from 3.1.1 to 3.2.1. Addressed in #7685.
• Upgraded is-installed-globally from 0.1.0 to 0.3.2. Addressed in #7703.
• Upgraded jimp from 0.12.0 to 0.13.0. Addressed in #7618.
• Upgraded moment from 2.24.0 to 2.26.0. Addressed in #7718.
• Upgraded signal-exit from 3.0.2 to 3.0.3. Addressed in #7738.

Released 6/8/2020

Features:

• You can now apply certain test configuration for the duration of a suite or test by passing a configuration object to the test or suite as the second argument. Addresses #7167.
• Cypress.isBrowser() has been expanded to allow for new matcher arguments to assist in filtering matching browsers. Addresses #7168.
• We now display the currently running file at the top of the Test Runner's Command Log. That file can be opened in your preferred file opener by clicking the file. Addresses #7506.
• We added experimental shadow DOM support through the experimentalShadowDomSupport option. See the Experiments page for more information. Addresses #144.

Bugfixes:

• Upon domain navigation, before and after hooks defined in completed suites no longer erroneously rerun. Fixes #1987.
• Errors thrown within root level after hooks now correctly display in the Test Runner's Command Log. Fixes #2296.
• We fixed a regression in 4.6.0 where an XHR response without a body would cause Cypress to throw Cannot read property '__error' of null. Fixes #7518.
• We fixed a regression in 4.6.0 where using cy.visit() to an authenticated URL would error with Request cannot be constructed from a URL that includes credentials: /__cypress/runner/./wasm/mappings.wasm Fixes #7481.
• We now properly load code from the pluginsFile or supportFile when they are TypeScript files. Fixes #7459.
• utf-8 characters now properly display within error code frames. Fixes #7507.
• Errors thrown in a cy.on('fail', fn) fail handler now display a stack trace and code frame pointing to the origin of the error. Fixes #7512.
• .click() now properly clicks on wrapped inline elements when the first child element in the parent element has no width or height. Fixes #7434 and #7012.
• cy.wrap() now properly respects the timeout option. It also better handles situations when passed a promise that never resolves. Fixes #5980.
• When experimentalComponentTesting is enabled, Cypress will no longer exit with SIGABRT in certain situations. Fixes #7572.
• We fixed a regression in 3.8.0 where the "Tests" button in the Test Runner wouldn't take you back to the tests list in all browsers. Fixes #5948.
• Using the S shortcut during .pause() no longer does anything. This prevents the Test Runner from getting into a 'stuck' state. Fixes #6867.

Misc:

• The design of errors and some iconography displayed in the Test Runner's Command Log have been updated. Addresses #7499, #7542 and #7563.
• The commands in the Test Runner's Command Log now display in the same casing as the original command. Addresses #5773.
• The navigation links in the Test Runner now display the correct CSS styles when focused. Addresses #7491.
• Cypress.config() now has TypeScript types for the taskTimeout option. Addresses #7531.
• TypeScript types for cy.screenshot() options and Cypress.log() have been updated to be more accurate. Addresses #7445.
• TypeScript types for Cypress.automation have been added. Addresses #7519.
• We now display a more accurate error message when passing a browser to the --browser flag that is not supported by Cypress. Addresses #6979.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #7588 and #7591.

Dependency Updates:

• Upgraded chrome-remote-interface from 0.28.1 to 0.28.2. Addressed in #7615.
• Upgraded electron from 8.3.0 to 8.3.1. Addressed in #7599.

Released 5/26/2020

Features:

• cy.request() now supports an encoding option that can be used to set the encoding of the response body, defaulting to utf-8. Addresses #2029 and #3576.

Bugfixes:

• We fixed a regression in 4.6.0 where the address bar of the application under test would disappear when scrolling commands ran and the application under test would visually shift after taking screenshots. Fixes #7443 and #7466.
• We fixed a regression where test runs could hang when loading spec files with source maps. Fixes #7464.

Misc:

• We now display a more descriptive error message when the plugins file does not export a function. Addresses #6611.

Released 5/20/2020

Features:

• Errors in the Test Runner now display a code frame to preview where the failure occurred with the relevant file, line number, and column number highlighted. Clicking on the file link will open the file in your preferred file opener and highlight the line and column in editors that support it. Addresses #3762.
• Cypress now utilizes source maps to enhance the error experience. Stack traces are translated so that your source files are shown instead of the generated file that is loaded by the browser. Cypress will include an inline source map in your spec file. If you modify the preprocessor, ensure that inline source maps are enabled to get the same experience. Users of @cypress/webpack-preprocessor should upgrade to v5.4.1 or later of the package which will correctly inline source maps. Addresses #881, #1761 and #3966.
• Cypress now enables AST-based JS/HTML rewriting when setting the experimentalSourceRewriting configuration option to true. Addresses #5273.
• Number arguments passed to have.text, have.id, have.data, have.value, and have.attr assertions chainers are now automatically cast to strings for comparison. Addresses #7314.

Bugfixes:

• Default TypeScript options are now set to module: commonJS which Node.js and the browser expect. This fixes a situation where setting a different module in a tsconfig.json would cause errors to throw if you had export, import or async keywords in your code. Fixes #7005, #7011, #7043, and #7151.
• When experimentalSourceRewriting is enabled, setting location or location.href to a relative href, or using location.replace or location.assign with a relative href will no longer navigate the AUT to the wrong URL. Fixes #3975 and #3994.
• When experimentalSourceRewriting is enabled, the use of window.top and window.parent will no longer cause the AUT to break out of the Cypress iframe. Fixes #5271 and #1467.
• When experimentalSourceRewriting is enabled, calls to window.frames, window.parent.frames, and other frames will no longer point to the wrong reference after being proxied through Cypress. Fixes #2664.
• When experimentalSourceRewriting is enabled, scripts using the integrity attribute for sub-resource integrity (SRI) will now load after being proxied through Cypress. Fixes #2393.
• When experimentalSourceRewriting is enabled, the use of document.location to set the URL will no longer navigate the AUT to the wrong URL. Fixes #7402.
• Type definitions will no longer conflict when running Cypress in a project with Jest. Fixes #3536.
• We increased the timeout for launching Firefox from 2.5 seconds to 50 seconds. Previously, users hitting this limit would encounter a "cannot open socket" error; now, the error will be wrapped. Fixes #7159.
• .click will now click in the correct coordinates when either x or y coordinate options are zero. Fixes #7319.
• Cypress no longer displays onError is not a function when a browser can't connect. Fixes #7217.
• You can now pass the force: true option to .select() to select options within a disabled <select>. Addresses #107.
• We now throw an error when attempting to .select() an <option> within a disabled <optgroup>. Fixes #7226.
• We fixed a regression in 4.3.0 where the message output during errors were not formatted correctly. Fixes #6924.
• Using Cypress._.capitalize now correctly behaves the same as Lodash's capitalize method. Fixes #7222.
• When experimentalComponentTesting is enabled, clicking on a component spec now watches the correct file without assuming it is an integration file. Fixes #7244.
• Firefox video recording no longer crashes Cypress when running very short spec files. Fixes #6408.
• Applications containing a DOM element with an id attribute containing 'jquery' will no longer throw an error during cy.visit(). Fixes #6193.
• Long errors generated when compiling or bundling the test file are now horizontally scrollable. Fixes #6898.

Misc:

• Cypress no longer requires write access to the root of the project, it instead will display a warning when no write access is given. Addresses #1281.
• We increased the timeout for launching Chrome from 20 seconds to 50 seconds. Addressed in #7372.
• We increased the timeout for macOS or Linux to exit from a --version command when looking for available browsers from 5 seconds to 30 seconds. Addressed in #7366.
• We improved error handling when Cypress launches Chromium-family browsers. Addresses #6518.
• We now export Cypress.ConfigOptions types as a partial of the full options interface. Addresses #7238.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #7162, #7216, #7227, #7320, #7232, and #7345.

Dependency Updates:

• Upgraded @cypress/browserify-preprocessor from 2.2.2 to 2.2.3. Addressed in #7291.
• Upgraded cookie-parser from 1.4.4 to 1.4.5. Addressed in #7389.
• Upgraded cypress-multi-reporters from 1.2.4 to 1.4.0. Addressed in #7431.
• Upgraded electron from 8.2.3 to 8.3.0. Addressed in #7236 and #7387.
• Upgraded image-size from 0.7.4 to 0.8.3. Addressed in #7236.
• Upgraded jimp from 0.9.3 to 0.12.0. Addressed in #7408.
• Upgraded return-deep-diff from 0.3.0 to 0.4.0. Addressed in #7292.

Released 4/28/2020

Features:

• Cypress now supports the execution of component tests using framework-specific adaptors when setting the experimentalComponentTesting configuration option to true. For more details see the cypress-react-unit-test and cypress-vue-unit-test repos. Addresses #5922 and #6968.

Bugfixes:

• Custom Mocha reporters will now correctly use the version of Mocha bundled with Cypress. Fixes #3537 and #6984.
• We better account for word boundaries in application scripts when modifyObstructiveCode is true. Fixes #7138.
• Fixed an issue where iterators in TypeScript were not properly transpiled. Fixes #7098.

Misc:

• The update window in the Test Runner now encourages yarn users to yarn upgrade Cypress instead of yarn add to help prevent installing 2 versions of Cypress when using yarn workspaces. Addressed in #7101.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #7031 and #7097.

Dependency Updates:

• Upgraded electron from 8.2.0 to 8.2.3. Addressed in #7079.

Released 4/20/2020

Bugfixes:

• Cypress can now launch on systems where Chromium is installed via Snapcraft. Fixes #7020.
• We now check whether the mouseup event's target element is detached before issuing the click event during .click(). Fixes #6923.
• We fixed a regression in 3.8.1 where the Test Runner could send an undefined organization ID during project setup when the default organization is preselected. Fixes #7013.
• We fixed a regression in 4.4.0 that caused projects to include bundled TypeScript. Fixes #7036.
• Fixed an issue where sites that set Feature-Policy: document-domain 'none' headers would fail to load in Cypress. Fixes #6480.

Misc:

• We fixed some extra spacing displaying below the project nav in the Test Runner. Addresses #7023
• The typings for run results when using the Module API now indicate they can be null or undefined. Addresses #6126.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #7004.

Released 4/13/2020

Features:

• TypeScript test files are now supported without using special preprocessors plugins. Addresses #1859.

Bugfixes:

• We fixed an issue where Cypress could crash with a This socket has been ended by the other party error when testing applications that make use of WebSockets. Fixes #6458.
• Uncaught errors thrown from within application or test code now display their proper stack trace. Fixes #6964.
• Assertion errors now include a stack trace that includes the calling code. Fixes #6969.
• We now clone the options object passed into Cypress commands so that they're not mutated and receive the proper options. Fixes #3171.
• We fixed an issue where invalid Set-Cookie values could cause requests to fail with a cannot read property key of undefined error. Now, invalid Set-Cookie values will be ignored. Fixes #6890.

Misc:

• Cypress no longer hides output from cypress --version, cypress version, cypress cache path, or cypress cache list commands when npm log level is silent or warn. Addresses #2705.
• The cy.task() error message is now more specific about the promise resolution value required. Addresses #6241.

Dependency Updates:

• Upgraded http-proxy from 1.17.0 to 1.18.0. Addressed in #6934.

Released 3/30/2020

Features:

• Errors shown in the Test Runner have a new design including an expandable stack trace, better highlighting of code elements, and 'Learn more' links that link to relevant Cypress documentation. This is part of our larger improvements to error display with more exciting features to come. Addresses #3762.
• When you open a Cypress project, clicking on the Settings tab and clicking into the Experiments panel will display the experimental features that are available and whether they are enabled for your project.
• Added support for setting cookie sameSite values via cy.setCookie(). Addresses #2437.
• Added experimental support for adding sameSite values to the objects yielded from cy.setCookie(), cy.getCookie(), and cy.getCookies(). Users can enable this by setting the experimentalGetCookiesSameSite configuration value to true. In Cypress 5, this will be the default. Addresses #2437.
• Added support for the SameSite cookie attribute in cy.request(), cy.visit(), and proxied HTTP requests. Addresses #6757.
• When an assertion is retried (using .should()) and fails, it now shows the diff in the stdout. Addresses #6722.

Bugfixes:

• Fixed a regression in 4.2.0 where cypress installation could fail if Git is not installed. Fixes #6752.
• Fixed a regression in 3.5.0 where certain HTTP requests could fail with Parse Error: Invalid header value char or Parse Error: Header overflow. Fixes #5602.
• Fixed a regression in 4.2.0 where Electron deprecation warnings were printed to stderr in open mode. Fixes #6750.
• Cookies set with a Domain containing an unknown TLD are now sent along for all requests. For example, a cookie like foo=bar; Domain=.cypress.test will now be sent during cy.request() to http://local.cypress.test. Fixes #6628.
• We fixed a situation where a cross-origin errors could incorrectly throw in Chrome. Fixes #5270.
• Visibility checks against vue-fragment elements no longer throw an unexpected error. Fixes #6745.
• The stack trace is now properly shown in the console when clicking the command for tests having an .only that throw an error. Fixes #6744.
• firefoxGcInterval can now correctly be set to null. Fixes #6825.
• Cypress will no longer crash the process if an empty video chunk is received. Addressed in #6818.
• Assertions failures on DOM elements no longer show unexpected diffs when they weren't retried. Fixes #6723.

Misc:

• Security warnings no longer show in Mac OS when opening Cypress since our application now undergoes notarization from Apple. Addresses #5791.
• The previously used spec filter in the Test Runner is now saved and restored for projects without an ID. Addresses #6739.
• We collect more env information from Travis builds for potential use in the Cypress Dashboard. Addresses #6808.
• We now collect env information from Netlify builds (for example when using {% url "cypress-io/netlify-plugin-cypress" https://github.com/cypress-io/netlify-plugin-cypress) to send along to the Cypress Dashboard. Addresses #6780.
• Type added for tag property when using Module API. Addresses #6795.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #6833.

Dependency Updates

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 80.0.3987.141 to 80.0.3987.158. Addressed in #6855.
• Upgraded electron from 8.1.1 to 8.2.0. This bumps the bundled Chromium to 80.0.3987.158. Addressed in #6855.
• Upgraded @benmalka/foxdriver from 0.2.3 to 0.3.0. Addressed in #6592.
• Upgraded @cypress/get-windows-proxy from 1.6.0 to 1.6.1. Addressed in #6823.
• Upgraded execa from 1.0.0 to 4.0.0. Addressed in #6013.
• Upgraded extract-zip from 1.6.7 to 1.7.0. Addresses #6845 in #6845.
• Upgraded firefox-profile from 1.3.0 to 1.3.1. Addressed in #6594.
• Upgraded get-port from 5.1.0 to 5.1.1. Addressed in #6854.
• Upgraded mime from 1.6.0 to 2.4.4. Addressed in #6764.
• Upgraded minimist from 1.2.2 to 1.2.5. Addressed in #6747.
• Upgraded squirrelly from 7.7.0 to 7.9.2. Addressed in #6735.

Released 3/16/2020

Features:

• Videos can now be recorded when running Electron in --headed mode. Addresses #1767.
• cypress cache list now prints the last time the cached binary was accessed for each version present. Addresses #6682.

Bugfixes:

• We fixed a regression in 3.8.3 where HTTPS requests could experience slowdown. Fixes #6659.
• We now detect some installations of Firefox that were previously undetected. Fixes #6669.
• We fixed a race condition where an asynchronous error could fail to be caught when running the plugins file process. Fixes #6570.
• We now more thoroughly ensure the parent of an element exists when recursively calling actionability checks in order to prevent some maximum call stack errors. Fixes #6707.
• Specfiles containing & or % characters now correctly run instead of erroring. Fixes #4210.
• We added support for running tests on Jira plugins even when Jira scripts were not minified. Fixes #1436.
• We fixed a bug causing specs to hang after rerunning tests during cypress open when there was an exception if thrown in an after hook. Fixes #6619.
• cypress verify no longer incorrectly prints messaging about this being the first time using that Cypress version. Fixes #6607.
• Screenshots no longer fail to be taken in Electron when Cypress DEBUG logs are enabled. Fixes #6662.

Misc:

• A warning is now printed when setting the reserved key CYPRESS_INTERNAL_ENV to a non-production value. Addresses #6436.
• When DEBUG logs are printed from cypress:launcher, they now print a clearer log during browser detection for easier reading. Addresses #6700.
• The Test Runner now renders ANSI colors when there is a syntax error in the spec file. Addresses #6533.
• The Test Runner now has an icon indicating whether the specs list parent folder is collapsed. Addresses #6277.
• There's better type information for .click, .dblclick, and .rightclick command's position argument. Addresses #6341.
• There's a more robust type signature for .its() and .invoke(). Addresses #6431.
• Using Cypress.dom.isDetached no longer throws a type error in TypeScript projects. Addresses #4408.
• Using cy.clearLocalStorage({ log:false }) no longer throws a type error in TypeScript projects. Addresses #6615.
• We added types for Cypress.sinon. Addresses #6720.
• We've added the foundational work required to support experimental features in the Test Runner. Addresses #6257.

Dependency Updates

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 78 to 80. Addressed in #6555.
• Upgraded electron from 7.1.13 to 8.1.1. This bumps the bundled Chromium to 80.0.3987.141 and the bundled Node to 12.13.0. Addressed in #6555.
• Upgraded @ffmpeg-installer/ffmpeg from 1.0.19 to 1.0.20. Addressed in #6686.
• Upgraded minimist from 1.2.0 to 1.2.2. Addressed in #6726.
• Replaced deprecated request with cypress-io/request. Addressed in #6679.

Released 2/28/2020

Features:

• There is a new cypress info command to see the locally detected browsers and other information related to Cypress. Addresses #4540.
• You can now click a 'Try Again' button to recheck if the server at the designated baseUrl is running within the warning message during cypress open. Addresses #3284.
• There are "collapse all" and "expand all" links in the Test Runner's "Tests" tab to collapse or expand all folders within the "Integration Tests". Addresses #6282.
• The plugins file function's config argument now includes projectRoot (absolute path to the root of the project) and configFile (absolute path to the configuration file). Addresses #5941.

Bugfixes:

• Fixed a regression where Cypress could throw a "Maximum call stack size exceeded" error when transmitting a circular object over the internal WebSocket. Fixes #6582.
• We fixed an issue where using Chromium-family browsers could cause Cypress to throw a "WebSocket is not open: readyState 3" error under certain conditions. Fixes #5685.
• We now more thoroughly ensure the parent of an element exists when recursively calling visibility and existence checks in order to prevent some maximum call stack errors. Fixes #4373.
• We fixed an issue where a maximum call stack error would throw in some circumstances when xhr.onreadystatechange is accessed. Fixes #5864.
• We fixed a regression in 3.5.0 where typing into an iframe with a body element with the contenteditable attribute would throw an error. Fixes #5930.
• We now set the default window size when running Chrome headlessly to 1280x720. Fixes #6210.
• We fixed an issue where cypress install would not complete on Node.js 8.0.0. Fixes #6512 and #6568.
• {% url "cy.clearLocalStorage()" clearlocalstorage now properly accepts the log option to disable logging. Fixes #6342.

Misc:

• The error messages displayed when rerouting to a non same-origin domain has been updated to more accurately reflect the rules around same-origin policy. Addresses #6048.
• We fixed an error message that would display the wrong available browser families during validation. Addressed in #6517.
• We fixed some typos in some of our error messages. Addressed in #6508.
• We're collecting more environment variables when running Cypress with GitLab CI. Addresses #6231.
• The typing of cy.$$ has been updated to distinguish differences between it and Cypress.$. "More info here" $#Cypress-vs-cy Addresses #2027.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #6552, #6523, and #6545.

Dependency Updates

• Upgraded electron from 7.1.10 to 7.1.13. Addressed in #6566.

Released 2/14/2020

Bugfixes:

• Fixed a bug where Firefox tests could fail to run on macOS if another instance of Firefox was open. Addresses #6380.
• Updated @cypress/browserify-preprocessor to 2.1.4, fixing a regression involving non-top-level require()s in tests. Addresses #6403.
• Fixed a bug where re-running a failed workflow in GitHub Actions would not generate a new Dashboard run. Addresses #6450.
• Fixed incorrect type definitions for Cypress.isBrowser. Addresses #6447.
• Fixed a regression introduced in 4.0.0 where using .should('contain', ...) on a cy.contains() would produce unexpected results. Addresses #6384.

Misc:

• Improved the error experience GUI when launching a browser fails. Addresses #6432.
• Improved the error experience when visiting the Cypress server outside of a Cypress-launched browser. Addresses #6435.

Released 2/7/2020

Bugfixes:

• Fixed a bug where Chromium could not be detected on macOS. Addresses #6358.
• Fixed bugs where Edge and Firefox Nightly could not be detected on macOS. Addresses #6354 and #6345.
• Fixed a bug where 64-bit editions of Firefox could not be detected on Windows. Addresses #6355.
• Fixed a bug where video recordings of Firefox would omit all frames from before the last cross-domain navigation of the test. Addresses #6369.
• Fixed a bug where Cypress could crash with the message "cannot read property 'on' of undefined" while running Firefox. Addresses #6356.
• Corrected a link to the screenshot API documentation in the type definitions. Addresses #6359.

Misc:

• Updated the default preferences set on Firefox to hide update notifications and otherwise improve the Firefox experience. Addresses #6346.

Released 2/6/2020

Summary:

Cypress 4.0.0 includes support for Mozilla Firefox browsers (beta support) and Microsoft Edge (Chromium based) browsers which is a big step forward for Cross Browser Testing in Cypress. We've also updated many of the underlying tools behind Cypress that bring new powerful features.

Breaking Changes:

:warning: Please read our Migration Guide which explains the changes in more detail and how to change your code to migrate to Cypress 4.0.

• Mocha, Chai, and Sinon.JS has been upgraded which includes a number of breaking changes and new features. Addresses #2528, #2529, #2866.
• During before:browser:launch, we no longer yield the second argument as an array of browser arguments and instead yield an options object with an args property in order to support more advanced browser launch options. Addresses #6306.
• We updated the Cypress browser objects of all Chromium-based browsers, including Electron, to have chromium set as their family field. Addresses #6243.
• The --browser flag no longer accepts canary as its sole argument to run Chrome Canary. You now have to specify chrome:canary to use the Chrome Canary browser. Addresses #6243.
• cy.writeFile() now yields null instead of the contents written to the file in order to more align with the behavior of fs. Addresses #2466.
• Installing Cypress on your system now requires Node.js 8+. Addresses #5632.
• Cypress no longer support CJSX. Addresses #3469.

Features:

• Mozilla Firefox browsers now have beta support. Addresses #1096.
• Microsoft Edge (Chromium based) browsers are now supported. Addresses #5433.
• There is a new Cypress.isBrowser() utility function. Addresses #2023.
• We updated the Cypress.browser object with a new channel property which contains the release channel of the detected browser. Addresses #6243.
• Appending .only to multiple tests or suites will now run all tests with the .only property. Addresses #2828.
• The isFinite assertion is now supported. Addresses #5669.
• The empty assertion is now supported when used against Map objects. Addresses #6072.
• The nested assertion chainer property is now supported. Addresses #3080 and #5004.

Bugfixes:

• A test or suite appended with an .only when multiple tests or suites contained the same title now run correctly. Fixes #5345.
• The .its() command now properly supports 0 as a value for indexes or object keys. Fixes #6216.

Documentation Changes:

• Added Cross Browser Testing Guide with helpful CI strategies to consider when running tests across multiple browsers.
• Added Cypress.isBrowser() doc.

Misc:

• We now pass through errors caused when attempting to read arguments passed through config. Addresses #6279.
• We fixed a broken 'Learn more' link within the Node.js Version panel of the Test Runner Settings. Addresses #6237.
• The browser icons in the Test Runner now display as images with the proper branding. Addresses #6188.
• We updated the styling of browser dropdown in the Test Runner to look more like a button. Addresses #6298.
• The timer in the Test Runner now always displays at a consistent length. Addresses #6168.
• You can print debug information about the memory & CPU usage of Cypress, which can be accessed by enabling the cypress:server:util:process_profiler debug stream. Addresses #6169.
• We added types for plugin events. Addresses #6322.

Dependency Updates

• Added @benmalka/foxdriver. Addressed in #1359.
• Upgraded @cypress/browserify-preprocessor from 1.1.2 to 2.1.1. Addressed in #4308 and #4226.
• Upgraded bluebird from 3.5.0 to 3.7.2. Addressed in #4226.
• Upgraded cachedir from 1.3.0 to 2.3.0. Addressed in #4208 and #4226.
• Upgraded chai from 3.5.0 to 4.2.0. Addressed in #2862 and #4226.
• Upgraded chai-as-promised from 6.0.0 to 7.1.1. Addressed in #4226.
• Upgraded chalk from 2.4.0 to 3.0.0. Addressed in #4226.
• Upgraded commander from 2.15.1 to 4.0.1. Addressed in #4208 and #4226.
• Upgraded debug from 2.15.1 to 4.0.1. Addressed in #4226.
• Upgraded execa from 0.10.0 to 3.3.0. Addressed in #4226.
• Added firefox-profiler. Addressed in #1359.
• Added foxdriver. Addressed in #1359.
• Upgraded fs-extra from 5.0.0 to 8.1.0. Addressed in #4226.
• Upgraded getos from 3.1.1 to 3.1.4. Addressed in #4226.
• Upgraded is-ci from 1.2.1 to 2.0.0. Addressed in #4226.
• Upgraded mocha from 2.5.3 to 7.0.1. Addressed in #2703 and #4226.
• Upgraded listr from 0.12.0 to 0.14.3. Addressed in #4226.
• Upgraded log-symbols from 2.2.0 to 3.0.0. Addressed in #4226.
• Added marionette-client. Addressed in #1359.
• Upgraded ramda from 0.24.1 to 0.26.1. Addressed in #4226.
• Upgraded sinon from 3.2.0 to 8.1.1. Addressed in #2881 and #4226.
• Upgraded strip-ansi from 3.0.1 to 6.0.0. Addressed in #1359.
• Added systeminformation. Addressed in #1359.
• Upgraded support-colors from 5.5.0 to 7.1.0. Addressed in #4208 and #4226.
• Upgraded untildify from 3.0.3 to 4.0.0. Addressed in #4226.

Released 1/24/2020

Bugfixes:

• We fixed an error during cypress run indicating could not find CRI target when Cypress was unable to find the tab to control. Fixes #6053.
• HTTP requests to sites using a TLS version lower than 1.2 now no longer fail. Fixes #5446.
• cypress verify will no longer error on some systems when -screen is not defined. Fixes #6184.
• We fixed a regression in 3.5.0 causing cy.type({ force: true }) to no longer forcibly type characters for readonly inputs. Fixes #6116.
• Generated reports when using custom reporters now have a defined file property. Fixes #1495.

Misc:

• Messages from cy.get() are now truncated at 50 lines the Command Log instead of the 1 line. Addresses #6145.
• We now collect more environment variables for Bamboo CI when recording for the Dashboard. Addresses #4895.

Dependency Updates:

• Upgraded electron from 7.1.9 to 7.1.10. Addressed in #6242.
• Upgraded electron from 7.1.7 to 7.1.9. Addressed in #6180.
• Upgraded http-status-codes from 1.3.2 to 1.4.0. Addressed in #6134.
• Upgraded socket.io and socket.io-client from 2.2.0 to 2.3.0. Addressed in #6179.

Released 01/10/2020

Bugfixes:

• We fixed a regression in 3.8.0 on Linux when unzip is not installed where the progress of cypress install would show up to 200%. Fixes #5967
• Child elements of an element that uses both transform and height or width are now properly seen as visible during visiblity checks. Addresses #5974.
• We now properly check backface visibility when the parents of a target element have the CSS style transform-style: preserve-3d. Fixes #5682.
• DOM elements with a width or height of 0 and overflow: hidden are now properly calculated as invisible during visibility checks. Fixes #6093.
• We fixed a regression in 3.7.0 where using .type() on number inputs to type non-number characters would not type the correct value. Fixes #6055.

Misc:

• Messages from cy.log() are now truncated at 50 lines the Command Log instead of the 1 line. Addresses #5625.
• We now capture GitLab CI's CI_JOB_NAME environment variable. Addressed in #6111.
• Types for event emitters removeListener and removeAllListeners have been added to Cypress and cy. Addresses #5228.
• Types for the runUrl property returned from cypress.run() has been added. Addresses #6087.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #5947 and #6075.

Dependency Updates:

• Upgraded ansi_up from 4.0.3 to 4.0.4. Addressed in #6074.
• Upgraded electron from 7.1.4 to 7.1.7. Addressed in #6085.

Released 12/26/2019

Bugfixes:

• We fixed a bug where cypress run --headless would not run Chrome-family browsers headlessly. Fixes #5949.
• We fixed an issue where, on some systems with IPv4 and IPv6 enabled, Cypress would fail to connect to the Chrome DevTools Protocol while launching Chrome, leading to test failures. Fixes #5912.
• The strict cookie validation added in 3.5.0 for cy.setCookie(), cy.clearCookie(), and cy.getCookie() has been removed. Fixes #5642.
• We fixed a regression in 3.8.0 where using .type() on number inputs to type non-number characters or the {enter} special character would not type the correct value. Fixes #5968 and #5997.
• Configuration values set from the plugin file now display with the correct background color in the Configuration panel in the Test Runner Settings. Fixes #6024.
• We removed the 'Me' and 'An Organization' selections in the Test Runner when setting up a project to more closely match the Dashboard UI. This also fixes an edge case where a user with no default organizations could potentially be unable to set up a project. Fixes #5954.

Misc:

• We updated the fallback error message for visibility checks to be less confusing. Addresses #5982.
• The type definitions for cy.location() have been improved. Addresses #5574.

Dependency Updates:

• Upgraded get-port from 5.0.0 to 5.1.0. Addressed in #6004.
• Upgraded chrome-remote-interface from 0.28.0 to 0.28.1. Addressed in #6008.
• Upgraded which from 1.3.1 to 2.0.2. Addressed in #6017.
• Upgraded ansi_up from 1.3.0 to 4.0.3. Addressed in #4331.
• Upgraded jimp from 0.6.4 to 0.9.3. Addressed in #4331.

Released 12/12/2019

Features:

• Chrome can now be run in headless mode by using cypress run --headless --browser chrome. Addresses #832.
• Cypress now accepts a --tag argument to be used to identify separate runs. Any tags assigned will be shown on the run in the Cypress Dashboard. Addresses #2561.
• The commands .its() and .invoke() now accept an options object to allow changing logging options. Addresses #1450.
• Cypress will now attempt to use the unzip binary during cypress install before trying the slower, Node.js-based unzipping method. Addresses #3803.
• Upgraded Electron to 7.1.4. This bumps the internal Node version to 12.8.1 and the internal Chromium version to 78.0.3904.113.

Bugfixes:

• We fixed a regression in 3.5.0 where Cypress would crash on Windows when trying to pass a url through --config or --env command line flags. Fixes #5466.
• We fixed a regression in 3.5.0 where a supplied Cookie header during "cy.visit() visit or cy.request() would be overwritten by the Cookie header generated from the browser's cookie store. Fixes #5894.
• We fixed a regression in 3.5.0 where cy.getCookie() would incorrectly filter cookies by their domain, leading to unexpected results. Fixes #5656.
• We fixed a regression in 3.5.0 where calling .type({ force: true }) on hidden inputs would not type the correct characters. Fixes #5835.
• We fixed a regression in 3.5.0 where .type() was not respecting previous selections if the current value of the input was the same as the key. This also fixed an where .type() would not respect previous selections in non-selectionRange inputs (like email or number inputs). Fixes #5703.
• During visibility checks, Cypress now properly evaluates a DOM element transformed by scale(0) or rotateY(90deg) as not visible. Fixes #723.
• Fixed a bug where the specs list in interactive mode would not refresh when files are changed on disk. Fixes #5933.
• env configuration option displays properly within the settings panel. Previously, setting env options would incorrectly render "undefined" as the value. Fixes #5859.

Misc:

• We removed the max viewport size and lowered min viewport size to 0 for cy.viewport() Addresses #5871 and #5892.
• The Test Runner now shows a non-Chrome logo for browsers passed in via config.browser that are not of the Chrome family. It also supports showing the Firefox logo (in preparation for Firefox browser support). Fixes #5745.
• We updated the look of some of our icons. Addressed in #5822.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #5643.
• cy.request will now automatically encode special characters in the request URL, including Unicode. Addresses #5274.
• You can pass additional Electron launch command line arguments using environment variable ELECTRON_EXTRA_LAUNCH_ARGS. Addresses #5807.

Dependency Updates:

• Upgraded ansi-escapes from 4.2.1 to 4.3.0. Addressed in #5815.
• Upgraded electron-context-menu from 0.11.0 to 0.15.1. Addressed in #5495.

Released 11/27/2019

Features:

• Cypress now includes the full list of browsers found and their properties within the Cypress configuration. This means that the browsers array is also editable within plugins by accessing config.browsers via the Configuration API. The currently available browsers are also displayed within the configuration panel under Settings in the Test Runner. Addresses #5067.
• Environment variables within GitHub Actions are now detected and passed to the Dashboard in order to display the proper git information for recorded runs. Fixes #5609.

Bugfixes:

• Fixed a regression in 3.5.0 where a cy.visit that changes superdomain would incorrectly clear cookies of other domains. Fixes #5756.
• Fixed a regression in 3.5.0 where cookies set in a redirect on a cy.visit or in a cy.request with a custom Domain that is not a subdomain of the current domain would fail to set. Fixes #5656.
• Fixed a regression introduced in 3.5.0 which caused cy.type to send duplicate modifier keys. Fixes #5622.
• We fixed a regression in 3.6.1 where cy.request() with followRedirect: false would fail if a Set-Cookie header was present in the response. Fixes #5654.
• The context of window is no longer undefined within the application under test when called within a setTimeout during strict mode. Fixes #5707.
• Cypress now captures the SHA of builds generated through Travis CI during pull requests. This should resolve issues with Cypress status checks sometimes not running within GitHub Integration. Fixes #5728.
• Cypress now automatically strips double quotes from --ci-build-id and group flag arguments during cypress run. Fixes #5686.
• Assertions printed in the Command Log now correctly identify integers from string integers. Fixes #25.
• Empty spaces are now accurately reflected in the Command Log within assertions. Fixes #1360.
• Keys printed in the Command Log when using the have.all.keys assertion now correctly display. Fixes #753.
• We fixed an issue where Cypress would throw an error when using cy.visit() on a cleverapp.io domain. Fixes #5722.
• Fixed a bug where fixtures consisting only of null would cause an error. Fixes #472.
• Fixed a bug where, if the Test Runner child process is killed with a signal and does not exit normally, the npm CLI process would not exit with an error. Fixes #5808.

Misc:

• Added a new, more specific error message when an item is not visible because it has position: fixed and is being overflowed over. Addresses #1379.
• cy.visits that cause a superdomain change will now result in 2 requests to the origin server. This should not affect tests, as tests will still re-run on a superdomain change. This is a side-effect of the fix for #5756.
• The configuration object returned from the plugins file is now validated and will throw a helpful error message when invalid. Addresses #5712.
• The configuration panel under Settings in the Test Runner now has a white background for better readability. Also each configuration option with nested properties is now collapsible. Addressed in #5068.

Dependency Updates:

• Upgraded parse-domain from 2.0.0 to 2.3.4. Addressed in #5726.

Released 11/08/2019

Bugfixes:

• The Electron browser no longer hangs when testing applications that have a prompt in a beforeunload handler. Fixes #2118.
• We fixed a regression in 3.5.0 where HTTP redirects could cause strange behavior, including cookies not being set as expected, leading to authentication issues and other problems. Fixes #5436 and #5432.
• When using cy.setCookie() with the same options Object, Cypress now correctly sets the new cookie instead of the one passed into a previous cy.setCookie(). Fixes #2701.
• We fixed a regression in 3.5.0 where cy.clearCookie() would not act as expected when using certain baseUrls. Fixes #5453.
• Cypress no longer crashes with the error Failed to parse or set cookie named "xxx" when loading certain websites. Fixes #4990.
• Cypress now sends the expected headers or request body in a cy.visit() to an HTTPS URL using the default port, 443. Fixes #5367.
• We fixed a regression in 3.6.0 where Cypress would crash with TypeError: Cannot read property 'length' of null on some network requests. Fixes #5585.
• We fixed a regression in 3.5.0 that caused the red target to be rendered incorrectly when specifying offset coordinates to .click(). Fixes #5635.
• We fixed a regression in 3.6.0 that was causing an incorrect element to receive the click event during action commands. Fixes #5578.
• We fixed a regression in 3.5.0 causing text after using modifier keys in .type() to not be typed. Fixes #5622.
• Elements with backface-visibility: hidden; are now accounted for when asserting on the elemtent's visibility. Fixes #2985.
• We fixed a bug where a failed Cypress commands would incorrectly throw cannot read property 'replace' of undefined if the error's stack was undefined. Fixes #1669.
• The 'Log In' modal within Cypress when setting up a project now correctly closes when manually closed. Fixes #5631.

Misc:

• We improved the user experience around inspecting events fired during .click() and .type() commands within the console. Addresses #5553.
• We increased the timeout when connecting to the "Developer Tools Protocol" from 5 seconds to 20 seconds and also added logging for when the connection takes longer than 5 seconds. Addresses #5610.
• There is no longer a warning about Promise.defer appearing in stderr when running with video recording enabled. Addresses #5611.
• Types for .rightclick() and .dblclick() have been updated to correctly reflect their accepted options. Addresses #5617.
• We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #5556

Released 10/31/2019

Features:

• testFiles now also accepts an Array of glob patterns when specifying what test files to load in configuration. Addresses #5401.

Bugfixes:

• We fixed a regression in 3.5.0 where the maximum size of an HTTP header or body in a stubbed cy.route() was limited to 8kb causing requests to fail with a 431 HTTP error. Fixes #5431.
• We fixed a bug where certain types of uncaught errors originating from the application under test would not route through the uncaught:exception handler, and thus could not caught and ignored. These errors will also now correctly indicate that they came from application code. Fixes #987.
• We fixed a regression in 3.5.0 that would throw an error during cypress verify when running as a non-root user on a non-Windows machine. We now always set the --no-sandbox flag when verifying in Electron, even when running as a non-root user. Fixes #5434.
• We fixed a regression in 3.5.0 where sometimes cookies were not set on the correct URL during a redirect inside of a cy.visit() or cy.request(). Fixes #5432.
• We fixed a regression in 3.5.0 causing environment variables containing unicode values to be incorrectly resolved when read via Cypress.env(). Fixes #5435.
• We fixed a regression in 3.5.0 that prevented use of .click() or .type() inside of an iframe element. Fixes #5449. Fixes #5435.
• We now throw the proper error message when an element cannot be interacted with due to being covered by an element with position:fixed. Fixes #5430.
• We fixed a regression in 3.5.0 that caused some click events to not be sent to the correct elements during .click(). Fixes #5459.
• We updated .type() to properly respect focus selection changes during typing. Fixes #5456.
• We fixed a regression in 3.5.0 that caused selected text to be overwritten while typing a modifer key during .type(). Fixes #5439.
• We now send all the proper events during .type() to input elements with type date, time, and datetime-local so that it now behaves as it did prior to 3.5.0. Fixes #5476.
• We now properly render iframe placeholder content when previewing DOM snapshots. Fixes #5295.

Misc:

• We no longer log the default option {multiple: true} in the Command Log or the console during cy.dblclick(). Addresses #5406.
• The text color of inactive tabs within the Cypress Chrome browser has been set to white for better readability. Addresses #1661.

Dependency Updates

• Replaced express-handlebars with squirrelly to reduce dependency size. Addressed in #5521.
• Upgraded graceful-fs from 4.2.0 to 4.2.3. Addressed in #5497.

Released 10/23/2019

Features:

• We now record video during cypress run in Chrome, Chromium, and Canary browsers. This requires passing the name or path of the Chrome browser to the --browser flag. Addresses #4608.
• There is a new .rightclick() command to right click on DOM elements. Addresses #53.
• Cypress now accepts a --config-file argument to specify a different file to be used for Cypress configuration. You can also pass false to the --config-file to not use any configuration file. Addresses #1369.
• You can now use your system's Node version by setting the nodeVersion to system in your configuration. This Node version will be used to build files in your integrationFolder and "supportFile" configuration#Folders-Files and also be used to execute code in your "pluginsFile" configuration#Folders-Files. If not set, Cypress will continue to use the Node version bundled with Cypress. Addresses #4432.
• ".dblclick() dblclick now accepts position, x, and y arguments. Addresses #116.
• ".dblclick() dblclick now accepts force and multiple in its options. Addresses #116.
• .screenshot() now accepts a padding argument when screenshotting elements that will alter the dimensions of the screenshot of the element. Addresses #4440.
• cy.visit() now accepts a qs option representing an object of query paramaters to be used in the URL. Addresses #5034.
• cy.viewport() now allows for viewport sizes up to 4,000 pixels. Addresses #5181.
• cy.viewport() accepts new size presets for iphone-xr, iphone-x, samsung-s10 and samsung-note9. Addresses #4967.
• Passing a ~ to CYPRESS_CACHE_FOLDER will automatically resolve to the user's home directory. Addresses #5386.

Bugfixes:

• ".dblclick() dblclick and .click() now fire all appropriate mouse events including mouseover, mousemove, mouseout, pointerdown, pointerup, and pointermove. Fixes #1016, #1847, #2045, #2521, #2768, #2928, #2957, and #3224.
• We updated ".dblclick() dblclick to follow the same actionability checks as .click(). Fixes #3798.
• Coordinates clicked during .click() are now correct if the element being clicked is within an iframe. Fixes #4347.
• We now allow .type() to be used on any DOM element. The element will receive all of the type events. Fixes #2166 and #3661.
• If a typeable element gains focus during .type(), Cypress now continues typing into the newly focused element. Fixes #2240.
• We now correctly borrow the property getter for maxLength when using .type() on an input. Fixes #4587.
• We fixed an issue where datetime-local inputs would not have their value updated during .type(). Fixes #2613.
• .type() now allows you to type - into number inputs with text selection. Fixes #4767.
• We now fire an input event when using .type() typing {enter} inserts a newline. Fixes #4870.
• We no longer input text when non-{shift} modifier keys are typed in .type(). Fixes #5424.
• We now properly send the code property during keyboard events triggered during .type(). Fixes #3722
• Cypress now sends screenX and screenY properties to events triggered using .trigger(). Fixes #3187.
• We fixed a bug where Cypress could not intercept traffic sent through cy.visit() to IP addresses over HTTPS, leading to ERR_SSL_VERSION_OR_CIPHER_MISMATCH errors. Fixes #771.
• We fixed a bug introduced in 3.3.0 where some HTTPS sites failed to load during cy.visit() and cy.request() with a "handshake failed" error. Fixes #4394.
• We fixed a bug where ECC SSL Certificates were not supported during cy.visit() that was introduced in 3.3.0. Fixes #4368.
• We fixed an issue introduced in 3.4.0 that would cause the Selector Playground to not properly highlight the currently hovered element. Fixes #4872.
• Cypress.env() now escapes <script> tags in the configuration file. Fixes #4952.
• Cypress now properly handles converting responses of content-type application/vnd.api+json to JSON. Fixes #5165.
• XHR responses in cy.route() that exceed 80kb in size no longer fail with an ERR_EMPTY_RESPONSE error. Fixes #76.
• Cypress no longer crashes with dest.end errors on Windows machines. Fixes #2181.
• The onFocus event no longer incorrectly fires on hidden elements. This fixes an issue introduced in 3.3.2. Fixes #4898.
• You can now call .click() on inputs or textareas that are readonly. This fixes an issue introduced in 3.4.1. Fixes #4874.
• Cypress no longer crashes with a "port" option should be a number or string error when receiving an erroneous HTTP CONNECT. Fixes #3250.
• Cypress tests now timeout if there are no Cypress commands enqueue and the done() callback is not called within the commandTimeout. Fixes #1075, #2478, #3349, and #4790.
• We fixed a bug where Cypress would exit with an ENOTCONN error at the end of a test run when using Node >12.11.0 on Windows OS. Fixes #5241.
• We fixed a bug where the Chrome policy warnings introduced in 3.4.0 would not appear. Fixes #4986.
• We improved the way that cookies are handled for Chrome browsers. This fixes an issue when parsing cookies that were set with a domain beginning with a . in Chrome 77. Fixes #5142 and #5206.
• We fixed a bug when visiting an application that does an HTTP request to a .js file containing Unicode transferred using Content-Encoding: gzip that could cause the JavaScript file to become corrupted. Fixes #1746.
• We now normalize the Cypress cache folder to resolve in the current folder and not with respect to the node_modules/cypress folder. Fixes #2364.

Misc:

• Cypress now displays a more precise error message when checking an element's visibility if an element is detached from the DOM. Addresses #4946.
• We increased the timeout to wait for Xvfb to start from 5 seconds to 30 seconds. This should resolve some issues where the error Could not start Xvfb was being thrown because Xvfb could not start within the allowed time. Addresses #5110.
• We now warn when using cypress run from the binary directly (not from an npm module) since this is not its intended use. Addresses #1573.
• We now warn on cy.visit('file://...) to explain that this url format is not supported and suggest visiting a relative HTML file. Addresses #4452.
• Setting the reserved CYPRESS_ENV environment variable will now throw an error. Addresses #1621.
• We now throw a better error when passing in an Object to the browser argument of the Browser Launch API explaining that a String is expected instead. Addresses #4966.
• An error will now be thrown if an invalid name or value is supplied to cy.setCookie(), matching the RFC 6265 compliant validation of cookie names and values. Addresses #5206.
• Passing an invalid type to the 2nd argument of cy.get() now throws an error explaining that an options Object is expected. Addresses #2953.
• We now throw a more helpful error message during cy.screenshot() that would result in a screenshot with 0 width or height. Addresses #5149.
• Stdout printed during cypress run no longer truncates text such a filenames and instead wraps the text to fit within the width of the terminal. Addresses #4977.
• We now display up to 2,000 characters of HTTP property values within error messages during cy.request() errors. Addresses #3145.
• Cypress now always considers localhost to be in NO_PROXY. To make Cypress send traffic for localhost through the proxy, you will now have to pass <-loopback> in NO_PROXY. Addresses #4780.
• We changed the way cookies are set in cy.visit() to more closely match the browser's behavior when setting cookies, particularly when using fetch with cookies. Addresses #4433.
• We've added more flags to send to Chrome upon launch that should help with issues encountered during browser automation including --disable-backgrounding-occluded-window, --disable-breakpad, --disable-ipc-flooding-protection, --password-store=basic, and --use-mock-keychain. Addresses #5132 and #3633.
• Scrolling the specs list now only scrolls the list of spec files and no longer scrolls the search and filter bar. Addresses #4904.
• We fixed some layout issues within the Test Runner that were introduced in 3.4.1. Addresses #4888, #4912, and #4959.
• The counter badge for spies and stubs no longer appears visually cut off. Fixes #4822.
• TypeScript 3.6.2 no longer errors due to outdated jQuery types. Addresses #5065.
• We updated types for Cypress.Commands.overwrite() to not allow an options object as an argument. Addresses #5341.
• We added failures and message types when a run fails using the Module API. Addresses #5335.
• We're continuing to make process in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #4869, #4906, #5096, #5107, #5156, #5173, and #5352.

Documentation Changes:

• Added a .rightclick() doc.
• Added a Webinars doc containing videos of all of the official Cypress webcasts.
• Updated the .dblclick() doc to include new position, x, and y arguments plus force and multiple options.
• Added the --config-file argument to Command Line and Module API doc.
• Added the nodeVersion argument to Configuration doc and mentioned its uses in the Plugins Guide and Writing a Plugin doc.
• Updated all docs to mention 'configuration file' instead of static cypress.json file since this is not configurable via a --config-file argument.
• Added qs option to cy.visit() with examples.
• Added padding option to cy.screenshot() with examples.
• Updated the cy.viewport() doc to have a max viewport size of 4000.
• Added newly supported viewport sizes to the cy.viewport() doc.
• Documented new keyboard shortcuts in the Test Runner doc.
• Added a new section on troubleshooting problems with Xvfb to the Continuous Integration doc.
• Added a section to our Debugging doc about our cypress-fiddle plugin used for playing around with small test cases.
• Added a section to our Debugging doc explaining how to patch an installed version of Cypress.
• Mention not needing to decode portions of the url in the cy.route() doc.
• Mention that the file:// prefix is not supported in the cy.visit() doc.
• Add a note about when passing <-loopback> in NO_PROXY is necessary in the Proxy Configuration doc.
• Updated our Dashboard docs to include screenshots containing our new Dashboard navigation design.
• We have some newly translated documentation in Portuguese. If you'd like to help in translating more, please open a pull request in our documentation repo.

Dependency Updates

• Upgraded Chrome browser version used during cypress run and when selecting Electron browser in cypress open from 61 to 73. Addressed in #4720.
• Upgraded electron from 2.0.18 to 5.0.10. Addressed in #4720.
• Upgraded node from 8.9.3 to 12.0.0. Addressed in #4720.
• Upgaded jquery from 2.2.4 to 3.1.1. Addressed in #1229.
• Upgraded sanitize-filename from 1.6.1 to 1.6.3. Addressed in #5216.
• Upgraded @cypress/get-windows-proxy from 1.5.4 to 1.6.0. Addressed in #5108.

Released 7/29/2019

Dashboard Features:

• We’re excited to announce GitHub integration for the Cypress Dashboard. You can now get timely and useful test run information within pull-requests via status checks and pull-request comments. Learn all about it on our blog. Addresses #981.

Bugfixes:

• Fixed a bug where the content of pages using non-UTF-8 character encoding would become corrupted when opened in Cypress. Fixes #3479, #1543, and #3650.
• Fixed a regression introduced in 3.4.0 that caused an error to be thrown when chaining together multiple assertions using the and chainable getter. Fixes #4833.
• The include and includes assertion chainers now correctly work the same as contain and contains assertion chainers. Fixes #4833.
• Cypress now correctly works offline on Windows when visiting a localhost URL. Fixes #4763.
• cy.type() now factors in the readonly property of <input /> elements, and will wait for this property to be false before attempting to type. Fixes #1246.
• Variables beginning with top and location in your application code are no longer modified when modifyObstructiveCode is true. Fixes #4794.
• We removed erroneous socket connections when the browser is initially launching. Fixes #4776.
• Fixed a bug when dismissing pinned snapshots that would cause the page to be wiped with nothing rendered. Fixes #4864.
• We upgraded the mocha-teamcity-reporter dependency so that it no longer errors in certain situations when trying to access duration on tests. Fixes #4654.
• We upgraded the lodash dependency to fix a security vulnerability warning. Fixes #4699, #4730, #4743.

Misc:

• We now ensure we are shipping with production versions of dependencies such as react, mobx, etc. This should help to prevent conflicts with Developer Tools extensions and increase performance by reducing memory, heap allocation, and overall JS bundle size. Addresses #4844.
• Video recordings now wait after all tests finish to ensure that the video captures the final rendered frames of the browser. This prevents the last few paints from being cut off. Fixes #2370.
• Cypress now looks for any npm proxy configuration values as a fallback when no other system proxy configuration is found. This brings this feature into parity with how npm reads off proxy configuration values during an npm install. Addresses #4719.
• We updated the messaging when there is a failure downloading Cypress to recommend checking your proxy settings. Addresses #1662.
• A warning message now displays if you attempt to run the Cypress binary directly instead of going through the cypress npm package. Addresses #1573.
• There are newly added examples in the TypeScript definitions for custom commands, cy.location() and .should(). Addresses #3684 and #4715.
• The types for the cy.contains(content, options) syntax have been added. Addresses #4727.
• Types for cy.once() have been added. Addressed in #4788.
• There is now a { parseSpecialCharSequences: false } option to cy.type() that disables parsing the special character sequences found between the {} characters. This will now type what you've provided literally without any special parsing. Fixes #4287.
• You can now zoom in the main Test Runner window and also the Electron browser. Corresponding keyboard shortcuts for Zoom in, Zoom out and Actual Size are also available. Addresses #1231.
• When viewing the Test Runner's main window at its smallest size, the header text no longer incorrectly wraps. Addresses #86.
• We're continuing to make process in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #4781 and #4817.
• We increased the cypress binary verification phase from 10 seconds to 30 seconds to accomodate underpowered or overwhelmed machines typically found in CI environments. Addresses #4624.

Documentation Changes:

• We have new instructions on how to set up GitHub Integration with the Cypress Dashboard.
• Updated instructions for adding types for custom commands in the TypeScript Support doc. Addressed in #1901
• Added a section about video encoding and how to speed up the encoding time to Screenshots and Videos doc. Addressed in #1880

Dependency Updates

• Upgraded @ffmpeg-installer/ffmpeg from 1.0.17 to 1.0.19. Addressed in #4792.
• Upgraded browserify from 13.3.0 to 16.3.0. Addressed in #4751, #4825 and #4826.
• Upgraded data-uri-to-buffer from 1.2.0 to 2.0.1. Addressed in #4622.
• Upgraded duplexify from 4.0.0 to 4.1.1. Addressed in #4853.
• Upgraded graceful-fs from 4.1.15 to 4.2.0. Addressed in #4818.
• Upgraded lodash from 4.17.11 to 4.17.15. Addressed in #4684, #4709, #4784.
• Upgraded mocha-junit-reporter from 1.23.0 to 1.23.1. Addressed in #4785.
• Upgraded p-queue from 1.2.0 to 6.1.0. Addressed in #4750.
• Upgraded semver from 6.0.0 to 6.3.0. Addressed in #4797.
• We also updated and removed some dependencies used for development.

Released 7/9/2019

User Authentication Changes:

• Users can now log in to the Test Runner using the browser installed on their system. Fixes #3583, #4337, and #1162.
• Users can now log in to the Test Runner with Google or with SSO (if configured). Fixes #3519.

Continuous Integration Support:

• Environment variables for Semaphore CI v2 are now recognized when recording a test for the dashboard. Fixes #4671.
• Support for Concourse CI has been added when recording a test for the dashboard. Fixes #4376.
• SnapCI support has been removed and GoCD support has been added. Fixes #2680.

Bugfixes:

• contain.text, contain.html, and contain.value assertions now support partial matching in all scenarios to match expected behavior. Fixes #1969.
• Electron rendering warnings are no longer printed to console output. Fixes #4288.

Misc:

• Added verification for cypress download that checks the checksum and filesize. This will fix issues with Cypress downloads being corrupted in transit. Fixes #812 and #3515.
• Added a warning when a percent-encoded URL is passed to cy.route(). Fixes #2372.
• Added an error for when cy.click() fails because an element has the CSS pointer-events: none. Fixes #3164.
• Added a warning for Windows users who have Group Policy settings that may interfere with usage of Cypress. Fixes #4391.
• The JSON schema file used for intelligent code completion for the Cypress configuration file has been updated to match our documentation. Addressed in #4300.
• Type definitions were added to cy.server() for the onAnyRequest, onAnyResponse, and onAnyAbort callback options. Fixes #3992.
• The outline when focusing on a panel heading within the 'Settings' tab of the Test Runner now correctly outlines the element. Fixes #3357.

Documentation Changes:

• Documented cy.get()'s optional withinSubject argument. <!-- docs PR 1722 -->
• Documented "Expected to find element..." error message and potential causes. <!-- docs PR 1846 -->
• Documented new "Cypress detected policy settings on your computer that may cause issues" warning in Error Messages. <!-- docs PR 1754 -->

Dependency Updates:

• Removed string-to-stream since it was no longer being used. Addressed in #4619.
• Upgraded @cypress/commit-info from 2.1.3 to 2.1.4. Addressed in #4597.
• Upgraded @cypress/react-tooltip from 0.4.0 to 0.5.0. Addressed in #4610.
• Upgraded errorhandler from 1.5.0 to 1.5.1. Addressed in #4618.
• Upgraded fs-extra from 8.0.1 to 8.1.0. Addressed in #4620.
• Upgraded request-progress from 0.4.0 to 3.0.0. Addressed in #4584.
• We also updated and removed some dependencies used for development.

Released 6/27/2019

Performance Improvements:

• We fixed a regression introduced in 3.3.0 that was causing the Test Runner to do extremely unnecessary re-renders of the Command Log on any command change - leading to exponential performance degradation on any run. This was the root cause behind many users experiencing a reduction in performance when upgrading to 3.3.0 or above. Fixes #4411 and #4313.
• We reduced memory consumption and improved the performance of running tests anytime you're inside of cypress open. Fixes #2366. Thanks @"CoryDanielson"!
• We no longer delay proxied responses with no body with status codes 1xx, 204, 304. This fixes a regression introduced in 3.2.0 where responses with these status codes were delayed when using a proxy. Fixes #4298.
• Snapshots were previously being mistakenly stored then instantly deleted when numTestsKeptInMemory was set to 0. We now no longer record the snapshots at all when numTestsKeptInMemory is set to 0. This should slightly improve the performance of running tests with this setting. Fixes #4104 and #4164.

Bugfixes:

• Cypress no longer watches files when run using cypress run. This will fix some runs that were crashing with an ENOSPC error. Fixes #4283.
• Cypress now correctly handles blur and focus events in situations where the browser has lost focus. Fixes #4039, #1176, and #1486.
• If the DOM element provided to .type() is already in focus, Cypress no longer attempts to click on the DOM element. This allows you to call .focus() on elements that are focusable, but not necessarily clickable and type into them using .type(). Fixes #3001 and #4420.
• Some elements inside of a parent with CSS overflow: hidden that flow outside of its parent are now properly considered hidden. #4161
• Elements that are inside a parent with CSS position: absolute which is itself inside of a parent element with overflow: hidden are now properly considered visible. Fixes #4395 and #755.
• <option> and <optgroup> elements are now properly considered visible if it is contained within a visible <select>. Fixes #4473.
• <body> and <html> elements are now properly always considered visible. Fixes #4475.
• <td> and <tr> elements with CSS visibility: collapse are now properly considered hidden. Fixes #4476.
• We now correctly handle form submission when using .type('{enter}') on a form containing a button of type reset. Fixes #3909.
• If a site's content-type is null, undefined or cannot be determined during cy.visit(), we now look at the content of the site and evaluate whether it looks like HTML. If it does look like HTML we no longer error and continue as if it the site's content-type is text/html. #1727 #773 #3101.
• Previously Cypress would send the auth header to any URLs that match the CORS origin of the original auth header. We now correctly only send the auth headers when there is an exact match on the protection space. Fixes #4267.
• Requests that go through cy.visit() or cy.request() are now automatically retried on ENOTFOUND errors. Fixes #4424 and #1755.
• Cypress now errors when the body paramater passed to cy.request() contains a circular reference. Fixed in #4407.
• We fixed an issue where the ignoreTestFiles configuration was being filtered out when passed via a command line flag, so in effect being ignored. Fixes #1696.
• Setting NO_PROXY is now respected for HTTPS urls, as it should be. Fixes #4303.
• When running tests with non-string test titles, the screenshots now automatically stringify the test titles instead of throwing an error. Fixes #4310.
• Cypress no longer incorrectly errors when calling cy.window().screenshot(), cy.window().scrollTo() or cy.window().trigger() in an application with multiple iframes. Fixes #4396.
• Fixed a regression in 3.3.0 causing some users using proxy to see the "Browser was not launched through Cypress" error during cypress open. This was caused by incorrectly routing requests for Cypress's internal server on localhost through the user's proxy. Fixes #4410.
• We fixed situations during a test failure where the Test Runner would throw RangeError: Maximum call stack size exceeded. Fixes #1958 and #4346.
• Fixed issue where window.performance.getEntriesByType would return undefined instead of an array within application code when using cy.clock(). Fixes #3625.
• Passing an array of strings to ignoreTestFiles no longer causes an error to throw. Fixes #4312.
• Fixed a visual bug when aliasing a non-route subject multiple times that would cause the Test Runner to show 'undefined' alias with empty counts. Fixes #4429.
• Fixed regression introduced in 3.2.0 where Cypress would error because it could not find a type definition file for '../sinon'. Fixes #4272.
• cy.writeFile() no longer errors in TypeScript files when passing an options object as its third argument. Fixes #4461.
• cy.stub() no longer errors in TypeScript files when evaluating returns. Fixes #4302.

Misc:

• Warnings are now displayed when recording in cypress run to warn when a project is nearing its organization's usage limit. They also clearly explain any consequences of going over a plan's usage limit. Addresses #4530.
• An warning icon with a tooltip is displayed in the Runs tab of the Test Runner when parallelization was disabled during the run due to being over the organization's usage limit. Addresses #4489.
• You can now opt out of sending exceptions to https://api.cypress.io by setting CYPRESS_CRASH_REPORTS=0 in your system environment variables. #4386
• We are now capturing Google Cloud build details when recording tests to the Cypress Dashboard. Addresses #3582.
• The tests titles and headers in the Command Log no longer truncate with elipsis when the text is longer than that width of the Command Log. Instead the text wraps so that all text is shown. Addresses #3947.
• Special env vars are now truncated in Cypress.env() and the debug logs. Addresses #4501.
• The projectId in now displayed in the configuration in the Test Runner settings like all other configuration values. Fixes #4500.
• When recording to the Dashboard, unrecognized warnings coming from the API server are now displayed in stdout. Fixes #4489.

Documentation Changes:

• New Code Coverage doc. Addressed in #1744.
• New Visual Testing doc. Addressed in #1744.
• New Courses doc to list online courses that teach end-to-end testing with Cypress. Addressed in #1766.
• Added a section about Hacking on Cypress in the Debugging doc. Addressed in #1783.
• Added a section on how to opt out of sending exception data to Cypress in the Installing Cypress doc.

Dependency Updates

• Removed electron-positioner since it was no longer being used. Addressed in #4502.
• Upgraded chokidar from 1.7.0 to 3.0.1. Addressed in #4487.
• Upgraded cookie from 0.3.1 to 0.4.0. Addressed in #4329.
• Upgraded dependency-tree from 6.5.0 to 7.0.2. Addressed in #4364.
• Upgraded fs-extra from 0.30.0 to 8.0.1. Upgraded in CLI package only to 5.0.0. Addressed in #4418, #4419, #4422, #4437, #4555, #4559, #4571, #4581.
• Upgraded mocha-junit-reporter from 1.18.0 to 1.23.0. Addressed in #4417.
• Upgraded pluralize from 7.0.0 to 8.0.0. Addressed in #4438.
• Upgraded shell-env from 0.3.0 to 3.0.0. Addressed in #4466, #4467, and #4471.
• Upgraded winston from 0.9.0 to 2.4.4. Addressed in #4538.
• We updated and removed some dependencies used for development.

Released 5/23/2019

News:

• We've written a blog post about the 300% increase in proxy performance delivered in 3.3.0.

Bugfixes:

• Cypress no longer accidentally prints internal Electron logs when running cypress run. This bug would exhibit itself when verifying and running Cypress the first time after installation. You may have seen these logs when running in CI. Fixes #4255.
• Fixed a bug for users running external network proxies that prevented requests from completing. Requests should now all work correctly. Fixes #4257.
• Fixed a regression in 3.3.0 causing large requests such as multipart/form-data uploads to hang. Fixes #4240, #4252, and #4253.
• Fixed issue where support for have.focus, not.have.focus, be.focused and not.be.focused assertions were not working. Fixes #4265.
• Names given to .as() now work properly when they contain a . character. Fixes #3512.
• The proper error is now thrown when passing {log: false} to a Cypress command that failed. Fixes #3847.
• Fixed an issue where highlighting a command's snapshot would throw an error when no application was rendered in the AUT frame. Fixes #4177.
• We now properly detect the branch name when running Cypress in AppVeyor. Fixed in #4234.

Misc:

• Fix capitalization of Xvfb in error messages. Addressed in #4262.

Documentation Changes:

• We have some newly translated documentation in Chinese and Japanese. If you'd like to help in translating more, please open a pull request in our documentation repo.

Released 5/17/2019

Features:

• Cypress now automatically reads from your system's HTTP_PROXY, HTTPS_PROXY, and NO_PROXY environment variables and proxies traffic accordingly through Cypress based on these values. This includes network traffic within your application under test, when downloading Cypress, and when accessing 'Runs' within the Test Runner. Please read our new Proxy Configuration doc to understand more about proxy configuration in Cypress. Fixes #672, #733, #939, #1039, #1459, #1469, #1470, #1541, #1608, #2295, #3855, #3865, #1401 and #3857.
• Your project's current proxy settings now display in the Settings of the Test Runner. Addresses #3856.
• Support for have.focus, not.have.focus, be.focused and not.be.focused assertions have been added. Addresses #97.
• We now offer a separate 32bit and 64bit build for Windows. Addresses #716, #787, #2095, #706, #3706, and #4016.
• Requests that go through cy.visit() or cy.request() are now automatically retried under the hood when the request fails. This more closely reflects Chrome's default behavior on requests. Addresses #4013, #898 and #1013.
• cy.visit() and cy.request() now support new options retryOnStatusCodeFailure and retryOnNetworkFailure to allow changing Cypress's automatic request retry on status codes and network errors. Addresses #4013, #898 and #1013.
• .type() now supports the special character sequences {insert}, {pageup}, and {pagedown}. Addresses #3845.
• We now indicate which XHRs match which alias in the Command Log on .wait() when they match an alias multiple times. Addresses #477.
• The console log when clicking on the cy.visit() command now displays its resolved options arguments. Addresses #3721.
• There's a new 'canceled' XHR status shown on the Command Log to indicate the difference between calling xhr.abort() and the browser canceling the request due to page navigation. Addresses #3973.
• The Electron browser now runs Chrome Version 61. Addresses #4000.
• Running Cypress via cypress run now supports scripts of type="module". Fixes #3696.
• Exposed Cypress.isCy() method to check if a value is a valid instance of cy or a cy chainable. Fixes #3822.
• There is a new "Download Chromium" menu item in the "Help" menu of the Test Runner links to Cypress's Chromium Download Tool. Addresses #3977

Bugfixes:

• Fixed a regression introduced in 3.2.0 that caused an error to throw when visiting domains with certain public suffixes. Fixes #3717.
• When running Cypress with NODE_OPTIONS environment variables set, Cypress no longer issues an incorrect 0 exit code. #1676
• Fixed a regression introduced in 3.2.0 that caused .its() to no longer retry when it yields undefined. #3837
• Fixed a regression introduced in 3.2.0 that caused cy.fixture() to throw a EISDIR error if a directory had the same name as a file within that same directory. Fixes #3739.
• user-agent headers sent as arguments to cy.request() and cy.visit() are now properly sent. Fixes #3873 and #3719.
• When a request is proxied through Cypress and there is a network error, we no longer send an HTML response with a 500 status code. We now kill the browser-facing socket and let the network error be handled by the application under test. Fixes #4101, #4231, #1036, #4231, and #1398.
• We changed Cypress's implementation to no longer rely on internal XHR events when the browser navigates. This fixes a a bug in Chrome 71+ that could cause XHRs to pend forever. Fixes #3973 and #4130
• We greatly improved the speed of proxied requests through our network layer. Fixes #3192 and #1469.
• If an error occurs during cypress verify, we now kill the verification process after 10 seconds and print the error message. This should prevent some situations where Cypress would hang during installation or verification and never exit. Fixes #819.
• Cypress automatically retries cypress verify and cypress run commands by starting its own Xvfb server on Linux if the first attempt fails due to possible DISPLAY misconfiguration. Addresses #4034.
• Cypress now properly handles typing JavaScript object prototype methods (like hasOwnProperty) into .type(). Fixes #3423.
• We now set the form option to true if the Content-Type header equals application/x-www-form-urlencoded and json is not already set by a user. This fixes a situation where Cypress would try to parse the body as a string, resulting in a confusing error message. Fixes #2923.
• cy.contains() now correctly handles comma delimited arguments passed to the selector argument. Fixes #2407.
• Passing a browser path containing spaces now works properly when passed to the --browser argument. Fixes #3979
• Fixed display of tooltips when selecting elements from the Selector Playground so that they display at the correct coordinates when scrolling. Fixes #1351.
• The lists of spec files now display at the correct indentation level when they are nested more than 5 directories deep. Fixes #3652.
• Cypress now properly parses environment variables with empty values. Fixes #3742.
• Assertions running outside of a test are now properly handled in Cypress instead of throwing internal errors. Fixes #3926.
• Cypress.log() now throws an error when not properly passed an object as its argument. Addresses #3658.
• Cypress.log() no longer throws when called before any other Cypress commands. Fixes #3658.

Misc:

• We now better support capturing environment variables within Azure DevOps. Addresses #3657.
• Cypress now only scans for spec changes when the watcher sees changes, rather than polling to scan. Addresses #3069.
• The ability to open the context menu to see "Inspect Element" has been reenabled in the Electron browser. Addresses #4002.
• We no longer package non-Windows ffmpeg builds with Windows builds, resulting in a 35-40% reduction in zipped size and a 36-43% reduction in unzipped size of download. Addresses #3888.
• The warning messages when going over test recording limits have been updated to correctly display 'monthly tests' and 'private tests' where necessary. Addresses #4024.
• When an HTTP request is received by the proxy layer, by default, we send it with a Connection: keep-alive header so that the connection will be reused if possible. Addresses #3857.
• Improved accessibility of Test Runner for screen readers. Addresses #3850.
• Cypress type definition now allow a timeout option in cy.hash(). Fixes #3844.
• Fixed type definition for match assertion so that it now only accepts RegExp type arguments. Fixes #2578.
• The .trigger() type definition now expects its options to be ObjectLike. Addressed in #3809.
• The cy.clock() type definition now allows for type Date. Fixed in #4106.
• Added type definition for undocumented Cypress.LocalStorage.clear method. Fixes #4070.
• Added type definition for Cypress.isCy() method. Fixes #3822.
• Added missing type definitions for some cy.visit() options. Fixes #3989.
• The spinner animation should more smoothly spin when a command is pending in the Test Runner. Addressed in #4005.

Documentation Changes:

• New Proxy Configuration doc. Addressed in #1486.
• Added {insert}, {pageup}, and {pagedown} as supported special character sequences to .type(). Addressed in #1567.
• Added newly supported focus assertion to Assertions doc. Addresses #1372.
• Added new options retryOnStatusCodeFailure and retryOnNetworkFailure to cy.visit() and cy.request().
• Updated install instructions for Windows on how to target 64bit and 32bit infrastructures. Addressed in #1568.
• Updated .its() and .invoke() docs to better explain how default assertions are handled. Addresses #1643.
• Updated our Roadmap to more closely reflect the work we are doing. Addressed in #1567.
• Added a section about how to request our new Open Source Plan in the Dashboard Service doc. Addressed in #1567.

Dependency Updates

• Upgraded commit-info from 2.1.2 to 2.1.2. Addressed in #4045
• Upgraded data-uri-to-buffer from 0.0.4 to 1.2.0. Addresses #4152.
• Upgraded electron from 1.8.2 to 2.0.18. Addresses #4000.
• Upgraded electron-packager from 9.1.0 to 13.1.1. Addresses #4155.
• Upgraded express-handlebars from 3.0.0 to 3.0.2. Addressed in #4086.
• Upgraded find-process from 1.2.1 to 1.4.1. Addressed in #4087.
• Upgraded getos from 2.8.4 to 3.1.1. Addressed in #4222.
• Upgraded http-status-codes from 1.3.0 to 1.3.2. Addressed in #3949.
• Upgraded jimp from 0.6.0 to 0.6.4. Addressed in #4097.
• Removed method-override. Addressed in #4209.
• Upgraded node from 8.2.1 to 8.9.3. Addressed in #4001.
• Downgraded parse-domain from 2.1.7 to 2.0.0 to avoid a regression released in parse-domain. Addresses #3717.
• Upgraded pluralize from 3.1.0 to 7.0.0. Addressed in #4205 and #4206.
• Upgraded semver from 5.6.0 to 5.7.0. Addressed in #4112.
• Upgraded send from 0.16.2 to 0.17.0. Addressed in #4134.
• Upgraded supports-color from 5.5.0 to 6.1.0. Addressed in #4150.
• Removed tar-fs. Addressed in #4148.
• Upgraded term-size from 1.2.0 to 2.0.0. Addressed in #4148.
• Upgraded tmp from 0.0.33 to 0.1.0. Addressed in #4111.
• Upgraded trash from 4.3.0 to 5.2.0. Addressed in #4140.
• Upgraded url-parse from 1.4.4 to 1.4.7. Addressed in #4110.
• Upgraded widest-line from 2.0.1 to 3.1.0. Addressed in #4139.
• We updated and removed some dependencies used for development.

Released 3/15/2019

Features:

• cy.visit() has been expanded to allow options url, method, body, and headers. This allows cy.visit() to be called with a POST method or with headers like Accept-Language or Authorization. Fixes #1500, #1904 and #908.
• cy.request() now allows any valid HTTP method to be used including TRACE, COPY, LOCK, MKCOL, MOVE, PURGE, PROPFIND, PROPPATCH, UNLOCK, REPORT, MKACTIVITY, CHECKOUT, MERGE, M-SEARCH, NOTIFY, SUBSCRIBE, UNSUBSCRIBE, SEARCH, and CONNECT. Addresses #1302
• The --browser argument of the Command Line and the browser argument of the Module API have been updated to allow passing a <path>. Addresses #1026.
• cy.type() now accepts {home} and {end} special character sequences to move the cursor to the start or end of a line. Addresses #2033.
• The Cypress Chrome extension now has a static ID of caljajdfkjjjdehjdoimjkkakekklcck. This allows Cypress to be added to extension whitelists for those working under corporate policies that prohibit extensions. Addresses #3673, #1239 and #2494.

Bugfixes:

• Problems logging in through GitHub in the Test Runner have been fixed. The GitHub login window no longer shows the browser support banner and the "Authorize cypress-io" button is no longer disabled. Fixes #1251.
• Fixed an issue when testing applications using older versions of jQuery. They now no longer throw item.first is not a function. Fixes #2927.
• Cypress now detects more instances of browser installations. Fixes #3183 and #3218.
• Fixed issue with loading fixture files containing more than one . in their filename while not specifying the file extension. We are also displaying a clearer warning when a fixture file cannot be found. Fixes #1402.
• All third party @types have been moved from Cypress dependencies into devDependencies. This should fix situations where user's type dependencies were conflicting with Cypress's third party type definitions. Fixes #3371 and #1227.
• Cypress.config('baseUrl') has been updated to no longer strip singular / at the end of urls and instead only strip instances of multiple /. Fixes #3540.
• The prompt to "Restore pages?" is no longer displayed within Chrome upon restarting a crashed Chrome window. Addresses #2048.
• cy.wrap() no longer throws an error when a non-jQuery wrapped DOM element is passed in as an argument. Fixes #3549.
• Fixed issue where all arguments passed to setTimeout or setInterval were not properly passed on to the target function. Fixes #3592.
• .filter() has been updated so that when called with a function, the options are now properly read. Fixes #3315.
• Cypress's recognition of websites attempting framebusting has been updated to include framebusting code wrapped within (). #3267
• When .its() returns undefined it no longer errors. It will now follow the same logic as all other commands and only fail when directly by a .should() command with an assertion that is not met. Fixes #1531.
• When cy.wrap() is followed directly by a .should() command, cy.wrap() will now retry when its argument evaluates to undefined until it meets the requirements of the assertion or the cy.wrap() command times out. Fixes #3241.

Misc:

• We now display a warning when passing an argument to --spec that is not surrounded by quotes "" recommending that the argument instead be surrounded by quotes. In some cases, not providing quotes can cause the arguments to be read in a way that is likely not its intended use. Addresses #3318 and #2298.
• The number of logs printed when installing Cypress in docker has been reduced. Partially addresses #1243.
• The seeded Kitchen Sink examples have some new examples showing how to add a message to assertions, how to compare the text content of two elements, and how to make assertions about data attributes. The examples also have some small typo fixes. Fixes #502. Addressed in #3272, #3287, and #3700.
• We now only mount internal servers on loopback. Addresses #3712.
• The instructions in Cypress's update window now include yarn update instructions alongside npm. Addresses #2871.
• The spec file's font weight has been increased within the Test Runner for better readability. Addressed in #3065.
• We improved the error message displayed when a record key is unrecognized during cypress run. Addresses #1449.
• We improved the typings when using Cypress.on to listen for window.alert events to allow for Sinon.stub. Fixes #3451.
• Fixed typo in typing for .trigger options. Addressed in #3588.

Documentation Changes:

• New Retryability doc #1278
• Updated --browser and browser args to accept path #1419
• Add documentation on how to 'accept' or 'reject' project transfer #1474
• Updated docs on explain how to run Chrome and Chromium browsers #1339
• Added {home} and {end} character sequences to cy.type() doc. Also wrote better description of what {downarrow} and {uparrow} character sequences actually do. #1347
• Added all newly supported HTTP methods to cy.request() doc.
• Add new section to Debugging doc explaining whitelisting the Cypress Chrome extension.
• Fixed code example for google analytics stubbing #1454

Dependency Updates

• Upgraded @cypress/commit-info from 2.1.1 to 2.1.2. #3327.
• Upgraded @cypress/xvfb from 1.2.3 to 1.2.4. #3328.
• Upgraded @ffmpeg-installer/ffmpeg from 1.0.15 to 1.0.17. #3329.
• Upgraded cachedir from 1.3.0 to 2.1.0. #3660.
• Upgraded chalk from 2.4.1 to 2.4.2. #3362.
• Upgraded chokidar from 1.6.0 to 1.7.0. #3363.
• Upgraded coffee-script from 1.12.5 to 1.12.7. #3365.
• Upgraded commander from 2.11.0 to 2.19.0. #3366.
• Upgraded common-tags from 1.4.0 to 1.8.0. #3368.
• Upgraded compression from 1.7.2 to 1.7.3. #3379.
• Upgraded cookie from 0.2.4 to 0.3.1. #3380.
• Upgraded cookie-parser from 1.4.3 to 1.4.4. #3443.
• Upgraded dependency-tree from 6.4.0 to 6.5.0. #3381.
• Upgraded electron-context-menu from 0.8.0 to 0.11.0. #3383.
• Upgraded electron-packager from 9.0.1 to 9.1.0. #3384.
• Upgraded electron-positioner from 3.0.0 to 3.0.1. #3385.
• Upgraded errorhandler from 1.1.1 to 1.5.0. #3386.
• Upgraded express from 4.16.2 to 4.16.4. #3409.
• Upgraded extract-zip from 1.6.6 to 1.6.7. #3410.
• Upgraded glob from 7.1.2 to 7.1.3. #3412.
• Upgraded image-size from 0.5.5 to 0.7.2. #3413 and #3500.
• Upgraded is-ci from 1.0.10 to 1.2.1. #3414.
• Upgraded lodash from 4.17.4 to 4.17.11. #3344.
• Upgraded mocha-junit-reporter from 1.17.0 to 1.18.0. #3417.
• Upgraded moment from 2.23.0 to 2.24.0. #3433.
• Upgraded morgan from 1.3.0 to 1.9.1. #3434.
• Upgraded node-uuid from 1.4.1 to 1.4.8. #3436.
• Upgraded parse-domain from 2.0.0 to 2.1.7. #3437.
• Upgraded request from 2.87.0 to 2.88.0. #3444.
• Upgraded request-progress from 0.3.1 to 0.4.0. #3445.
• Upgraded request-promise from 4.1.1 to 4.2.4. #3446 and #3476.
• Upgraded return-deep-diff from 0.2.9 to 0.3.0. #3447.
• Upgraded send from 0.14.2 to 0.16.2. #3448.
• Upgraded ssl-root-cas from 1.2.5 to 1.3.1. #3449.
• Upgraded supports-color from 5.1.0 to 5.5.0. #3464.
• Upgraded through from 2.3.6 to 2.3.8. #3465.
• Upgraded tmp from 0.0.31 to 0.0.33. #3466.
• Upgraded tough-cookie from 2.4.3 to 3.0.1. #3477 and #3659.
• Upgraded trash from 4.0.0 to 4.3.0. #3478.
• Upgraded underscore.string from 3.3.4 to 3.3.5. #3480.
• Upgraded yauzl from 2.8.0 to 2.10.0. #3481. Potentially fixes #3515.
• We also updated many dependencies used for development and removed some unused dependencies.

Released 1/30/2019

Bugfixes:

• Fixed issue where the onLoad event was never being called when calling cy.visit() on the url Cypress is currently navigated to. Fixes #1311.
• Fixed regression introduced in 3.1.4 that caused an InvalidStateError when visiting a page with an XHR request with a responseType other than text or ''. Fixes #3008.
• Fixed several issues in Chrome* versions >= 72 in the Cypress proxy that caused using cy.visit() with localhost to fail, or using localhost inside of the baseUrl configuration option. Fixes #1872 and #3252 and #1777.
• Fixed another issue in Chrome* versions >= 72 where a scrollable command log would cause the entire application to be scrollable. Fixes #3253.
• Fixed not correctly passing the timeout option for cy.request(). This should fix some instances where large timeout values would cause ESOCKETTIMEDOUT errors. Fixes #2669.
• Fixed issue where Cypress would inject a script tag before the <!DOCTYPE> declaration when the document only contained the doctype declaration. Fixes #2617.
• The error message when visiting a site with an invalid content-type now prints the correct content-type of the response Cypress received from the web server. Fixes #3101.
• Fixed issue where an internal layout.html file would inadvertently get loaded instead of the spec file. Fixes #2891.
• Fixed issue where the Chromium browser was not detected in Linux due to Cypress not distinguishing between Chrome and Chromium browsers with the same version. Fixes #1400.
• Fixed issue of Cypress being unable to play videos with autoplay. We now pass the --no-user-gesture-required command line switch to Chrome. Fixes #2376.
• We now pass the Chromium command line switches --use-fake-ui-for-media-stream and --use-fake-device-for-media-stream to Chrome by default in order to better support testing webcam functionality. Fixes #2704.
• Updated filenames allowed for screenshots to allow more characters that are valid. Fixes #3052.
• Fixed TypeScript error caused by dtslint dependency introduced in 3.1.4. Fixes #3024 and #3136.
• Improved error message displayed for cypress cache to not display [object Object] and made --help labels more descriptive. Fixes #2589.

Misc:

• Improved errors shown when opening a project in the Desktop Application. The design is more readable and the error's stack trace is now expandable. Addresses #2955.
• Improved experience of search in Desktop Application when there are no results. Addresses #3146.
• Updated tooltip content so that it no longer flows outside of the tooltip in the Test Runner when displaying longer routes. Fixes #2980.
• Added word labels beside icons in Desktop Application for 'Support' and 'Docs' links. Addresses #3091.
• Updated the CLI to no longer silence important stdout from cypress version, cypress cache list etc commands. Addresses #2705.
• Fixed incorrect type definition for options usage for .then(). Addresses #3075.
• Fixed incorrect JSDoc comments in type definition for .focus() and better formatted comments in type definitions. Addresses #2975 and #2954.

Dependency Updates

• We've begun automating our dependency update process in order to avoid accidental dependency updates. Addresses #2990 and #3025.
• Upgraded sinon from 3.2.0 to 3.3.0. Addresses #1328.

Documentation Changes:

• Added example on how to use a fake video for webcam testing to Browser API doc.

Released 12/25/2018

🎄Merry Christmas everyone!

Known regressions in this release ⚠️

• TypeScript Omit and @ts-ignore combination #3024
• frequent InvalidStateError when running tests #3008

Bugfixes:

• Fixed a very longstanding (!) issue where .click() would fail to click the center coordinates of elements with style display: inline. Cypress would instead report that the element was being covered causing the error: cy.click() failed because this element is being covered by another element. Fixes #210
• We now no longer abort XHR's which have their .abort() method called but are already complete. This fixes an edge case where complete XHR's were having their disposer function called in frameworks like rxJS which lead to Cypress accidentally re-aborting the XHR's after they were complete. Fixes #761
• Fixed issues involving XHRs displaying as 'aborted' in the Cypress Command Log when they were not actually aborted. Fixes #1652
• We no longer abort XHR request during the page's unload event and allow the browser to handle natively calling abort. Fixes #2968
• Fixed an issue where Cypress's devDependencies were being included in the Windows binary. Fixes #2896
• Fixed issue where XHR's onreadystatechange was not receiving the proper event arguments. Fixes #2925
• We now properly strip leading paths of files on uncaught errors from Windows OS. Fixes #2936

Misc:

• Removed the word 'already' from the Cypress install message in order to be less confusing. Adresses #2754
• Fixed incomplete type definitions for cy.request. Fixes #2305

Dependency Updates

• Upgraded commit-info from 2.0.0 to 2.1.1. Fixes #2848.
• Upgraded lodash from 4.17.10 to 4.17.11. Fixes #2929.

Released 12/03/2018

Bugfixes:

• Fixed regression introduced in 3.1.1 with requestAnimationFrame that caused some animations not to run. Fixes #2725.
• Fixed regression introduced in 3.1.2 that caused DOM elements passed to cy.wrap() to no longer yield the proper jQuery array instance. Fixes #2820.
• Fixed regression causing invocations of cy.clock() to error on subsequent tests. Fixes #2850.
• Fixed issue where a fix included in 3.1.2 did not pass the windowsHide argument to the proper options. Fixes #2667 and #2809.
• Passing .check({ force: true }) no longer requires the checkbox or radio to be visible. Fixes #1376.

Misc

• Updated types to support promises as arguments within cy.wrap. Fixes #2807.
• We now expose all jQuery methods and values onto "Cypress.$" $. Fixes #2830.
• cy.wait() now accepts a separate timeout option for requestTimeout and responseTimeout. Fixes #2446.

Dependency Updates

• Upgraded nodemon from ^1.8.1 to ^1.8.7. Fixes #2864.
• Upgraded request from ^2.27.0 and ^2.28.0 to ^4.0.0, Fixes #2455.

Documentation Changes:

• Added requestTimeout and responseTimeout options to cy.wait()
• Added 'History' table to cy.wait()
• Added 'Alias' for assertions that are aliases of each other to Assertions

Released 11/18/2018

Bugfixes:

• Fixed a regression caused in 3.1.1 where we attempted to set a property on an invalid cookie sent from a server. Fixes #2724.
• Fixed Cypress not correctly aborting long running connections (such as server sent events) on proxied requests. Fixes #2612.
• Fixed bug where tests were failing due to assertions causing Cypress to accidentally iterate through cross origin iframes. If you were seeing "random" cross origin errors, this likely fixes those issues. Fixes #2784.
• Fixed incorrectly setting charCode and keyCode when using .type() on a few different special characters such as {. Fixes #2105.
• Fixed another regression in 3.1.1 where passing undefined to a setTimeout caused Cypress to error. Fixes #2719.
• Fixed a bug in node core where Cypress would not show up in Windows for users on node >= 11. Fixes #2667.
• Fixed a bug with trashing assets in linux that caused recursive .Trash files to show up. We now have opted to actually rm -rf the files in linux because trashing is too inconsistent between linux distros. Fixes #2742.

Misc

• Added type definitions for Cypress.moment(). Fixes #2746.
• We now display better error messages in the CLI when runs exceed billing limits. Fixes #1689.

Dependency Updates

• Removed progress #2733.

Released 11/2/2018

Known regressions in this release ⚠️

• #2742 infinite .Trash-0 folder on Ubuntu 16
• #2724 setting HTTPS cookies in certain situations

Features:

• You can now pass a flag option to cy.writeFile(). The following flags are available. Fixes #1249.
• There is a new CYPRESS_DOWNLOAD_MIRROR environment variable for installing Cypress at a mirror url. Fixes #2609.
• The Module API now returns the runUrl from cypress.run(). Fixes #2596.
• Specs now properly display as focused when navigating through specs via the keyboard. Fixes #2273.

Bugfixes:

• Fixed a bug where Cypress would error when a secure cookie flag was set and then expired from an https url without the subsequent secure flag. Due to the way Cypress was constructing the url, this would fail to actually remove the cookie. Fixes #1264, #1321, #1799.
• We now truncate filenames for screenshots to not exceed 255 characters in length. Previously there were cases where the screenshot filename would exceed 255 characters and error. Fixes #2403 and #2665.
• Fixed issue when using cy.writeFile() and passing an object to a .json file. The object is now correctly written to the JSON file instead of a string. Fixes #2373.
• We updated how we handle trashAssetsBeforeRuns behavior. We now trash the contents of the screenshotsFolder and videosFolder directories instead of trashing the directories themselves. This helps maintain any file access permissions for the directories. Fixes #1943 and #2600.
• Fixed bug where mocked Dates using cy.clock() would not be an instance of Date. Fixes #2570.
• Directories within specs whose names contain . are now correctly read as directories instead of spec files within the Test Runner. Fixes #2423.
• Cypress no longer automatically takes screenshots of skipped tests. Fixes #2368.
• Fixed an issue where returning/resolving undefined from a cy.task() handler resulted in an incorrect runtime error. Fixes #2553.
• Update modifyObstructiveCode to account for framebusting techniques that use window.frameElement, so that Applications using this technique will run properly in Cypress. Fixes #2582.
• Fixed bug where only the first DOM element of an array of DOM elements would be blacked out after being passed as argument to blackout within cy.screenshot(). Fixes #2508.
• We fixed an issue involving timers after running cy.screenshot(). Fixes #2432.
• The Test Runner now retries node-originated errors from our internal API requests. Fixes #2341
• Fixed issue with multiple readyStateChanges with the same readyState. Fixes #1150.
• Fixed Type error being thrown for users using TypeScript 3. Fixes #2363.

Misc

• We are now collecting more environment variables from runs when run in Semaphore, GitLab, Bitbucket, Team Foundation Server, Codeship, and Shippable. Fixes #2460, #2358, #2343, and #2453.
• We now display better error messages in the CLI when runs exceed billing limits. Fixes #1689.
• The Test Runner's search now resets when switching between projects. Fixes #2512.
• Fixed internal Cypress tests. Fixes #2606.
• Replaced use of new Buffer with Buffer.from. Fixes #2626.
• Whitelisted autoScrollingEnabled to be saved in state.json. Fixes #2476.
• Fixed internal test error beforeSpecRun is not a function. Fixes #2401.
• Switched our internal tests to use CircleCI workspaces. Fixes #2398.
• Update TypeScript definition for cy.screenshot() to include screenshot specific options. Fixes #2654.
• Urls printed within the CLI will now display as the color blue. Fixes #2493.
• We began bulk converting some of our codebase from CoffeeScript to JavaScript. Fixes #2686 and #2687.
• We updated some of our internal ESLint rules to be more strict and also to help with CoffeeScript to JavaScript conversions. Fixes #2688.

Dependency Updates

• Upgraded common-tags from ^1.4.0 to ^1.8.0 #2415
• Upgraded @cypress/browserify-preprocessor from 1.1.0 to 1.1.1 #2513
• Upgraded lolex from ^1.5.2 to ^3.0.0 #2570 <!-- textlint-disable -->
• Upgraded @types/jquery from 3.2.16 to 3.3.6 #2363 <!-- textlint-enable -->
• Upgraded zunder from 5.6.5 to 6.1.1 #2541

Documentation Changes:

• Added flag option to cy.writeFile() doc.
• Added runUrl to returned run in Module API doc.
• Documented new CYPRESS_DOWNLOAD_MIRROR flag and rewrote advanced install instructions to be clearer in Installing Cypress doc.

Released 8/13/2018

Summary:

• Cypress can now run tests in parallel across multiple virtual machines, or can be parallelized on a single machine. Cypress will automatically figure out, detect, and load balance all of your specs in the fastest and most efficient way possible. There is no configuration other than passing a --parallel flag and spinning up multiple machines on your CI provider. From our experiments you can expect to see approximately 40% reduction in overall run time per machine you add. However, attempting to run in parallel on a single machine requires server grade hardware with dozens (or even hundreds) of CPU's and GB of RAM to run efficiently. A much better and simpler approach is to use a cluster of docker containers that are all isolated from each other. Any standard CI service (CircleCI, TravisCI, etc) comes with the ability to do this. We automatically tap into their environment variables to make parallelization possible without you having to configure anything.
• Beyond parallelization, you now have the ability to group multiple runs with each other so that they show up together (grouped) in the Dashboard. This enables you to test different applications, groups of specs, or different environments (like development, staging, production) and see all of the results together. We know how important cross browser testing is to everyone, so we built this to lead directly into aggregating the results of multiple browsers into a single run.
• The Dashboard Service has been updated to show you more visual information about what happened during a run. You can see how specs were parallelized and you can calculate the effect of adding or removing machines to help reduce the overall run time.

Features:

• cypress run accepts a new --parallel flag to run specs in parallel. Fixes #1690 and #64 and #2297.
• cypress run accepts a new --group flag to group multiple spec files within a single run. Fixes #2169
• cypress run accepts a new --ci-build-id flag. Fixes #2153.

Bugfixes:

• We've finally tracked down the source of specs "hanging" and failing to start when running Electron. We finally tracked it down to a bug in Electron itself with setting menu when using offscreen rendering. Fixes #2322 and #2294.
• Clicking on svg elements is now working. 3.0.2 introduced a bug that would throw an 'illegal invocation' error. Fixes #2245 and #2252 and #2258 and #2277 and #2288.
• Fixed a regression in 3.0.2 that caused typing {enter} not to submit a form when there were <button> elements other than type='submit'. Fixes #2261 and #2326.
• Fixed a small visual bug where failed commands were not aligned to other commands. Fixes #2314.
• Fixes a race condition where async electron browser commands came in after the renderer had been destroyed, causing failures. Fixes #2321.

Misc

• When recording to the Dashboard Service, we now provide estimated durations per spec directly within the standard output, as long as the spec has had enough run history for this to be determined. Fixes #2276.
• When using the new --parallel or --group feature, we now visually indicate that to you in the standard output when recording. Fixes #2275.
• We have added support for more CI providers to automatically detect and show more relevant information in the Dashboard, instead of showing 'Unknown'. Fixes #2146.
• We have added better checks and reliability for detecting runs in Jenkins. Fixes #1990.
• The built in cypress-browserify-preprocessor was bumped to 1.1.0. This supports more JavaScript features by default, including async/await, object rest spread, and class properties. Fixes #2254.
• cypress run now creates a new browser profile per run per browser, but keeps the same browser profile for interactive mode with cypress open. This means you can run Cypress locally over multiple processes and the browser profiles will not conflict with each other. Fixes #1566.
• The Desktop-GUI has been updated to get the new routes provided by the Cypress API for runs. Fixes #2189.
• Cypress now retries multiple times (with a backoff strategy) when communicating with our API fails while recording runs. This will provide better feedback in situations when the API is temporarily unavailable. Fixes #1590.
• When Cypress retries due to an API timeout or failure it now displays a very nice message indicating to you the delay and number of retries left. Fixes #2280.
• We've added parallelization to our own internal tests for the driver and the desktop-gui. We've been able to reduce the number of concurrent instances our tests use by 4, and shaved about 6 minutes off of each build. Faster with less resources. Fixes #2325.

Documentation Changes:

• Added Parallelization doc.
• Update Dashboard Service doc with new screenshots and run sections.
• Update Command Line doc with new flags and alphabetized flags.

Released 7/30/2018

Bugfixes:

• Reverted the Chrome argument that disabled RootLayerScrolling which was used to prevent the application under test from "shaking" due to a bug in versions 66 and 67. This workaround inadvertently created a different and much more severe bug in Chrome 68 that would miscalculate pointer coordinates. This led to Cypress giving confusing errors about elements being covered up on action. This is still a bug in Chrome, and is fixed in Canary but has not yet been released to the stable Chrome 68 channel. Nevertheless, removing the RootLayerScrolling flag does fix it. We did several experiments to try to ensure that the "shaking" behavior does not exhibit itself in Chrome 68. We have limited the --disable-blink-features=RootLayerScrolling flag to Chrome 66 and Chrome 67. Fixes #2223 and #2215 and #2037.
• Fixed another bug with Chrome that caused the chromeWebSecurity: false option to not be respected. This was due to Chrome progressively rolling out trials of a new option that attempts to isolate sites (and iframes) in their own child process if their origins are different. Fixes #1951 and #2001 and #715.
• Fixed Cypress hanging in CI due to excessive and unnecessary globbing. We finally tracked down this issue which made it appear as if Cypress was "hanging" after closing a spec file and then attempting to open the next one. Fixes #2183 and #1905 and #1912.
• We are now properly serializing nested object arguments when using the Module API via cypress.open() or cypress.run(). Passing nested objects in reporterOptions now works correctly. This is especially useful when using mocha-multi-reporters. In addition to fixing the Module API, we are now also properly handling nested arguments from the Command Line. In order to pass nested objects within CLI params you must pass stringified JSON. This is useful for properties such as blacklistHosts. Fixes #1348 and #1357 and #2221.
• Fixed a bug causing screenshots saved via cy.screenshot() to be in different folders when you ran using cypress run vs cypress run . Fixes #2091.
• Fixed bugs with Electron losing focus when running headlessly via cypress run after navigation. Now the browser will always act as if it is focused no matter what and in all situations when running headlessly. If you were seeing focus related problems when running headlessly, this should fix them. Fixes issue #2190.
• Fixed using when using cy.click() on an element that bound to the focus event while the browser was currently out of focus. We have now normalized all focus and blur events to behave the same as if the browser is always in focus. This should fix the other batch of blur and focus issues that users have been experiencing. Fixes #549 and #2198.
• Fixed the vast majority of known issues with .type(). Fixes #1241.
• Using .type() on an input of type email or number will no longer fire unnecessary additional blur and focus events. Fixes #2210.
• Fixed .type() breaking on chains when passing the same options references. Fixes #365.
• Fixed an issue with .clear() not behaving the same as cy.type('{selectall}{backspace}'). Fixes #420.
• Fixed a bug with issuing an additional blur and click event when chaining .clear().type(...). Fixes #593.
• Fixed many issues with typing into [contenteditable] elements. WYSIWYG, Draft.js based, and other HTML editors now work correctly. Fixes #596 and #1686 and #2096.
• The caret now correctly moves on [contenteditable] elements. Fixes #1108.
• Fixed .type() inserting a rogue <br> tag after the first letter in [contenteditable] elements. Fixes #1926.
• Fixed issue where change events with .type() would not fire correctly for many more situations and edge cases. Fixes #651.
• Fixed issues with typing into JS based text-mask plugins. Basically anything that would alter the .value in response to certain events now works correctly. Fixes #940 and #1684.
• Using .clear() on an input with a maxlength attribute now works. Fixes #1002 and #2056.
• Fixed issues with .type() not firing the change event on input[type=number]. Fixes #1171.
• Fixed other event related issues with .type() that were not firing correctly. Fixes #1209.
• Fixed even more issues with .type() not inserting characters on input[type=number]. Fixes #1381.
• Fixed not being able to type negative numbers into input[type=number] elements. Fixes #2173.
• Fixed selectionStart and selectionEnd with .type() when using {leftarrow} or {rightarrow}. Fixes #1234.
• Fixed not being able to type into a datetime-local input. Fixes #1366.
• Calling .focus() or .blur() on cy.window() no longer fires blur events on the activeElement or causes it to become body. Fixes #2234.
• Using cy.get('body').click() now correctly changes the activeElement back to body and causes the existing activeElement to receive blur. Fixes #2236.

Misc:

• We've loosened up the restrictions surrounding what we consider a typeable element. You can now type into inputs with invalid type attributes because the browser does still consider them regular text inputs and allows you to type into them. Fixes #586.
• Using {uparrow} or {downarrow} with .type() on an input[type=number] element now increments or decrements the number configured via the step attribute. Fixes #2110.
• Using {uparrow} or {downarrow} with .type() now correctly moves the cursor on textarea or [contenteditable] elements. Fixes #2187.
• You can now use .focus() or .blur() on cy.get('body'). Fixes #2235.
• Bumped the version in junit reporter dep from 1.12.1 to 1.17.0 which adds a few new features. Fixes #2238.
• Bumped deps that npm audit was yelling about. Fixes #1701.
• Runs showing up in the Runs tab now more closely match how they display in the Dashboard. Fixes #2060.
• Added more debug logs. Fixes #2108.
• When recording to the Dashboard we now more accurately collect commit details when it is missing from the local git data. Fixes #2129 and #2073.
• We now collect the pull request information if you are recording in a CI provider that connects commits to PRs. Fixes #1844.
• Updated build in example kitchen sink to 1.0.2. Fixes #2139.
• Updated the json-schema describing videoCompression. Allowing it to be a boolean. Fixes #2140.

Documentation Changes:

• New "Module API" doc

Released 6/28/2018

Bugfixes:

• Screenshots taken with cy.screenshot() on 2x DPI are now taken at the correct full size. Fixes #1857 and #2018.
• Windows users no longer exit with EPIPE errors when running cypress run in newer versions of node. Fixes #1841 and #2044.
• Fixed issue where applications programmatically stealing focus would lead to slow runs in Electron when running via cypress run. #1909 and #1892.
• Electron no longer reports the browser as out of focus when running via cypress run. Fixes #1939.
• Modified the document.hasFocus() method to return true if the top window (Cypress window) is in focus. This should now correctly match how your application behaves outside of Cypress. Fixes #1940.
• Fixed issue where Cypress would unnecessarily scroll when attempting to locate elements with position: sticky. Fixes #1475.
• Fixed a bug where changing the integrationFolder in Windows would lead to errors with plugins. Fixes #1704.
• Cypress no longer crashes when a 3rd party server sends invalid gzip content. Also fixed issues with incorrectly gunzipping multibyte characters which would potentially lead to serving invalid HTML or JS. Fixes #1396 and #1756.
• The --silent flag should now be respected during npm install cypress on all OSes. Fixes #817.
• Corrected a typo in the CLI for a warning message. Fixes #2038.
• Fixed some areas of the Desktop GUI that did not display path names correctly in Windows. Fixes #1830.
• The pluginsFile now supports an absolute path instead of just a relative one. Fixes #1837.
• Fixed a regression introduced in 3.x.x where application code that used setTimeout with a string argument would see the error fn.apply is not a function. Fixes #1854.
• Fixed issue where preprocessor errors were being swallowed. Fixes #1877.
• Fixed issue where Cypress would hang indefinitely when starting a new spec when in cypress run mode. Additionally we have optimized the code path to not read in the local state.json unnecessarily. Fixes #2013 and #1912 and #1905 and #1890.
• Fixed a couple regressions in the Dashboard where timed out runs stayed "Pending" forever. Fixes #1891 and #1952.
• Fixed another Dashboard regression where an error would throw when recording tests and sending a large list of specs. Fixes #1901.
• Fixed issue where videos would not be recorded when an object was returned from before:browser:launch when in the Electron browser. Fixes #1992.
• Fixed an issue where Cypress would inject content into the <header> tag instead of the <head> tag. Fixes #2026.
• Fixed an oversight where a specific framebusting check was not being properly stripped and removed by the default config option modifyObstructiveCode. Fixes #2030 and #2059.
• Fixed icons visually shifting when tests were running in the Test Runner. Fixes #1983.
• Server sent events now finally work correctly in Cypress. Fixes #1440 and #1111.
• Time traveling snapshots now preserve the styles of empty <style> tags with programmatically inserted CSS rules. Fixes #1226.

Misc:

• There are now several new CLI commands for interacting with the binary cache: cypress cache path, cypress cache list, and cypress cache clear. Fixes #1856.
• We've added a new CLI flag: --no-exit for cypress run to keep the browser open after the tests finish running. Fixes #1871.
• The CLI now respects config values and environment variables put in your .npmrc file. Fixes #1399 and #1853.
• Significantly improved the performance of taking screenshots. #1863.
• Node module dependencies updated. Fixes #1674 and #1942.
• The bundled version of ffmpeg has now been bumped from 3.x.x to 4.x.x. This may help with some issues users were experiencing when recording videos. Fixes #1972.
• Added more debug logs to ffmpeg to determine why ffmpeg compression sometimes causes Cypress to crash (mostly while running in Travis CI). Fixes #1971.
• Several improvements to TypeScript typings. Fixes #1881 and #2007 and #1899 and #1902 and #1897 and #1907.
• We improved error logging and the user experience around cypress verify. Fixes #1984.
• We no longer log the skipping install message if the Cypress binary is already installed locally. Fixes #1985.
• Now, by default, screenshots are nested within a folder with the name of the spec file that is currently running. Example - the spec named cypress/integration/foo/bar_spec.js will save screenshots inside of this directory: cypress/screenshots/foo/bar_spec.js/*. Fixes #1826.
• Passing foo/bar/baz as the fileName arg to cy.screenshot() inside a spec, app.spec.js, will now result in the screenshot being saved to a nested folder path such as: cypress/screenshots/app.spec.js/foo/bar/baz.png. Fixes #1771 and #668.
• We now append (failed) to the screenshot filename of screenshots taken automatically during test failure. Fixes #1923.
• If multiple screenshots are taken during a test that will result in the same filename, their file paths are now appended with a number, i.e. test name (1).png. This prevents screenshot files with the same name from being overwritten. Fixes #1766.
• Screenshot onAfterScreenshot and onBeforeScreenshot callbacks ar enow invoked for failed tests. They include a testFailure property to distinguish between automatic ones and your own use of cy.screenshot(). Fixes #2040.
• There's now an after:screenshot plugin event you can use in your pluginsFile to work with screenshots after they are taken. This enables you to rename them, move their location, resize them, send them to a service, etc. Fixes #2039.
• Added Cypress.browser object which contains information about the currently running browser. Fixes #1919 and #1961.
• Added Cypress.spec object which contains information about the currently running spec. Fixes #1918.
• Urls displayed in the Command Log during cy.visit() are no longer arbitrarily truncated at a set width. Fixes #1995.

Documentation Changes:

• Update cy.screenshot() doc to include new file naming behavior
• Updated "Command Line" doc to include new cache commands
• Added Cypress.browser doc.
• Added Cypress.spec doc.
• Added after:screenshot plugin event doc.

Released 5/30/2018

Bugfixes:

• Seeded KitchenSink tests no longer fail. Fixes #1812.
• The binary cache now correctly works and will not reinstall Cypress if an existing version is already installed. Fixes #1813.
• Closing the Electron browser and then opening Chrome no longer causes cy.screenshot() to fail. Fixes #1820.
• Fixed a bug with Windows users seeing crashes with tty.getWindowSize is not a function. Fixes #1815 and #1817.

Released 5/29/2018

Summary:

• There is a new cy.task() command that enables you to go outside the browser to perform tasks directly in node. This will make it easy to setup, scaffold, seed, talk to your database, or anything else useful on a backend.
• cy.screenshot() has been rewritten from the ground up. It now takes a screenshot of only the application under test by default. It also can take full page screenshots or element only screenshots. This is the first step of Cypress Dashboard support for screenshot diffing.
• When running with cypress run we now run each spec file in isolation from others. We have rewritten our reporter to provide more details and provide a summary of the run at the bottom.
• The Dashboard has been upgraded to make it easier to understand the results of each spec run. This was done in anticipation of providing you the ability to parallelize and load balance your spec files automatically in CI.
• We are now capturing the performance and timings data of every test when using --record mode and are beginning to offer the first analytics and insights into the health of your tests on our Dashboard service.
• Cypress now caches globally per version which prevents it from being installed multiple times across projects.

Breaking Changes:

• We now run each spec file in isolation from one another. This shouldn't technically break anything, but if you have set up your tests in a way that requires the state of a previous spec file, this could potentially break your tests. This will go a long ways towards reducing problems we were seeing with long runs in CI. Fixes #431, #681, #1589, #1539, and #1692.
• The environment variable CYPRESS_BINARY_VERSION has been removed. You should use the equivalent environment variable CYPRESS_INSTALL_BINARY instead.
• The environment variable CYPRESS_SKIP_BINARY_INSTALL has been removed. To skip the binary install, set CYPRESS_INSTALL_BINARY=0.
• screenshotOnHeadlessFailure has been removed as an option in cypress.json. Instead you can now control this behavior directly with code by setting screenshotOnRunFailure to false within the new Screenshot API. Fixes #1140 and #1754.
• trashAssetsBeforeHeadlessRuns has been renamed to trashAssetsBeforeRuns in our configuration. Fixes #1754.
• videoRecording has been renamed to video in our configuration to be clearer and prevent confusion about recording to our Dashboard. Fixes #562.
• Cypress no longer copies screenshots and videos to artifacts for CircleCI. Copying artifacts should be left up to the user to handle themselves in their circle.yml file. Fixes #1592.
• The standard output has been redesigned to better visualize spec files running in isolation and to be more visually appealing. This may break any specialized logic written that expected the standard output to be structured in a specific way or contain specific words. Fixes #1588.
• cy.screenshot() no longer takes a screenshot of the runner by default. Instead it will hide the runner, remove application scaling and then scroll to take a full page picture of your application.
• before and after hooks within a support file now run before/after every spec file, instead of only once before/after the entire run. #681

Features:

• There is a new cy.task() command for executing any arbitrary node code.
• You can now run multiple specs by passing a glob to the --spec argument of cypress run. Fixes #263, #416 and #681.
• There is a new Screenshot API and new cy.screenshot() options that allow you set defaults for how screenshots are captured, whether to scale your app, disable timers and animations, or which elements to black out in the screenshot. You can also set defaults for whether to automatically take screenshots when there are test failures or whether to wait for the Command Log to synchronize before taking the screenshot. Fixes #1424.
• cy.screenshot() can now be chained off of commands that yield a DOM element and will only take a screenshot that element.
• During install of cypress, the Cypress binary is now downloaded to a global cache. This prevents multiple projects from downloading the same Cypress version. Fixes #1300.
• The seeded example_spec.js file has been replaced by an examples folder with several spec files. This more closely reflects the recommended use of Cypress - as smaller groups of tests split among many files that will now be run in isolation. The tests were also updated from ES5 to ES6. You can see all changes in the cypress-example-kitchensink repo Fixes #1460.
• Cypress now watches all the plugins file's entire dependency tree to make iterating on plugins easier. Fixes #1407.
• Videos will now be saved locally with a filename named after the associated spec file that it represents. Fixes #980.
• The Test Runner now displays skipped tests differently than pending tests. #244.
• Standard output now displays the number of skipped tests within the summary output during cypress run. #1559.
• The url to view the run in the Dashboard is now printed to output during cypress run. #494.
• We now print the browser and browser version run in the output during cypress run. #833.
• The build number and url to CI for tests run within Drone are now captured and displayed on the run within the Dashboard. #1709.

Bugfixes:

• Cypress no longer crashes when attempting to proxy a websocket connection that fails. Fixes #556.
• Asserting that an attribute equals a falsy value no longer fails when the value was falsy. Fixes #831 and #1491.
• Snapshots now ignore stylesheets with media="print". Fixes #1568.
• Fixed issue where the Cypress window was being returned instead of AUT's window. Fixes #1436.
• The close event now properly fires on file when manually closing the browser. Fixes #1560.
• cypress.env.json is now being watched for changes. Fixes #1464.
• Fixed issue when using TypeScript that caused namespace errors to be thrown. Fixes #1627.
• Fixed error message on .type() and .clear() when typing into non-typeable elements or clearing non-clearable elements to accurately list the elements allowed. Fixes #1650.
• Added Chrome flag --disable-blink-features=RootLayerScrolling to prevent the application under test from "shaking" in recent versions of Chrome. Fixes #1620.
• Fixed issue where some TTY characters were not properly formatted in the terminal for Windows during cypress run. Fixes #1143 and #1550.
• Removed an extraneous error display from Electron during cypress run about a "transparent titlebar" setting. Fixes #1745.

Misc:

• We are now aggressively turning on colors when running in CI. If you're using Jenkins and do not have an ANSI color plugin installed, you can turn off colors with the NO_COLOR=1 environment variable. Fixes #1747 and #1748.
• When running cypress run --record on forked PR's, we now detect that the Record Key is missing and do not fail the build. We will display a warning, but continue running the tests. Fixes #1193.
• Searching in the Test Runner now filters out any non-matching folders. Fixes #1706.
• Duplicate, subsequent logs in the Command Log are now collapsed and can be expanded to view all logs. Fixes #1580.
• We now throw a descriptive error if an alias using .as() was defined starting with the @ character. #1643.
• We now pass the --disable-device-discovery-notifications flag automatically. This should prevent Chromium browser from automatically trying to communicate with devices in your network, such as printers, while running tests. Fixes #1600.
• We now pass any reporter errors along and provide a stack if a custom reporter you've provided does not exist. Fixes #1192.
• You can now pass a normal object to cypress.open() or cypress.run() through the Module API, just as you would from the command line. #1442.
• Added type definitions for Cypress.off and Cypress.log. Fixes #1110 and #1591.
• Update type definitions for cy.screenshot() to reflect new changes to command's options. Fixes #1753.
• The type definition for .filter() now correctly supports a function argument.
• The type definition for .scrollIntoView() no longer errors when passed a duration option. Fixes #1606.
• NODE_OPTIONS environment variables now print within the cypress:cli logs when running in DEBUG mode. Although using NODE_OPTIONS themselves should not be used due to #1676. Fixes #1673.
• Cypress will error and exit with status 1 if no specs were found during cypress run. Fixes #1585.
• We are now counting and aggregating the stats at the end of test runs separately from Mocha. Cypress considers a test to be the it and any accompanying hooks that run before or after a test. Cypress will correctly associate failures in those hooks to the test itself. We believe this more accurately models and just "makes sense". Fixes #1163.
• The minimum viewport size has been lowered from 200 pixels to 20 pixels. Fixes #1169 and #1444.
• Internal changes to our API structure and communication. Fixes #1170, #1413, #1415.
• We output a much more complete test results object when using cypress as a module. Fixes #1248.
• Added keywords to Cypress NPM package. Fixes #1508.
• Centered the animating icon in the Test runner when 'running'. Fixes #1695.
• We made some changes to internal references of headed and headless to be more specific and instead reference run mode and interactive mode. Fixes #1140.
• The test name text is now selectable inside the Command Log. Fixes #1476.
• Minor improvements to contributing docs and scripts. Fixes #1665.
• We now collect Semaphore CI params and provide URL's to click into the builds from the Dashboard. Fixes #1785.
• Config overrides coming from the CLI or environment variables are now validated the same way as if they've been set in cypress.json. Fixes #1783.
• There is a better / more helpful experience around passing unknown options to the CLI. Fixes #837.
• Display an empty message when there is no commit information on recorded runs. Fixes #1809.

Documentation Changes:

• New cy.task() doc
• New Screenshot API doc
• Update cy.screenshot() doc to include new accepted usage and options
• Update Installing Cypress doc to include new options for Cypress binary caching
• Updated Writing and Organizing Tests to include newly seeded examples folder
• Updated cypress run spec args
• Updated Dashboard Service
• Updated Launching Browsers to include our disabling of device discovery notifications
• Updated Preprocessors to reflect all ways close event could be triggered
• Updated use of "running headlessly" to more accurate "during cypress run"