Changelog
13.16.1​
Released 12/04/2024
Bugfixes:
- During recorded or parallel runs, execution will fail if Cypress is unable to confirm the creation of an instance instead of skipping the spec. Addresses #30628.
13.16.0​
Released 11/19/2024
Features:
- Added new
defaultBrowser
configuration option to specify the default browser to launch. This option only affects the first browser launch; changing this option after the browser is already launched will have no effect. Addresses #6646.
Bugfixes:
- Fixed an issue where some JS assets were not properly getting sourcemaps included with the vite dev server if they had a cache busting query parameter in the URL. Fixed some scenarios to ensure that the sourcemaps that were included by the vite dev server were inlined. Addressed in #30606.
Misc:
- Updated the protocol to be able to flex logic based on project config. Addresses #30560.
13.15.2​
Released 11/5/2024
Bugfixes:
- Fixed an issue where the Cypress runner could hang in
after
orafterEach
hooks that run Cypress commands after a page load timeout error occurs. Addresses #30238.
Misc:
- Fixed a typo in CLI
global
option help text. Addresses #30531.
Dependency Updates:
- Updated
mobx
from5.15.4
to6.13.5
andmobx-react
from6.1.8
to9.1.1
. Addresses #30509. - Updated
@cypress/request
from3.0.4
to3.0.6
. Addressed in #30488.
13.15.1​
Released 10/24/2024
Bugfixes:
- Patched find-process to fix an issue where trying to clean up browser profiles can throw an error on Windows. Addresses #30378.
- Fixed an issue where requests to the same resource in rapid succession may not have the appropriate static response intercept applied if there are multiple intercepts that apply for that resource. Addresses #30375.
Misc:
- Cypress now consumes geckodriver to help automate the Firefox browser instead of marionette-client. Addresses #30217.
- Cypress now consumes webdriver to help automate the Firefox browser and firefox-profile to create a firefox profile and convert it to Base64 to save user screen preferences via
xulstore.json
. Addresses #30300 and #30301. - Spec information is now passed to protocol's
beforeSpec
to improve troubleshooting when reporting on errors. Addressed in #30316.
Dependency Updates:
- Updated
simple-git
from3.16.0
to3.25.0
. Addressed in #30076.
13.15.0​
Released 9/25/2024
Features:
- Cypress now displays more actionable errors when a Test Replay upload takes too long, and more verbose messages when uncategorized errors occur during the upload process. Addressed in #30235.
Bugfixes:
- Fixed an issue where Firefox was incorrectly mutating the state of click events on checkboxes after Firefox version
129
and up. Addressed in #30245. - Fixed a regression introduced in 13.13.0 where 'Open in IDE' would not work for filepaths containing spaces and various other characters on Windows. Addresses #29820.
Misc:
- Pass along the related log to the
createSnapshot
function for protocol usage. Addressed in #30244.
Dependency Updates:
- Update
@cypress/request
from3.0.1
to3.0.4
. Addressed in #30194. - Updated
express
from4.19.2
to4.21.0
. This removes the CVE-2024-43796, CVE-2024-45590, and CVE-2024-43800 vulnerabilities being reported in security scans. Addresses #30241. - Update
launch-editor
from2.8.0
to2.9.1
. Addressed in #30247. - Updated
loader-utils
from1.4.0
to1.4.2
. This removes the CVE-2022-37601 vulnerability being reported in security scans. Addresses #28208. - Updated
send
from0.17.1
to0.19.0
. This removes the CVE-2024-43799 vulnerability being reported in security scans. Addressed in #30241.
13.14.2​
Released 9/4/2024
Bugfixes:
- Fixed an issue where Cypress could crash with a
WebSocket Connection Closed
error. Fixes #30100. - Fixed an issue where
cy.screenshot()
was timing out and Cypress was failing to start due toGLib-GIO-ERROR
error. Reverts #30109, the change to allow HiDPI screen for Wayland users. Fixes #30172 and #30160.
13.14.1​
Released 8/29/2024
Bugfixes:
- Fixed an issue where no description was available for the
experimentalJustInTimeCompile
feature inside the Cypress application settings page. Addresses #30126.
13.14.0​
Released 8/27/2024
Performance:
- Fixed a potential memory leak in the Cypress server when re-connecting to an unintentionally disconnected CDP connection. Fixes #29744. Addressed in #29988.
Features:
- Added new
experimentalJustInTimeCompile
configuration option for component testing. This option will only compile resources directly related to your spec, compiling them 'just-in-time' before spec execution. This should result in improved memory management and performance for component tests incypress open
andcypress run
modes, in particular for large component testing suites.experimentalJustInTimeCompile
is currently supported forwebpack
andvite
. Addresses #29244. .type({upArrow})
and.type({downArrow})
now also works for date, month, week, time, datetime-local and range input types. Addresses #29665.- Added a
CYPRESS_SKIP_VERIFY
flag to enable suppressing Cypress verification checks. Addresses #22243. - Updated the protocol to allow making Cloud API requests. Addressed in #30066.
- Passing
--browser
flag alone will automatically launch browser after being guided through project and/or testing type selection. Addressed in #28538.
Bugfixes:
- Fixed an issue where files outside the Cypress project directory were not calculating the bundle output path correctly for the
file:preprocessor
. Addresses #8599. - Fixed an issue where Cypress would not run if Node.js version
22.7.0
was being used with TypeScript and ES Modules. Fixes #30084. - Correctly determines current browser family when choosing between
unload
andpagehide
options in App Runner. Fixes #29880.
Misc:
- Allow HiDPI screen running Wayland to use Cypress window/browser by adding
--ozone-platform-hint=auto
flag to Electron's runtime argument. Addresses #20891.
Dependency Updates:
- Updated
detect-port
from1.3.0
to1.6.1
. Addressed in #30038.
13.13.3​
Released 8/14/2024
Bugfixes:
- A console error will no longer display in Chrome about a deprecated unload call originating from jQuery. Addressed in #29944.
- Fixed an issue where certain Test Replay upload error messages were too vague. Connection failures now report the precise system error, and the stall error message is reported rather than the vague, "The user aborted a request." Addressed in #29959.
Misc:
- Updated
cypress open
hints displayed after Cypress binary install. Addresses #29935.
Dependency Updates:
- Updated
image-size
from0.8.3
to1.1.1
. Addressed in #30023.
13.13.2​
Released 7/31/2024
Performance:
- Fixed a memory leak with command logs with Test Replay enabled. Addressed in #29939.
- Improved performance of
reduce
in a method within our proxy. Addressed in #29887.
Bugfixes:
- Fixed an issue where Yarn PnP was not working correctly with Cypress and
@cypress/webpack-batteries-included-preprocessor
. Fixes #27947.
Dependency Updates:
- Updated
@cypress/request
from3.0.0
to3.0.1
. Addresses #29863. - Updated
chrome-remote-interface
from0.33.0
to0.33.2
. Addressed in #29932. - Updated
mime
from2.4.4
to2.6.0
. Addressed in #29870. - Updated
strip-ansi
from6.0.0
to6.0.1
. Addressed in #29931.
13.13.1​
Released 7/16/2024
Bugfixes:
- Fixed an issue where unhandled
WebSocket connection closed
exceptions would be thrown when CDP connections rapidly connect, disconnect, and connect again while there are pending commands. Fixes #29572. - CLI output properly displays non-JSON response bodies when a Test Replay upload attempt returns a non-JSON response body for a non-200 status code. Addressed in #29801.
- Fixed an issue where the ReadStream used to upload a Test Replay recording could erroneously be re-used when retrying in cases of retryable upload failures. Fixes #29227.
- Fixed an issue where command snapshots were not being captured within the
cy.origin()
command within Test Replay. Addressed in #29828.
Dependency Updates:
- Updated
jquery
from3.1.1
to3.4.1
. Addresses #29822. Addressed in #29837. - Replaced
json-lint
withjson-parse-even-better-errors
. This removes the CVE-2021-23358 vulnerability being reported in security scans. Addresses #28207. - Updated
minimatch
from3.0.4
to3.1.2
. Addressed in #29821.
13.13.0​
Released 7/02/2024
Performance:
- Improved performance of
experimentalSourceRewriting
option. Fixed in #29540.
Features:
- Adds Signal support for Angular Component Testing versions 17.2 and up. Addresses #29264.
Bugfixes:
- Fixed an issue where Chrome launch instances would not recreate the browser CRI client correctly after recovering from an unexpected browser closure. Fixes #27657. Fixed in #29663.
- Fixed an issue where Firefox 129 (Firefox Nightly) would not launch with Cypress. Fixes #29713. Fixed in #29720.
Dependency Updates:
- Updated
launch-editor
from2.3.0
to2.8.0
. Addressed in #29770. - Updated
memfs
from3.4.12
to3.5.3
. Addressed in #29746. - Updated
tmp
from0.2.1
to0.2.3
. Addresses #29693. - Updated
ws
from5.2.3
to5.2.4
. Addressed in #29698.
13.12.0​
Released 6/18/2024
Features:
- Added Component Testing support for Angular version 18. Addresses #29309.
Bugfixes:
- We now trigger
input
andchange
events when typing{upArrow}
and{downArrow}
via.type()
oninput[type=number]
elements. Fixes #29611. - Fixed an issue where auto scrolling the reporter would sometimes be disabled without the user's intent. Fixes #25084.
- Fixed an issue where
inlineSourceMaps
was still being used whensourceMaps
was provided in a user's TypeScript config for TypeScript version 5. Fixes #26203. - When capture protocol script fails verification, an appropriate error is now displayed. Previously, an error regarding Test Replay archive location was shown. Addressed in #29603.
- Fixed an issue where receiving HTTP responses with invalid headers raised an error. Now Cypress removes the invalid headers and gives a warning in the console with debug mode on. Fixes #28865.
Misc:
- Report afterSpec durations to Cloud API when running in record mode with Test Replay enabled. Addressed in #29500.
Dependency Updates:
- Updated firefox-profile from
4.3.1
to4.6.0
. Addressed in #29662. - Updated typescript from
4.7.4
to5.3.3
. Addressed in #29568. - Updated url-parse from
1.5.9
to1.5.10
. Addressed in #29650.
13.11.0​
Released 6/4/2024
Performance:
- Improved performance when setting console props within
Cypress.log
. Addressed in #29501.
Features:
- Added support for Next.js 14 for component testing. Addresses #28185.
- Added an
IGNORE_CHROME_PREFERENCES
environment variable to ignore Chrome preferences when launching Chrome. Addresses #29330.
Bugfixes:
- Fixed a situation where the Launchpad would hang if the project config had not been loaded when the Launchpad first queries the current project. Fixes #29486.
- Pre-emptively fix behavior with Chrome for when
unload
events are forcefully deprecated by usingpagehide
as a proxy. Fixes #29241.
Misc:
- Enhanced the type definitions available to
cy.intercept()
andcy.wait()
. Thebody
property of both the request and response in an interception can optionally be specified with user-defined types. Addresses #29507.
13.10.0​
Released 5/21/2024
Features:
Bugfixes:
- Fixed an issue where orphaned Electron processes were inadvertently terminating the browser's CRI client. Fixes #28397. Fixed in #29515.
- Fixed an issue where Cypress would use the wrong URL to upload Test Replay recordings when it wasn't able to determine the upload URL. It now displays an error when the upload URL cannot be determined, rather than a "Request Entity Too Large" error. Addressed in #29512.
- Fixed an issue where Cypress was unable to search in the Specs list for files or folders containing numbers. Fixes #29034.
- Fixed an issue setting the
x-cypress-file-path
header when there are invalid header characters in the file path. Fixes #25839. - Fixed the display of some command assertions. Fixed in #29517.
Dependency Updates:
- Updated js-cookie from
2.2.1
to3.0.5
. Addressed in #29497. - Updated randomstring from
1.1.5
to1.3.0
. Addressed in #29503.
13.9.0​
Released 5/7/2024
Features:
- Added more descriptive error messages when Test Replay fails to record or upload. Addresses #29022.
Bugfixes:
- Fixed a bug where promises rejected with
undefined
were failing insidecy.origin()
. Addresses #23937. - We now pass the same default Chromium flags to Electron as we do to Chrome. As a result of this change, the application under test's
navigator.webdriver
property will now correctly betrue
when testing in Electron. Fixes #27939. - Fixed network issues in requests using fetch for users where Cypress is run behind a proxy that performs HTTPS decryption (common among corporate proxies). Fixes #29171.
- Fixed an issue where extra windows weren't being closed between specs in Firefox causing potential issues in subsequent specs. Fixes #29473.
Misc:
- Improved accessibility of the Cypress App in some areas. Addressed in #29322.
Dependency Updates:
- Updated electron from
27.1.3
to27.3.10
to address CVE-2024-3156. Addressed in #29431.
13.8.1​
Released 4/23/2024
Performance:
- Fixed a performance issue with activated service workers that aren't controlling clients which could lead to correlation timeouts. Fixes #29333 and #29126.
Bugfixes:
- Fixed a regression introduced in 13.6.0 where Cypress would occasionally exit with status code 1, even when a test run was successful, due to an unhandled WebSocket exception (
Error: WebSocket connection closed
). Addresses #28523. - Fixed an issue where Cypress would hang on some commands when an invalid
timeout
option was provided. Fixes #29323.
Misc:
.its()
type now excludes null and undefined. Fixes #28872.
Dependency Updates:
- Updated zod from
3.20.3
to3.22.5
. Addressed in #29367.
13.8.0​
Released 4/18/2024
Features:
- Added support for
webpack-dev-server
v5
to@cypress/webpack-dev-server
. Addresses #29305.
Bugfixes:
- Fixed a regression introduced in 13.7.3 where Cypress could hang handling long assertion messages. Fixes #29350.
Misc:
- The
SEMAPHORE_GIT_PR_NUMBER
environment variable from Semaphore CI is now captured to display the linked PR number in the Cloud. Addressed in #29314.
13.7.3​
Released 4/11/2024
Bugfixes:
- Fixed an issue where asserts with custom messages weren't displaying properly. Fixes #29167.
- Fixed an issue where Cypress launch arguments were not being escaped correctly with multiple values inside quotes. Fixes #27454.
Misc:
- Updated the Chrome flags to not show the "Enhanced Ad Privacy" dialog. Addresses #29199.
- Suppresses benign warnings that reference Vulkan on GPU-less hosts. Addresses #29085. Addressed in #29278.
13.7.2​
Released 4/2/2024
Performance:
Bugfixes:
- Fixed an issue where Cypress was not executing beyond the first spec in
cypress run
for versions of Firefox 124 and up when a custom user agent was provided. Fixes #29190. - Fixed a bug where fields using arrays in
cypress.config
are not correctly processed. Fixes #27103. Fixed in #27312. - Fixed a hang where Cypress would run indefinitely while recording to the cloud when CDP disconnects during the middle of a test. Fixes #29209.
- Fixed a bug where option values containing quotation marks could not be selected. Fixes #29213.
Dependency Updates:
- Updated express from
4.17.3
to4.19.2
. Addressed in #29211.
13.7.1​
Released 3/21/2024
Bugfixes:
- Fixed an issue where Cypress was not executing beyond the first spec in
cypress run
for versions of Firefox 124 and up. Fixes #29172. - Fixed an issue blurring shadow dom elements. Fixed in #29125.
Dependency Updates:
- Updated jose from
4.11.2
to4.15.5
. Addressed in #29086.
13.7.0​
Released 3/13/2024
Features:
- Added shadow DOM snapshot support within Test Replay in order to highlight elements correctly within the Cypress reporter. Addressed in #28823.
- Added TypeScript support for Vue 2.7+. Addresses #28591.
- Adds additional context to error messages displayed when Test Replay artifacts fail to upload. Addressed in #28986.
Performance:
- Fixed a performance regression from 13.6.3 where unhandled service worker requests may not correlate correctly. Fixes #28868.
- Reduces the number of attempts to retry failed Test Replay artifact uploads from 8 to 3, to reduce time spent on artifact upload attempts that will not succeed. Addressed in #28986.
Bugfixes:
- Changed screenshot capture behavior in Chromium to activate the main Cypress tab before capturing. This prevents screenshot capture from timing out in certain situations. Fixed in #29038. Fixes #5016
- Fixed an issue where
.click()
commands on children of disabled elements would still produce "click" events -- even without{ force: true }
. Fixes #28788. - Changed RequestBody type to allow for boolean and null literals to be passed as body values. #28789.
Misc:
- Changed Component Testing scaffolding instruction to
pnpm add
to add framework dependencies when a project usespnpm
as package manager. Addresses #29052. - Command messages in the Cypress command logs will now truncate display at 100 lines instead of 50. Fixes #29023.
- Capture the
beforeTest
timestamp inside the browser for the purposes of accurately determining test start for Test Replay. Addressed in #29061.
Dependency Updates:
- Updated
jimp
from0.14.0
to0.22.12
. Addressed in #29055. - Updated
http-proxy-middleware
from2.0.4
to2.0.6
. Addressed in #28902. - Updated
signal-exit
from3.0.3
to3.0.7
. Addressed in #28979.
13.6.6​
Released 2/22/2024
Bugfixes:
13.6.5​
Released 2/20/2024
Bugfixes:
- Fixed tests hanging when the Chrome browser extension is disabled. Fixes #28392.
- Fixed an issue which caused the browser to relaunch after closing the browser from the Launchpad. Fixes #28852.
- Fixed an issue with the unzip promise never being rejected when an empty error happens. Fixed in #28850.
- Fixed a regression introduced in 13.6.3 where Cypress could crash when processing service worker requests through our proxy. Fixes #28950.
- Fixed incorrect type definition of
dom.getContainsSelector
. Fixed in #28339.
Misc:
- Improved accessibility of the Cypress App in some areas. Addressed in #28774.
- Changed references of LayerCI to webapp.io. Addressed in #28874.
Dependency Updates:
- Upgraded
electron
from25.8.4
to27.1.3
. - Upgraded bundled Node.js version from
18.15.0
to18.17.0
. - Upgraded bundled Chromium version from
114.0.5735.289
to118.0.5993.117
. - Updated buffer from
5.6.0
to5.7.1
. Addressed in #28934. - Updated
duplexify
from4.1.1
to4.1.2
. Addressed in #28941. - Updated
is-ci
from3.0.0
to3.0.1
. Addressed in #28933.
13.6.4​
Released 1/30/2024
Performance:
- Fixed a performance regression from 13.3.2 where aborted requests may not correlate correctly. Fixes #28734.
Bugfixes:
- Fixed an issue with capturing assets for Test Replay when service workers are registered in Cypress support files. This issue would cause styles to not render properly in Test Replay. Fixes #28747.
Misc:
- Added missing properties to the
Cypress.spec
interface for TypeScript users. Addresses #27835.
13.6.3​
Released 1/16/2024
Bugfixes:
- Force
moduleResolution
tonode
when TypeScript projects are detected to correctly run Cypress. This change should not have a large impact ascommonjs
is already forced whents-node
is registered. This fix does not impact the ESM TypeScript configuration loader. Fixes #27731. - No longer wait for additional frames when recording a video for a spec that was skipped by the Cloud due to Auto Cancellation. Fixes #27898.
- Now
node_modules
will not be ignored if a project path or a provided path to spec files contains it. Fixes #23616. - Updated display of assertions and commands with a URL argument to escape markdown formatting so that values are displayed as is and assertion values display as bold. Fixes #24960 and #28100.
- When generating assertions via Cypress Studio, the preview of the generated assertions now correctly displays the past tense of 'expected' instead of 'expect'. Fixed in #28593.
- Fixed a regression in 13.6.2 where the
body
element was not highlighted correctly in Test Replay. Fixed in #28627. - Correctly sync
Cypress.currentRetry
with secondary origin so test retries that leveragecy.origin()
render logs as expected. Fixes #28574. - Fixed an issue where some cross-origin logs, like assertions or cy.clock(), were getting too many dom snapshots. Fixes #28609.
- Fixed asset capture for Test Replay for requests that are routed through service workers. This addresses an issue where styles were not being applied properly in Test Replay and
cy.intercept()
was not working properly for requests in this scenario. Fixes #28516. - Fixed an issue where visiting an
http://
site would result in an infinite reload/redirect loop in Chrome 114+. Fixes #25891. - Fixed an issue where requests made from extra tabs do not include their original headers. Fixes #28641.
- Fixed an issue where
cy.wait()
would sometimes throw an error reading a property of undefined when returning responses. Fixes #28233.
Performance:
- Fixed a performance regression from 13.3.2 where requests may not correlate correctly when test isolation is off. Fixes #28545.
Dependency Updates:
- Remove dependency on
@types/node
package. Addresses #28473. - Updated
@cypress/unique-selector
to include a performance optimization. It's possible this could improve performance of the selector playground. Addressed in #28571. - Replace
CircularJSON
with its successorflatted
version3.2.9
. This resolves decoding issues observed in complex objects sent from the browser. Addressed in #28683. - Updated
better-sqlite3
from8.7.0
to9.2.2
to fix macOS Catalina issues. Addresses #28697.
Misc:
- Improved accessibility of some areas of the Cypress App. Addressed in #28628.
- Updated some documentation links to go through on.cypress.io. Addressed in #28623.
13.6.2​
Released 12/26/2023
Bugfixes:
- Fixed a regression in 13.6.1 where a malformed URI would crash Cypress. Fixes #28521.
- Fixed a regression in 12.4.0 where erroneous
<br>
tags were displaying in error messages in the Command Log making them less readable. Fixes #28452.
Performance:
- Improved performance when finding unique selectors for command log snapshots for Test Replay. Addressed in #28536.
Dependency Updates:
- Updated ts-node from
10.9.1
to10.9.2
. Cypress will longer error duringcypress run
orcypress open
when using typescript 5.3.2+ withextends
intsconfig.json
. Addresses #28385.
13.6.1​
Released 12/5/2023
Bugfixes:
- Fixed an issue where pages or downloads opened in a new tab were missing basic auth headers. Fixes #28350.
- Fixed an issue where request logging would default the
message
to theargs
of the currently running command even though thoseargs
would not apply to the request log and are not displayed. If theargs
are sufficiently large (e.g. when running thecy.task
from the code-coverage plugin) there could be performance/memory implications. Addressed in #28411. - Fixed an issue where commands would fail with the error
must only be invoked from the spec file or support file
if the project'sbaseUrl
included basic auth credentials. Fixes #27457 and #28336. - Fixed an issue where some URLs would timeout in pre-request correlation. Addressed in #28427.
- Cypress will now correctly log errors and debug logs on Linux machines. Fixes #5051 and #24713.
Misc:
13.6.0​
Released 11/21/2023
Features:
- Added an activity indicator to CLI output when artifacts (screenshots, videos, or Test Replay) are being uploaded to the cloud. Addresses #28239. Addressed in #28277.
- When artifacts are uploaded to the Cypress Cloud, the duration of each upload will be displayed in the terminal. Addresses #28237.
Bugfixes:
- We now allow absolute paths when setting
component.indexHtmlFile
in the Cypress config. Fixes #27750. - Fixed an issue where dynamic intercept aliases now show with alias name instead of "no alias" in driver. Addresses #24653
- Fixed an issue where aliasing individual requests with
cy.intercept()
led to an error when retrieving all of the aliases withcy.get(@alias.all)
. Addresses #25448 - The URL of the application under test and command error "Learn more" links now open externally instead of in the Cypress-launched browser. Fixes #24572.
- Fixed issue where some URLs would timeout in pre-request correlation. Addressed in #28354.
Misc:
- Browser tabs and windows other than the Cypress tab are now closed between tests in Chromium-based browsers. Addressed in #28204.
- Cypress now ensures the main browser tab is active before running each command in Chromium-based browsers. Addressed in #28334.
Dependency Updates:
- Upgraded
chrome-remote-interface
from0.31.3
to0.33.0
to increase the max payload from 100MB to 256MB. Addressed in #27998.
13.5.1​
Released 11/14/2023
Bugfixes:
- Fixed a regression in 13.5.0 where requests cached within a given spec may take longer to load than they did previously. Addresses #28295.
- Fixed an issue where pages opened in a new tab were missing response headers, causing them not to load properly. Fixes #28293 and #28303.
- We now pass a flag to Chromium browsers to disable default component extensions. This is a common flag passed during browser automation. Fixed in #28294.
13.5.0​
Released 11/8/2023
Features:
Bugfixes:
- Fixed an issue in chromium based browsers, where global style updates can trigger flooding of font face requests in DevTools and Test Replay. This can affect performance due to the flooding of messages in CDP. Fixes #28150 and #28215.
- Fixed a regression in 13.3.3 where Cypress would hang on loading shared workers when using
cy.reload
to reload the page. Fixes #28248. - Fixed an issue where network requests made from tabs, or windows other than the main Cypress tab, would be delayed. Fixes #28113.
- Fixed an issue with 'other' targets (e.g. pdf documents embedded in an object tag) not fully loading. Fixes #28228 and #28162.
- Fixed an issue where clicking a link to download a file could cause a page load timeout when the download attribute was missing. Note: download behaviors in experimental WebKit are still an issue. Fixes #14857.
- Fixed an issue to account for canceled and failed downloads to correctly reflect these status in Command log as a download failure where previously it would be pending. Fixed in #28222.
- Fixed an issue determining visibility when an element is hidden by an ancestor with a shared edge. Fixes #27514.
- We now pass a flag to Chromium browsers to disable Chrome translation, both the manual option and the popup prompt, when a page with a differing language is detected. Fixes #28225.
- Stopped processing CDP events at the end of a spec when Test Isolation is off and Test Replay is enabled. Addressed in #28213.
13.4.0​
Released 10/30/2023
Features:
- Introduced experimental configuration options for advanced retry logic: adds
experimentalStrategy
andexperimentalOptions
keys to theretry
configuration key. See Experimental Flake Detection Features for more information. Addressed in #27930.
Bugfixes:
- Fixed a regression in 13.3.2 where Cypress would crash with 'Inspected target navigated or closed' or 'Session with given id not found'. Fixes #28141 and #28148.
13.3.3​
Released 10/24/2023
Bugfixes:
- Fixed a performance regression in 13.3.1 with proxy correlation timeouts and requests issued from web and shared workers. Fixes #28104.
- Fixed a performance problem with proxy correlation when requests get aborted and then get miscorrelated with follow up requests. Addressed in #28094.
- Fixed a regression in 10.0.0, where search would not find a spec if the file name contains "-" or "_", but search prompt contains " " instead (e.g. search file "spec-file.cy.ts" with prompt "spec file"). Fixes #25303.
13.3.2​
Released 10/18/2023
Bugfixes:
- Fixed a performance regression in 13.3.1 with proxy correlation timeouts and requests issued from service workers. Fixes #28054 and #28056.
- Fixed an issue where proxy correlation would leak over from a previous spec causing performance problems,
cy.intercept
problems, and Test Replay asset capturing issues. Addressed in #28060. - Fixed an issue where redirects of requests that knowingly don't have CDP traffic should also be assumed to not have CDP traffic. Addressed in #28060.
- Fixed an issue with Accept Encoding headers by forcing gzip when no accept encoding header is sent and using identity if gzip is not sent. Fixes #28025.
Dependency Updates:
- Upgraded
@babel/core
from7.22.9
to7.23.2
to address the SNYK-JS-SEMVER-3247795 security vulnerability. Addressed in #28063. - Upgraded
@babel/traverse
from7.22.8
to7.23.2
to address the SNYK-JS-BABELTRAVERSE-5962462 security vulnerability. Addressed in #28063. - Upgraded
react-docgen
from6.0.0-alpha.3
to6.0.4
to address the SNYK-JS-BABELTRAVERSE-5962462 security vulnerability. Addressed in #28063.
13.3.1​
Released 10/11/2023
Bugfixes:
- Fixed an issue where requests were correlated in the wrong order in the proxy. This could cause an issue where the wrong request is used for
cy.intercept
or assets (e.g. stylesheets or images) may not properly be available in Test Replay. Addressed in #27892. - Fixed an issue where a crashed Chrome renderer can cause the Test Replay recorder to hang. Addressed in #27909.
- Fixed an issue where multiple responses yielded from calls to
cy.wait()
would sometimes be out of order. Fixes #27337. - Fixed an issue where requests were timing out in the proxy. This could cause an issue where the wrong request is used for
cy.intercept
or assets (e.g. stylesheets or images) may not properly be available in Test Replay. Addressed in #27976. - Fixed an issue where Test Replay couldn't record tests due to issues involving
GLIBC
. Fixed deprecation warnings during the rebuild of better-sqlite3. Fixes #27891 and #27902. - Enables test replay for executed specs in runs that have a spec that causes a browser crash. Addressed in #27786.
13.3.0​
Released 09/27/2023
Features:
- Introduces new layout for Runs page providing additional run information. Addresses #27203.
Bugfixes:
- Fixed an issue where actionability checks trigger a flood of font requests. Removing the font requests has the potential to improve performance and removes clutter from Test Replay. Addressed in #27860.
- Fixed network stubbing not permitting status code 999. Fixes #27567. Addressed in #27853.
13.2.0​
Released 09/12/2023
Features:
- Adds support for Nx users who want to run Angular Component Testing in parallel. Addressed in #27723.
Bugfixes:
- Edge cases where
cy.intercept()
would not properly intercept and asset response bodies would not properly be captured for Test Replay have been addressed. Addressed in #27771. - Fixed an issue where
enter
,keyup
, andspace
events were not triggeringclick
events properly in some versions of Firefox. Addressed in #27715. - Fixed a regression in
13.0.0
where tests using Basic Authorization can potentially hang indefinitely on chromium browsers. Addressed in #27781.
Dependency Updates:
- Upgraded Electron from
21.0.0
to25.8.0
, which updates bundled Chromium from106.0.5249.51
to114.0.5735.289
. Additionally, the Node version binary has been upgraded from16.16.0
to18.15.0
. This does NOT have an impact on the node version you are using with Cypress and is merely an internal update to the repository & shipped binary. Addressed in #27715. Addresses #27595.
13.1.0​
Released 08/31/2023
Features:
- Introduces a status icon representing the
latest
test run in the Sidebar for the Runs Page. Addresses #27206.
Bugfixes:
- Fixed a regression introduced in Cypress 13.0.0 where the Module API,
after:run
, andafter:spec
results did not include thestats.skipped
field for each run result. Fixes #27694. Addressed in #27695. - Individual CDP errors that occur while capturing data for Test Replay will no longer prevent the entire run from being available. Addressed in #27709.
- Fixed an issue where the release date on the
v13
landing page was a day behind. Fixed in #27711. - Fixed an issue where fatal protocol errors would leak between specs causing all subsequent specs to fail to upload protocol information. Fixed in #27720
- Updated
plist
from3.0.6
to3.1.0
to address CVE-2022-37616 and CVE-2022-39353. Fixed in #27710.
13.0.0​
Released 08/29/2023
Summary:
When recording to Cypress Cloud, users now receive our newest feature: Test Replay. Test Replay brings the debugging experience you know and love from the Cypress app directly into your recorded tests in Cypress Cloud.
Previously, trying to debug failures and flake in CI was painful and time consuming with only videos & screenshots. Test Replay provides a way to inspect the DOM, network events, and console logs of your application from your tests exactly as they ran in CI.
Test Replay is available in all Cypress Cloud plans. To start using Test Replay, simply record a run to Cypress Cloud. Learn more in the Test Replay documentation.
Test Replay now serves as the primary replacement for debugging via video. Video capture and videoCompression
of captured video are now set to false
by default and videoUploadOnPasses
is removed.
Read more about v13.0.0 in our blog post.
Breaking Changes:
Refer to the v13 Migration Guide for help migrating your code.
- The
video
configuration option now defaults tofalse
. Addresses #26157. - The
videoCompression
configuration option now defaults tofalse
. Addresses #26160. - The
videoUploadOnPasses
configuration option has been removed. Please see our screenshots & videos guide on how to accomplish similar functionality. Addresses #26899. - Requests for assets at relative paths for component testing are now correctly forwarded to the dev server. Fixes #26725.
- The
cy.readFile()
command is now retry-able as a query command. This should not affect any tests using it; the functionality is unchanged. However, it can no longer be overwritten usingCypress.Commands.overwrite()
. Addressed in #25595. - The deprecated configuration option
nodeVersion
has been removed. Addresses #27016. - The properties and values returned by the Module API and included in the arguments of handlers for the
after:run
andafter:spec
have been changed to be more consistent. Addresses #23805. - For Cypress Cloud runs with Test Replay enabled, the Cypress Runner UI is now hidden during the run. This change was made to improve performance in situations where the Runner no longer needs to be rendered. If video is recorded during the run, the Runner will not be visible. In addition, if a screenshot with
capture: runner
is taken, the screenshot will be taken as if thecapture: viewport
option was passed. You can turn off this behavior by passing--runner-ui
. Addressed in #27482. - The browser and browser page unexpectedly closing in the middle of a test run are now gracefully handled. Addressed in #27592.
- Automation performance is now improved by switching away from websockets to direct CDP calls for Chrome and Electron browsers. Addressed in #27592.
- Edge cases where
cy.intercept
would not properly intercept have been addressed. Addressed in #27592. - Node 14 support has been removed and Node 16 support has been deprecated. Node 16 may continue to work with Cypress
v13
, but will not be supported moving forward to closer coincide with Node 16's end-of-life schedule. It is recommended that users update to at least Node 18. - The minimum supported TypeScript version is
4.x
.
Features:
- Added
--runner-ui
and--no-runner-ui
CLI flags to control whether the Cypress Runner UI is visible during a run. Addressed in #27582. - Consolidates and improves terminal output when uploading test artifacts to Cypress Cloud. Addressed in #27402
Bugfixes:
- Fixed an issue where Cypress's internal
tsconfig
would conflict with properties set in the user'stsconfig.json
such asmodule
andmoduleResolution
. Fixes #26308 and #27448. - Clarified Svelte 4 works correctly with Component Testing and updated dependencies checks to reflect this. It was incorrectly flagged as not supported. Fixes #27465.
- Resolve the
process/browser
global inside@cypress/webpack-batteries-included-preprocessor
to resolve toprocess/browser.js
in order to explicitly provide the file extension. File resolution must include the extension for.mjs
and.js
files inside ESM packages in order to resolve correctly. Fixes#27599. - Fixed an issue where the correct
pnp
process was not being discovered. Fixes #27562. - Fixed incorrect type declarations for Cypress and Chai globals that asserted them to be local variables of the global scope rather than properties on the global object. Fixes #27539. Fixed in #27540.
- Dev Servers will now respect and use the
port
configuration option if present. Fixes #27675.
Dependency Updates:
- Upgraded
@cypress/request
from^2.88.11
to^3.0.0
to address the CVE-2023-28155 security vulnerability. Addresses #27535. Addressed in #27495.
12.17.4​
Released 08/15/2023
Bugfixes:
- Fixed an issue where having
cypress.config
in a nested directory would cause problems with locating thecomponent-index.html
file when using component testing. Fixes #26400.
Dependency Updates:
- Upgraded
webpack
fromv4
tov5
. This means that we are now bundling youre2e
tests with webpack 5. We don't anticipate this causing any noticeable changes. However, if you'd like to keep bundling youre2e
tests with webpack 4 you can use the same process as before by pinning @cypress/webpack-batteries-included-preprocessor tov2.x.x
and hooking into the file:preprocessor plugin event. This will restore the previous bundling process. Additionally, if you're using @cypress/webpack-batteries-included-preprocessor already, a new version has been published to support webpackv5
. - Upgraded
tough-cookie
from4.0
to4.1.3
,@cypress/request
from2.88.11
to2.88.12
and@cypress/request-promise
from4.2.6
to4.2.7
to address a security vulnerability. Fixes #27261.
12.17.3​
Released 08/01/2023
Bugfixes:
- Fixed an issue where unexpected branch names were being recorded for cypress runs when executed by GitHub Actions. The
HEAD
branch name will now be recorded by default for pull request workflows if a branch name cannot otherwise be detected from user overrides or from local git data. Fixes #27389.
Performance:
- Fixed an issue where unnecessary requests were being paused. No longer sends
X-Cypress-Is-XHR-Or-Fetch
header and infers resource type off of the server pre-request object. Fixes #26620 and #26622.
12.17.2​
Released 07/20/2023
Bugfixes:
- Fixed an issue where commands would fail with the error
must only be invoked from the spec file or support file
if their arguments were mutated. Fixes #27200. - Fixed an issue where
cy.writeFile()
would erroneously fail with the errorcy.writeFile() must only be invoked from the spec file or support file
. Fixes #27097. - Fixed an issue where web workers could not be created within a spec. Fixes #27298.
12.17.1​
Released 07/10/2023
Bugfixes:
- Fixed invalid stored preference when enabling in-app notifications that could cause the application to crash. Fixes #27228.
- Fixed an issue with the TypeScript types of
cy.screenshot()
. Fixed in #27130.
Dependency Updates:
- Upgraded
@cypress/request
from2.88.10
to2.88.11
to address CVE-2022-24999 security vulnerability. Addressed in #27005.
12.17.0​
Released 07/06/2023
Features:
- Cypress Cloud users can now receive desktop notifications about their runs, including when one starts, finishes, or fails. Addresses #26686.
Bugfixes:
- Fixed issues where commands would fail with the error
must only be invoked from the spec file or support file
. Fixes #27149 and #27163. - Fixed a regression introduced in Cypress 12.12.0 where Cypress may fail to reconnect to the Chrome DevTools Protocol in Electron. Fixes #26900.
- Fixed an issue where chrome was not recovering from browser crashes properly. Fixes #24650.
- Fixed a race condition that was causing a GraphQL error to appear on the Debug page when viewing a running Cypress Cloud build. Fixed in #27134.
- Fixed a race condition in electron where the test window exiting prematurely during the browser launch process was causing the whole test run to fail. Addressed in #27167.
- Fixed minor issues with TypeScript types in the CLI. Fixes #24110.
- Fixed an issue where a value for the Electron debug port would not be respected if defined using the
ELECTRON_EXTRA_LAUNCH_ARGS
environment variable. Fixes #26711.
Dependency Updates:
- Update dependency semver to ^7.5.3. Addressed in #27151.
12.16.0​
Released 06/26/2023
Features:
- Added support for Angular 16.1.0 in Cypress Component Testing. Addresses #27049.
Bugfixes:
- Fixed an issue where certain commands would fail with the error
must only be invoked from the spec file or support file
when invoked with a large argument. Fixes #27099.
12.15.0​
Released 06/20/2023
Features:
- Added support for running Cypress tests with
Chrome's new
--headless=new
flag. Chrome versions 112 and above will now be run in theheadless
mode that matches theheaded
browser implementation. Addresses #25972. - Cypress can now test pages with targeted
Content-Security-Policy
andContent-Security-Policy-Report-Only
header directives by specifying the allow list via theexperimentalCspAllowList
configuration option. Addresses #1030. Addressed in #26483 - The
videoCompression
configuration option now accepts both a boolean or a Constant Rate Factor (CRF) number between1
and51
. ThevideoCompression
default value is still32
CRF and whenvideoCompression
is set totrue
the default of32
CRF will be used. Addresses #26658. - The Cypress Cloud data shown on the Specs page and Runs page will now reflect Cloud Runs that match the current Git tree if Git is being used. Addresses #26693.
Bugfixes:
- Fixed an issue where video output was not being logged to the console when
videoCompression
was turned off. Videos will now log to the terminal regardless of the compression value. Addresses #25945.
Dependency Updates:
- Removed
@cypress/mocha-teamcity-reporter
as this package was no longer being referenced. Addressed in #26938.
12.14.0​
Released 06/07/2023
Features:
- A new testing type switcher has been added to the Spec Explorer to make it easier to move between E2E and Component Testing. An informational overview of each type is displayed if it hasn't already been configured to help educate and onboard new users to each testing type. Addresses #26448, #26836 and #26837.
Bugfixes:
- Fixed an issue to now correctly detect Angular 16 dependencies (@angular/cli, @angular-devkit/build-angular, @angular/core, @angular/common, @angular/platform-browser-dynamic) during Component Testing onboarding. Addresses #26852.
- Ensures Git-related messages on the Runs page remain dismissed. Addresses #26808.
Dependency Updates:
- Upgraded
find-process
from1.4.1
to1.4.7
to address this Synk security vulnerability. Addressed in #26906. - Upgraded
firefox-profile
from4.0.0
to4.3.2
to address security vulnerabilities within sub-dependencies. Addressed in #26912.
12.13.0​
Released 05/23/2023
Features:
- Adds Git-related messages for the Runs page and Debug page when users aren't using Git or there are no recorded runs for the current branch. Addresses #26680.
Bugfixes:
- Reverted #26452 which introduced a bug that prevents users from using End to End with Yarn 3. Fixed in #26735. Fixes #26676.
- Moved
types
condition to the front ofpackage.json#exports
since keys there are meant to be order-sensitive. Fixed in #26630. - Fixed an issue where newly-installed dependencies would not be detected during Component Testing setup. Addresses #26685.
- Fixed a UI regression that was flashing an "empty" state inappropriately when loading the Debug page. Fixed in #26761.
- Fixed an issue in Component Testing setup where TypeScript version 5 was not properly detected. Fixes #26204.
Misc:
- Updated styling & content of Cypress Cloud slideshows when not logged in or no runs have been recorded. Addresses #26181.
- Changed the nomenclature of 'processing' to 'compressing' when terminal video output is printed during a run. Addresses #26657.
- Changed the nomenclature of 'Upload Results' to 'Uploading Screenshots & Videos' when terminal output is printed during a run. Addresses #26759.
12.12.0​
Released 05/09/2023
Features:
- Added a new informational banner to help get started with component testing from an existing end-to-end test suite. Addresses #26511.
Bugfixes:
- Fixed an issue in Electron where devtools gets out of sync with the DOM occasionally. Addresses #15932.
- Updated the Chromium renderer process crash message to be more terse. Addressed in #26597.
- Fixed an issue with
CYPRESS_DOWNLOAD_PATH_TEMPLATE
regex to allow multiple replacements. Addresses #23670.
Dependency Updates:
- Upgraded
plist
from3.0.5
to3.0.6
to address CVE-2022-26260 NVD security vulnerability. Addressed in #26631. - Upgraded
engine.io
from6.2.1
to6.4.2
to address CVE-2023-31125 NVD security vulnerability. Addressed in #26664. - Upgraded
@vue/test-utils
from2.0.2
to2.3.2
. Addresses #26575.
12.11.0​
Released 04/26/2023
Features:
- Added Component Testing support for Angular 16. Addresses #26044.
- The run navigation component on the Debug page will now display a warning message if there are more relevant runs than can be displayed in the list. Addresses #26288.
Bugfixes:
- Fixed an issue where setting
videoCompression
to0
would cause the video output to be broken.0
is now treated as false. Addresses #5191 and #24595. - Fixed an issue on the Debug page where the passing run status would appear even if the Cypress Cloud organization was over its monthly test result limit. Addresses #26528.
Misc:
- Cleaned up our open telemetry dependencies, reducing the size of the open telemetry modules. Addressed in #26522.
Dependency Updates:
12.10.0​
Released 04/17/2023
Features:
- The Component Testing setup wizard will now show a warning message if an issue is encountered with an installed third party framework definition. Addresses #25838.
Bugfixes:
- Capture the Azure CI provider's environment
variable
SYSTEM_PULLREQUEST_PULLREQUESTNUMBER
to display the linked PR number in the Cloud. Addressed in #26215. - Fixed an issue in the onboarding wizard where project framework & bundler
would not be auto-detected when opening directly into component testing mode
using the
--component
CLI flag. Fixes #22777 and #26388. - Updated to use the
SEMAPHORE_GIT_WORKING_BRANCH
Semaphore CI environment variable to correctly associate a Cloud run to the current branch. Previously this was incorrectly associating a run to the target branch. Fixes #26309. - Fix an edge case in Component Testing where a custom
baseUrl
intsconfig.json
for Next.js 13.2.0+ is not respected. This was partially fixed in #26005, but an edge case was missed. Fixes #25951. - Correctly detect and resolve dependencies when configuring Component Testing in projects using Yarn's Plug'n'Play feature. Fixes #25960.
- Fixed an issue where
click
events fired on.type('{enter}')
did not propagate through shadow roots. Fixes #26392.
Misc:
- Removed unintentional debug logs. Addressed in #26411.
- Improved styling on the Runs Page. Addresses #26180.
Dependency Updates:
- Upgraded
commander
from^5.1.0
to^6.2.1
. Addressed in #26226. - Upgraded
minimist
from1.2.6
to1.2.8
to address this CVE-2021-44906 NVD security vulnerability. Addressed in #26254.
12.9.0​
Released 03/28/2023
Features:
- The Debug page now allows for navigating between all runs recorded for a commit. Addresses #25899 and #26018.
Bugfixes:
- Fixed a compatibility issue so that component test projects can use Vite version 4.2.0 and greater. Fixes #26138.
- Fixed an issue where
cy.intercept()
added an additionalcontent-length
header to spied requests that did not set acontent-length
header on the original request. Fixes #24407. - Changed the way that Git hashes are loaded so that non-relevant runs are excluded from the Debug page. Fixes #26058.
- Corrected the
.type()
command to account for shadow root elements when determining whether or not focus needs to be simulated before typing. Fixes #26198. - Fixed an issue where an incorrect working directory could be used for Git operations on Windows. Fixes #23317.
Misc:
- Made some minor styling updates to the Debug page. Addresses #26041.
12.8.1​
Released 03/15/2023
Bugfixes:
- Fixed a regression in Cypress 10 where the reporter auto-scroll configuration inside user preferences was unintentionally being toggled off. Users must now explicitly enable/disable auto-scroll under user preferences, which is enabled by default. Fixes #24171 and #26113.
Dependency Updates:
- Upgraded
ejs
from3.1.6
to3.1.8
to address this CVE-2022-29078 NVD security vulnerability. Addressed in #25279.
12.8.0​
Released 03/14/2023
Features:
- The Debug page is now able to show real-time results from in-progress runs. Addresses #25759.
- Added the ability to control whether a request is logged to the command log
via
cy.intercept()
by passinglog: false
orlog: true
. Addresses #7362.- This can be used to override Cypress's default behavior of logging all XHRs and fetches, see the example.
- It is now possible to control the number of connection attempts to the browser
using the
CYPRESS_CONNECT_RETRY_THRESHOLD
Environment Variable. Learn more here. Addressed in #25848.
Bugfixes:
- Fixed an issue where using
Cypress.require()
would throw the errorCannot find module 'typescript'
. Fixes #25885. - The
before:spec
API was updated to correctly support async event handlers inrun
mode. Fixes #24403. - Updated the Component Testing community framework definition detection logic to take into account monorepo structures that hoist dependencies. Fixes #25993.
- The onboarding wizard for Component Testing will now detect installed dependencies more reliably. Fixes #25782.
- Fixed an issue where Angular components would sometimes be mounted in unexpected DOM locations in component tests. Fixes #25956.
- Fixed an issue where Cypress component testing would fail to work with
Next.js
13.2.1
. Fixes #25951. - Fixed an issue where migrating a project from a version of Cypress earlier
than 10.0.0 could fail if the project's
testFiles
configuration was an array of globs. Fixes #25947.
Misc:
- Removed "New" badge in the navigation bar for the debug page icon. Addresses #25925.
- Removed inline "Connect" buttons within the Specs Explorer. Addresses #25926.
- Added an icon for "beta" versions of the Chrome browser. Addresses #25968.
Dependency Updates:
- Upgraded
mocha-junit-reporter
from2.1.0
to2.2.0
to be able to use new placeholders such as[suiteFilename]
or[suiteName]
when defining the test report name. Addressed in #25922.
12.7.0​
Released 02/24/2023
Features:
- It is now possible to set
hostOnly
cookies withcy.setCookie()
for a given domain. Addresses #16856 and #17527. - Added a Public API for third party component libraries to define a Framework Definition, embedding their library into the Cypress onboarding workflow. Learn more here. Implemented in #25780 and closes #25638.
- Added a Debug Page tutorial slideshow for projects that are not connected to Cypress Cloud. Addresses #25768.
- Updated the "new" status badge for the Debug page navigation link to be less noticeable when the navigation is collapsed. Addresses #25739.
- Improved various error message around interactions with the Cypress cloud. Implemented in #25837.
Bugfixes:
- Fixed an issue where cookies were being duplicated with the same hostname, but a prepended dot. Fixed an issue where cookies may not be expiring correctly. Fixes #25174, #25205 and #25495.
- Fixed an issue where cookies weren't being synced when the application was stable. Fixed in #25855. Fixes #25835.
- Added missing TypeScript type definitions for the
cy.reload()
command. Addressed in #25779. - Ensure Angular components are mounted inside the correct element. Fixes #24385.
- Fix a bug where files outside the project root in a monorepo are not correctly served when using Vite. Addressed in #25801.
- Fixed an issue where using
cy.intercept
'sreq.continue()
with a non-function parameter would not provide an appropriate error message. Fixed in #25884. - Fixed an issue where Cypress would erroneously launch and connect to multiple browser instances. Fixes #24377.
- Fixed various bugs when recording to the cloud. Fixed in #25837.
Misc:
- Made updates to the way that the Debug Page header displays information. Addresses #25796 and #25798.
12.6.0​
Released 02/15/2023
Features:
- Added a new CLI flag, called
--auto-cancel-after-failures
, that overrides the project-level "Auto Cancellation" value when recording to the Cloud. This gives Cloud users on Business and Enterprise plans the flexibility to alter the auto-cancellation value per run. Addressed in #25237. - It is now possible to overwrite query commands using
Cypress.Commands.overwriteQuery
. Addressed in #25078. - Added
Cypress.require()
for including dependencies within thecy.origin()
callback. This change removed support for usingrequire()
andimport()
directly within the callback because we found that it impacted performance not only for spec files using them within thecy.origin()
callback, but even for spec files that did not use them. Addresses #24976. - Added the ability to open the failing test in the IDE from the Debug page before needing to re-run the test. Addressed in #24850.
Bugfixes:
- When a Cloud user is a part of multiple Cloud organizations, the Connect to Cloud setup now shows the correct organizational prompts when connecting a new project. Fixes #25520.
- Fixed an issue where Cypress would fail to load any specs if the project
specPattern
included a resource that could not be accessed due to filesystem permissions. Fixes #24109. - Fixed an issue where the Debug page would display a different number of specs for in-progress runs than the in-progress specs reported in Cypress Cloud. Fixes #25647.
- Fixed an issue in middleware where error-handling code could itself generate an error and fail to report the original issue. Fixes #22825.
- Fixed an regression introduced in Cypress 12.3.0 where custom browsers that relied on process environment variables were not found on macOS arm64 architectures. Fixed in #25753.
Misc:
- Improved the UI of the Debug page. Addresses #25664, #25669, #25665, #25666, and #25667.
- Updated the Debug page sidebar badge to to show 0 to 99+ failing tests, increased from showing 0 to 9+ failing tests, to provide better test failure insights. Addresses #25662.
Dependency Updates:
12.5.1​
Released 02/2/2023
Bugfixes:
- Fixed a regression introduced in Cypress 12.5.0 where the
runnable
was not included in thetest:after:run
event. Fixes #25663.
Dependency Updates:
- Upgraded
simple-git
from3.15.0
to3.16.0
to address this security vulnerability where Remote Code Execution (RCE) via the clone(), pull(), push() and listRemote() methods due to improper input sanitization was possible. Addressed in #25603.
12.5.0​
Released 01/31/2023
Features:
- Easily debug failed CI test runs recorded to the Cypress Cloud from your local Cypress app with the new Debug page. Please leave any feedback here. Your feedback will help us make decisions to improve the Debug experience. For more details, see our blog post. Addressed in #25488.
Performance:
- Improved memory consumption in
run
mode by removing reporter logs for successful tests. Fixes #25230.
Bugfixes:
- Fixed an issue where alternative Microsoft Edge Beta, Canary, and Dev binary versions were not being discovered by Cypress. Fixes #25455.
Dependency Updates:
- Upgraded
underscore.string
from3.3.5
to3.3.6
to reference rebuilt assets after security patch to fix regular expression DDOS exploit. Addressed in #25574.
12.4.1​
Released 01/27/2023
Bugfixes:
- Fixed a regression from Cypress 12.4.0 where Cypress was not
exiting properly when running multiple Component Testing specs in
electron
inrun
mode. Fixes #25568.
Dependency Updates:
- Upgraded
ua-parser-js
from0.7.24
to0.7.33
to address this security vulnerability where crafting a very-very-long user-agent string with specific pattern, an attacker can turn the script to get stuck processing for a very long time which results in a denial of service (DoS) condition. Addressed in #25561.
12.4.0​
Released 1/24/2023
Features:
- Added official support for Vite 4 in component testing. Addresses #24969.
- Added new
experimentalMemoryManagement
configuration option to improve memory management in Chromium-based browsers. Enable this option withexperimentalMemoryManagement=true
if you have experienced "Out of Memory" issues. Please leave any feedback aroundexperimentalMemoryManagement
here. Your feedback will help us make decisions to improve memory issues. Addresses #23391. - Added new
experimentalSkipDomainInjection
configuration option to disable Cypress from settingdocument.domain
on injection, allowing users to test Salesforce domains. If you believe you are havingdocument.domain
issues, please see theexperimentalSkipDomainInjection
guide. This config option is end-to-end only. Addresses #2367, #23958, #24290, and #24418. - The
.as
command now accepts an options argument, allowing an alias to be stored as type "query" or "static" value. This is stored as "query" by default. Addresses #25173. - The
cy.log()
command will now display a line break where the\n
character is used. Addresses #24964. component.specPattern
now utilizes a JSX/TSX file extension when generating a new empty spec file if project contains at least one file with those extensions. This applies only to component testing and is skipped ifcomponent.specPattern
has been configured to exclude files with those extensions. Addresses #24495.- Added support for the
data-qa
selector in the Selector Playground in addition todata-cy
,data-test
anddata-testid
. Addresses #25305.
Bugfixes:
- Fixed an issue where component tests could incorrectly treat new major versions of certain dependencies as supported. Fixes #25379.
- Fixed an issue where new lines or spaces on new lines in the Command Log were not maintained. Fixes #23679 and #24964.
- Fixed an issue where Angular component testing projects would fail to initialize if an unsupported browserslist entry was specified in the project configuration. Fixes #25312.
Misc
- Video output link in
cypress run
mode has been added to its own line to make the video output link more easily clickable in the terminal. Addresses #23913.
12.3.0​
Released 1/03/2023
Features:
- Added support for mapping the
CYPRESS_PULL_REQUEST_ID
,CYPRESS_PULL_REQUEST_URL
, and/orCYPRESS_CI_BUILD_URL
environment variables to the the corresponding Cloud run. This provides workarounds when supported CI provider mappings are incorrect or unsupported CI providers are used. Addressed in #25036. - Added new Cypress API,
Cypress.currentRetry
, to easily access the current test retry count. Addresses #25239.
Performance:
- Increased the pre-request proxy cleanup interval. The previous cleanup interval was too aggressive for projects loading a large number of JS modules, causing applications to load very slowly and in chunks. Fixed in #25209.
- Fixed an issue where browsers distributed as universal binaries (Chrome, Firefox) on M1 Macs could be launched in the wrong architecture, resulting in poor performance in-browser. Fixed in #25014.
- Resolved a delay that could occur on startup when using a custom Cypress
configuration file location in projects with a transitive
typescript
dependency. Fixes #24781.
Bugfixes:
- Fixes an issue where component test files that contained characters, such as
brackets (
[]
), would be ignored when running tests. This is a common pattern in Next.js and Gatsby.js projects. Fixes #24588. - Updated the Jenkins environment variable mappings so pull request data is correctly linked to the corresponding Cloud run. Fixed in #25036.
- Fixed a regression in 10.11.0 where the mocha test results no
longer sent the pending boolean to reporters. This caused the
mochaawesome
reporter to incorrectly report pending tests as pending and skipped. Fixes #24477. - Fix for regression introduced in 12.1.0, where
.contains()
could return multiple elements instead of one element when it was matching directly on the subject, rather than on the subject's children. Fixes #25225. - Fixed a small visual bug in the Test Runner such that Chrome users will no longer see a white border on the nav bar at the specific zoom levels. Fixes #25284.
Misc
- Remove the redundant
Need help
link from the migration information modal because the modal provides in-depth details for users already. Addresses #21923. - Minor UI updates were make to truncate the browser's name when it exceeds the allocated space and to only show the browsers's major version in the UI. Addresses #21730 and #21755.
- Removed the line break that was displayed on the Settings page when a configuration value was an empty object. Addresses #21790.
Dependency Updates:
- Upgraded
engine.io
from5.2.1
to6.2.1
to address this security vulnerability where a specially crafted HTTP request can trigger an uncaught exception on the Engine.IO server, thus killing the Node.js process. Addressed in #23843. - Upgraded
express
from4.17.1
to4.17.3
to address this NVD security vulnerability. Addressed in #23843. - Upgraded
simple-git
from3.4.0
to3.15.0
to address this NVD security vulnerability. Addressed in #23843.
12.2.0​
Released 12/20/2022
Features:
- Added the ability to match on
resourceType
withcy.intercept()
, and to see the resource type of an intercepted request asreq.resourceType
. Addresses #14525. - Users working in React Component Testing projects can now generate a basic spec file from the components that exist in their project. Addresses #24008.
Performance:
- Fixed a regression introduced in the Electron browser in
Cypress 10.8.0 where the
CYPRESS_EVERY_NTH_FRAME
environment variable was not being set appropriately causing all frames to be captured which slowed down tests. Fixes #23830.
Bugfixes:
- Fixed an issue where the
query
object was not available on requests fromcy.intercept()
once they were yielded. Fixes #25088. - Fixed an issue with Angular Component Testing where urls within SASS/SCSS files were not being correctly resolved which could result in incomplete styling. Fixes #24272.
- Fixed a regression introduced in Cypress 12 where
cy.get()
would ignore anull
value for thewithinSubject
option. Fixes #25104. - Fixed an issue where an unhandled promise rejection would display an incomplete error message in the command log. Fixes #24915.
- Fixed an issue where the incorrect Cypress version could be shown in the migration wizard. Fixes #25138.
- Fixed an issue where the Cypress migration wizard would fail to run in global mode on newer versions of Cypress. Addressed in #25138.
- Fixed an issue with Angular Component Testing where a custom
sourceRoot
configuration would not be respected. Fixes #24827. - Fixed TypeScript typings for
cy.nextUntil()
to include thefilter
parameter. Fixes #24772.
12.1.0​
Released 12/12/2022
Features:
- Added
cy.getAllCookies()
andcy.clearAllCookies()
, which get and clear cookies for all browser cookies across any domains. Addresses #24265, #8956, and #408. - Updated the error messaging to provide more context when parallel group parameters are mismatched when sent to the Cypress Cloud. Fixes #24734.
Bugfixes:
- Fixed an issue with the
cy.session
command where it now recollects the session data after validation is successful to correctly store the full browser context before the command ends. Addressed with #25112. - Fixed an issue where recent versions of Firefox in headless mode would behave inconsistently with headed. Fixes #24900.
- Fixed an issue where
.select(index)
would fail when multiple<option>
elements have the same value property. Fixes #24739. - Cleaned up temp files generated by
cypress run
. Addressed by #24957 - The Chrome web security configuration tooltip will now be shown only if
chromeWebSecurity
is set to false when using a non-chromium browser. Fixes #23846. - Fixed an issue where updating a component would not trigger the
supportFile
to reload imported stylesheets. This is fixed by doing a full reload for Vite, to ensure the spec re-runs correctly with the latest styles. Fixes #24874. - The Run All Specs experiment will now open in a new tab rather than close and reopen the browser. This will make the run faster and help mitigate #21743. Fixes #24919.
12.0.2​
Released 12/08/2022
Bugfixes:
- Fixed a regression in 12.0.0 where
.contains()
received multiple elements as a subject, it only searched inside the first one. Fixes #25025 - Fixed a regression in 12.0.0 around
.contains()
where if the subject was a<form>
element, it would only consider the first<input>
element in the form, rather than every child. Fixes #25019
12.0.1​
Released 12/06/2022
Bugfixes:
- Fixed a regression in 11.2.0 where a stale spec search pattern was shown in the spec search bar after re-launching Cypress. Fixes #24936
- Fixed a regression in 12.0.0 where tests scaffolded into new projects were using a removed api. Fixed in #25006
- Fixed regression in 12.0.0 where setting
e2e.testIsolation=false
caused invalid configuration validation when runningcypress run --component
. Fixes #25007 - Fixed a regression introduced in 12.0.0 that sometimes does not allow cy.origin() to communicate correctly with the navigated to domain. Fixes #25010
12.0.0​
Released 12/06/2022
Summary:
The Session and Origin Experiment is now generally available for end-to-end testing. This means Cypress now fully supports:
- Testing multiple origins in a single test with the new
cy.origin()
command. - Caching and restoring cookies,
localStorage
, andsessionStorage
between tests - Configuring
testIsolation
in suites to define whether or not the browser context is cleaned or persisted between tests
Additionally in this release, enhancements were made to how Cypress manages DOM element resolution to reduce the likelihood of hitting detached DOM errors due to maintaining stale DOM references. We've updated our Retry-ability Guide with all the details if you'd like to learn more.
Read more about 12.0 in our blog post.
Breaking Changes:
- Cypress dropped support for Node.js 12, 15 and 17. Those versions have reached end-of-life. Installing Cypress on your system now requires Node.js 14, 16 or 18+. Addressed in #24885.
- Cypress has always recommended writing tests in a clean context. In Cypress
12, we enforce running tests in a clean browser context through
test isolation.
This option is configurable, but is enabled by default. Whether enabled or
disabled, this changes how Cypress cleans up the browser context before each
test and you may experience test errors with this upgrade. To better
understand the full impact of this change, please review the
migration guide.
- In Cypress v12, the
testIsolation
configuration values have changed fromon
oroff
totrue
orfalse
. Addressed in #24935.
- In Cypress v12, the
- The
experimentalSessionAndOrigin
configuration option has been removed and all functionality associated with this experiment is now enabled by default, with the exception of usingrequire
andimport
with callback supplied to thecy.origin()
command. To leverage external dependencies incy.origin()
callbacks, set the newe2e.experimentalOriginDependencies
configuration option totrue
. Addresses #21471. - The
Cookies.defaults
andCookies.preserveOnce
APIs have been removed. Use the newcy.session()
command to preserve cookies between tests. Addresses #21472. - The
cy.server()
andcy.route()
commands have been removed. Additionally, the correspondingCypress.Server.defaults
API has also been removed. Use the [cy.intercept()
(/api/commands/intercept) command to stub network responses and requests. Addresses #22126. - The Cookie commands now uses the
hostname
as the domain by default instead of thesuperdomain
. This change aligns Cypress' cookie rules with the browser cookie rules. This may affect what cookies are returned bycy.getCookie()
, what cookies are set withcy.setCookie()
, and the cookies cleared withcy.clearCookies()
. Addresses #363, #5723 and #24526. - The
.within()
command now requires a single subject and throws an error if given more than one subject. This change adds consistency around how.within()
behaves across commands. Previously some commands inside a.within()
callback would silently select the first element, while others would use all of the previously yielded subjects, and others would throw an error. Addressed in #24975. - Cypress now throws an error if any Cypress commands are invoked from inside a
.should()
callback. This previously resulted in unusual and undefined behavior. Addresses #5963, #14656 and #22587. - The
.invoke()
command now throws an error if the invoked function returns a promise. If you wish to call a method that returns a promise and wait for it to resolve, use.then()
instead of.invoke()
. Addressed in #24417. - The
cy.request()
command now usesquerystringify
to stringify & parse theqs
options. This change aligns with how thecy.visit()
command generates urls with query parameters. Addressed in #20302.
Features:
- Added a new configuration option called
testIsolation
, which defaults totrue
. This option can be set at thee2e
or suite-level to determine whether or not test isolation is enabled to ensure a clean browser context between tests. Addressed in #22230. - The previously experimental Cypress command,
cy.origin()
, is now generally available in end-to-end testing. This command allows testing multiple origins in a single test. Addresses #17336. - The previously experimental Cypress command,
cy.session()
, is now generally available. This command caches and restorescookies
,localStorage
, andsessionStorage
in order to recreate a consistent browser context between tests. Addresses #20977. - Added a new Cypress command,
cy.getAllLocalStorage()
, to getlocalStorage
data for all origins with which the test has interacted. Addresses #24276. - Added a new Cypress command,
cy.clearAllLocalStorage()
, to clearlocalStorage
data for all origins with which the test has interacted. Addresses #24276. - Added a new Cypress command,
cy.getAllSessionStorage()
, to getsessionStorage
data for all origins with which the test has interacted. Addresses #24276. - Added a new Cypress command,
cy.clearAllSessionStorage()
, to clearsessionStorage
data for all origins with which the test has interacted. Addresses #24276. - Added a new configuration option called
experimentalOriginDependencies
, which defaults tofalse
. This option enables support forrequire
andimport
within the callback supplied to thecy.origin()
command in end-to-end testing. Previously this feature was enabled through theexperimentalSessionAndOrigin
configuration option.experimentalOriginDependencies
was added as a configuration option in Cypress 12, instead of being enabled by default, due to increased Node.js memory usage associated with this option that needs to be addressed before making this behavior generally available. See issue #24976 for more information. Addressed in #24931. - Added a new
Cypress.ensure
API which provides several methods that can be helpful when writing customs commands. Addressed in #24697. - Added a new "Run All" button to the
experimentalRunAllSpecs
experiment which enables running all spec files returned from thespecPattern
glob or an array of globs, regardless of the specs sharing a root folder. Addresses #24759. - Further improved bundling in the binary to reduce startup and unzip time. Addressed in #24909
Bugfixes:
- Fixed a regression in 10.11.0 where the Launchpad no longer showed a loading spinner on startup to indicate that it had successfully started and was in a loading state. Fixed #24950.
- Fixed the "Create Spec from Component" capability to correctly scaffold the component spec from a component which contains special characters in its name. Before this change, a spec was scaffolded with either the wrong spec name or the incorrect component import which led to invalid JS errors. Fixes #23492.
- Corrected Cypress environment variable resolution to correctly resolve
environment variables set with
npm config set
. Fixes #24556. - When
experimentalRunAllSpecs=true
, the "Run N specs" directory-level buttons in the Inline Specs List now function correctly when activated by the keyboard. Fixes #24762. - Fixed unexpected behaviors when verifying a cookie was not returned from
cy.getCookie()
. Now it's possible to explicitly assert the cookie did not exist withcy.getCookie('foo1').should('not.exist')
. Previously users had to verify cookies properties did not exist with.its('value').should('equal', null)
. Addressed in #24203. - Fixed the console output returned from clicking on an aliased intercept in the Command Log. It now logs the yielded request/response object associated to the intercepted call when clicked, where previously it did not log these details. Fixed in #24623.
11.2.0​
Released 11/22/2022
Features:
- Re-implemented the 'Run All Specs' for End to End Testing for running multiple
tests sequentially in open mode. This feature had been previously removed in
Cypress 10.0. Enable 'Run All Specs' with the new experimental flag,
experimentalRunAllSpecs
. Please leave any feedback around 'Run All Specs' here. Your feedback will help us make product decisions around the future of this feature. Addresses #24168 - Added messaging after failures in CI to direct people to set up recording to the Cypress Cloud if they are not already set up to do so. Addresses #24000.
- Visually warn in the Command Log when the
cy.session()
command fails to restore a session to surface to users potential issues with their setup and validation. Addresses #24207.
Bugfixes:
- The
cy.session()
command no longer clears the page between setup and validation and will now always clear the page at the end of the command when test isolation is on. Fixes #21397.
11.1.0​
Released 11/14/2022
Features:
- Next.js v13 is now supported. #24396
mount()
now accepts an extensions.directives option, which will be registered globally for Vue2 component testing. #24488
Bugfixes:
- Fixed an 11.0.0 regression where the migration workflow would error and hang for TypeScript projects. Fixes #24643
- Fixed an 11.0.0 regression where
cypress run
crashed when using the junit reporter and an assertion failed. Fixes #24652 - Fixed TypeScript types for
testIsolation
. Fixes #23911 - Sessions will no longer be stored if validation fails which will prevent a previously failed session from being restored in the next test. Fixes #24208
Experimental Breaking Changes:
- Updates were made to enhance the cy.session() recovered error experience. With this change, cy.session() will no longer fail validation when false is returned from the validate callback. Fixes #21398, #24205, and #24593.
11.0.1​
Released 11/09/2022
Bugfixes:
- Fixed an 11.0.0 regression that caused enabling
experimentalSessionAndOrigin
to throw a webpack error. Fixes #24611 - Fixed an 11.0.0 regression where using custom reporters would cause Cypress to throw a 'Cannot find module' error. Fixes #24607
- Fixed
testIsolation
configuration validation to allow configuration updates without restarting Cypress. Fixes #24497. - Fixed an issue where
cy.origin()
would not prevent users from setting upsame-superdomain-origin
cy.origin()
blocks. In these casescy.origin()
is not required and users would be better served by not using the command. Fixes #24169 - Fixed an 11.0.0 regression where modifying the currently loaded component testing spec in open mode does not trigger a rerun of the spec. Fixed by #24630
11.0.0​
Released 11/08/2022
Summary:
Component Testing is now generally available for projects using React, Next.js, Angular, and Vue!
Component tests allow you to see and test your application's components in a real browser as you work. You can use your favorite Cypress commands and features to develop your components without running your whole app. Learn more in our blog post.
We have also massively improved our startup performance by shipping a snapshot
of our binary instead of the source files. The performance boost applies to the
time it takes from running a cypress command (e.g. cypress open
) to when the
Cypress app is opened. Results will vary based on your situation, but we saw up
to 84% faster startup times!
Breaking Changes:
Read our Migration Guide which explains the breaking changes in more detail.
Component Testing:​
- Removed
cssFile
,cssFiles
,style
,styles
,stylesheet
, andstylesheets
from theoptions
argument to thecy.mount()
function. We recommend writing test-specific styles in a separatecss
file you import in your test, or in yoursupportFile
. See migration guide. Addresses #24328. - Subsequent
cy.mount
calls within the same test will remove the last mounted component from the DOM. Addresses #24329. mountHook
fromcypress/react
has been removed. We recommend replacing it withmount
and a component. See migration guide. Addresses #24328.unmount
fromcypress/react
has been removed. We recommend using the API React provides for unmounting components, unmountComponentAtNode. See migration guide. Addresses #24328.mountCallback
fromcypress/vue
has been removed. We recommend usingmount
. See migration guide. Addresses #24328.mount
fromcypress/vue
now returns an object with both the VueWrapper (wrapper) and the component instance (component). Addresses #24342.- When providing an inline
viteConfig
inside ofcypress.config
, anyvite.config.js
file is not automatically merged. See migration guide. Addresses #24133. - Angular providers passed as part of the mounting options will be assigned at
the module level using the
TestBed.configureTestingModule
API. This means that module-level providers (resolved from imports or@Injectable({ providedIn: 'root' })
can be overridden, but providers specified in@Component({ providers: [...] })
will not be overridden when usingcy.mount(MyComponent, { providers: [...] })
. To override component-level providers, use theTestBed.overrideComponent
API. See migration guide. Addresses #24047 and #23427.
General:​
- Communication with the Cypress Dashboard will now verify CAs and reject any
unauthorized calls. If you use a self-signed CA you will need to set
npm_config_ca
,npm_config_cafile
, orNODE_EXTRA_CA_CERTS
. Addresses #23980.
Experimental:​
cy.session()
now requires a setup command to use the command. Addresses #24311.
Features:
- Incorporated V8 snapshots into the build process of the Electron binary to improve startup time and reduce the time to download and unzip the binary during installation. Startup time is the time from running a command to when Cypress's window is first opened. Addresses #18480.
cy.getCookie()
,cy.getCookies()
,cy.setCookie()
,cy.clearCookie()
, andcy.clearCookies()
now accept a domain option. Addresses #24264.
Bugfixes:
- Fix types associated with
cy.mount()
that were incorrectly typed asany
. Fixes #24330. - The
cy.mount()
snapshot now shows the mounted component instead of a blank page. Fixes #24138. - "Open in IDE" is no longer displayed in the command log for component tests. Fixes #24366.
- Cypress now correctly handles CSVs and other non-html MIME types. Fixes #24297.
- Cypress now supports project directories mounted on read-only file systems. Fixes #2064.
- Snapshots now capture the AUT correctly when it has navigated away. Fixes #24506.
cy.pause()
now functions correctly when called within thecy.origin()
callback. Fixes #21495.- When utilizing dependencies within the
cy.origin()
callback, errors now show the correct code frame. Fixes #23365. - The select dropdown (in Front-end Framework, Bundler, Organization, Project, Preferred Editor) now highlights and adds a checkmark to the selected option. Fixes #21768.
- The failure icon in the reporter header now displays correctly when there are a large number of successful tests. Fixes #21838.
- Cypress now allows more than twenty sessions to be created in a single test. Fixed in #24379.
10.11.0​
Released 10/25/2022
Features:
cy.session()
is now supported when using WebKit (Experimental) andexperimentalSessionAndOrigin
is enabled. Addresses #24116, #23832.- Improves user experience when connecting a project to the Dashboard. Addresses
#23379,
#23766,
#23767.
- Users will be prompted to connect a project to the Dashboard when logging in from the Cypress Launchpad after a testing type has been selected.
- Users will be prompted to record runs to the Dashboard from both the Cypress App and Cypress Launchpad if a project is connected to the Dashboard and has no recorded runs.
Bugfixes:
- When a chromium based browser tab or process crashes, Cypress will no longer hang indefinitely but will fail the current test and move on to the next. #6170.
- Fixed as issue where browser-skipped tests were incorrectly recorded to the Dashboard which resulted in the Dashboard marking the test as "new" or "modified" when it already existed. Fixes #23517.
- Fixed issue connecting to the cloud when a self-signed cert was in the cert chain. Fixes #24298.
cy.origin()
now supports more than 30 unique origin spec bridges per test. Fixes #22874, #23967.- Fixed an issue where
document.cookie
would not reflect the correct value in cross-origin tests. Fixes #23531. - Cypress will now restart on changes to the
blockHosts
configuration entry. Fixes #22634. - When shown the command to record runs to the cloud, the user can select and copy parts of the command (like the record key), instead of only being able to use the "Copy" button to copy the entire command. Fixes #22091.
- Cleaned up inconsistencies in the UI between sentence case and title case. Fixes #21854.
- Fixed an issue where there is a visible "Project ID" section (with no
projectId
) when user has not connected to the Dashboard. #21806.
Experimental Breaking Changes:
cy.origin()
now supports usingrequire()
and dynamicimport()
to include dependencies.Cypress.require()
has been removed. Addresses #24293.- The way that Cypress handles
test isolation
has changed. The previous modes of
legacy
andstrict
have been replaced withon
andoff
. Fixes #24206.- The default mode is
on
whenexperimentalSessionAndOrigin
is enabled. - The cy.session() command now inherits the test isolation behavior for the suite it runs in.
- The default mode is
10.10.0​
Released 10/11/2022
Features:
cy.origin()
's URL argument must be an exact origin match to the origin of the AUT. Addresses #23999, #23814, #24085, #22882, and #17166.- More accurately send/set cookies in
cy.origin()
whenexperimentalSessionAndOrigin
is enabled. Addresses #23551, #22670, and #23603. - Cypress will no longer watch files when executing component tests in "run" mode. Addresses #22959.
Bugfixes:
- Cypress is now able to connect to Firefox v105. Fixes #23897.
- Cypress component tests now correctly load assets with Angular. Fixes #23797.
- Imports in component testing support files are no longer tree-shaken by Webpack. Fixes #24117.
cy.session()
commands will correctly fail when the setup function has a failing command or assertion. Fixes #21399.ngOnChanges
is now called after mounting an Angular component in component testing. Fixes #23591.- Code frames for Vite project stack traces now point to the correct lines of source code. Fixes #23919.
- Uncaught exceptions are now only handled once in component testing. Fixes #23920.
- Nuxt and Angular component tests now fail on uncaught exceptions. Fixes #24122.
- Command log messages are once again being truncated to 50 lines. Fixes #23995.
Dependency Updates:
- Upgraded Electron from v19 to v21. Addressed in #23843.
10.9.0​
Released 9/27/2022
Features:
- Added support for requiring dependencies within the
cy.origin()
callback. See thecy.origin()
docs for more information. - Added support for visiting cross-origin pages outside of a
cy.origin()
callback. See thecy.origin()
andcy.visit()
docs for more information and caveats. Addresses #21485, #22282, #21300, and #23236. - Added support for re-using session data cached by
cy.session()
across specs via thecacheAcrossSpecs
option. Addresses #17710. - Added support for advanced dev server configuration via an async function that can optionally modify the dev server config. Addresses #23302.
- Launch options returned from the
before:browser:launch
event can now include anenv
key that can be used to pass environment variables to the browser when it is launched. Addressed by #23624. - Component tests that fail now display a code frame of the source location of the error within the Cypress reporter. Addresses #21720.
Bugfixes:
- The spec results printed stdout after a test run now show the path to the spec and not just the file name. Fixes #22304.
- The viewport dropdown in the Cypress App now displays the correct text. Fixes #23789.
- Compile errors are now surfaced in the command log during tests for Angular and Next projects. Fixes #23219.
- The error "Automatic publicPath is not supported in this browser" will no longer be displayed when using Webpack 5 and dynamic imports. Fixes #18435.
- The correct source control link is now sent to the Cypress Dashboard for failed specs when the cypress config file is not the project root. Fixes #22971.
- The error "Invalid left-hand-side in assignment" will no longer be thrown when
the
experimentalModifyObstructiveThirdPartyCode
flag is enabled. Fixes #23647. it.skip
now functions correctly in Angular component tests. Fixes #23409.- The
tsConfig
build option is now respected for Angular component tests. Fixes #23673. - Configuring a custom browser no longer logs a warning when trying to use that browser. Addressed in #23446.
Misc:
- Improved the accessibility of a few components within the Cypress Launchpad and App. Addressed in #23745.
- Improved the UI of the Sessions instrument panel in the Cypress reporter. Addresses #21400.
10.8.0​
Released 9/13/2022
Features:
- You can now run tests in WebKit, Safari's browser engine, by enabling the
experimentalWebKitSupport
experiment and installingplaywright-webkit
. For more details, read our blog post. Addresses #6422.
Performance:
- Several minor changes were made to reduce Cypress's memory footprint in the browser in an attempt to improve test times and reduce the likelihood of crashing the launched browser under test. Addressed in #23708, #23729, #23737, and #23738.
Bugfixes:
- The Dashboard will now correctly show whether a video of the spec was uploaded
to review. Before this change, the Dashboard would shows the error message
The media could not be loaded
when a passing test's video was not uploaded becausevideoUploadOnPasses
wasfalse
. Fixes #2939. - Fixed an issue where the stack traces in
run
mode did not match the stack traces shown inopen
mode. Now, in the terminal, users will see the source map line and column number in the error stack trace. Fixes #7715. - Fixed a bug where projects using Node.js 16.17+ and 18.6+ with ES Modules and TypeScript were not working with Cypress. Fixes #22795, #23393, and #23552.
- When searching for specs we now normalize OS-specific path separators so that Windows users can use back- and forward-slashes. Fixes #23426.
- Fixed an regression introduced in Cypress 10.3.0, and further
exposed in 10.4.0, that omitted
same-site
cookies when the URL Scheme, Domain, and Top Level Domain matched, but the ports are different (i.e. same-site). Fixes #23132. - Autoscrolling of the command log can no longer become disabled in
run
mode. This fixes an issue observed where the reporter randomly stops scrolling during a video recording and the Command log details are not visible. Fixes #16098 and #22199. - The
cypress/react18
cy.mount()
command's yielded rerender function has been updated to only create oneReactDom.Root
element. This fixes the issue where state did not persist between rerenders, and all lifecycle hooks were reran when executed. Fixes #23357. - Fixed a regression introduced in Cypress 10.0.0 where Cypress was incompatible with Chrome v64 - v70. Fixes #23509.
- Fixes an issue where outdated organization and project information could be shown in dialogs when connecting a project to the Cypress Dashboard. Fixes #23538.
- The
Sec-Fetch-Dest
metadata request header is now set todocument
when the request is sent from the Application Under Test when theexperimentalModifyObstructiveThirdPartyCode
experiment is enabled. This was updated to prevent Google Authentication from returning403 forbidden
in Edge and Electron. Fixes #23720. - Correctly override the Electron
userAgent
when theuserAgent
configuration option is provided orexperimentalModifyObstructiveThirdPartyCode
experiment is enabled. Fixes #23597. - Fix regression introduced by Cypress 10.0.0 where the
before:spec
plugin event was not triggered inopen
mode when theexperimentalInteractiveRunEvents
experiment was enabled. Fixed #22360. - Fixed a regression introduced in 10.4.0 where referencing an aliased custom command would return undefined. Fixes #23652.
- Users can now log into the Dashboard from the "Choose a browser" page of the Launchpad even if a browser is not open. Fixes #23779.
- Fixed a bug where the
cypress/svelte
cy.mount()
command was not logging by default. Fixed in #23771. - Fixed an issue where setting the
testIsolation
configuration at the suite-level would throw on the second test. Fixes #23644. - Removed misleading dependency warning in Launchpad for Next.js applications using component testing. Fixes #23598.
- Added
modifyObstructiveCode
TypeScript types. Fixes #22146. - Assertions will no longer 'vibrate' in the command log when asserting on the text of elements with trailing whitespace. Fixed in #23727.
Misc:
- There were some minor improvements made to the UI when configuration files are created for a project when using the Project Setup workflow. Addressed in #21847, #23260 and #23710.
10.7.0​
Released 8/30/2022
Features:
- Re-introduces the experimental
Cypress Studio feature. Cypress Studio
provides a visual way to generate tests within Cypress by recording
interactions against the application under test. Cypress Studio is available
only in end-to-end tests, and must be enabled via the
e2e.experimentalStudio
flag. For more details, read our blog post. Addresses #23461. - Adds Svelte component testing support. This feature is being released as an Alpha, meaning there may be breaking changes in future Cypress releases. Addresses #23037.
- The "Latest Runs" and "Average Duration" columns in the specs list now provide actions when hovered over to assist with the process of connecting the project to the Cypress Dashboard. Addresses #22932.
- Informational banners were added to display instructions to assist with connecting projects to the Cypress Dashboard and recording a first test run. Users who don't plan to use the Cypress Dashboard can dismiss the banners to prevent seeing them in the future. Addresses #22933, #22934, #22798, and #22935.
- Vue.js projects with a custom spec pattern configuration can now use the "Create Spec from Component" capability introduced in v10.5.0. Addresses #23071.
- Angular component testing projects can provide a custom configuration to the
Webpack dev server using the
projectConfig
key. This enables support for projects that don't adhere to Angular CLI conventions. Addresses #23161. - The Cypress
clock
can now be set to a new time using thesetSystemTime
function. Addresses #15424.
Performance:
- The
cy.session()
command's behavior has been enhanced to no longer clear the dom after a validation function runs. This means acy.visit()
command is no longer required after runningcy.session()
when a validation function is used. Addresses #22368.
Bugfixes:
- Fixed an issue where Cypress could crash if a websocket upgrade request was made over HTTPS. Fixes #22217.
- Fixed an issue where filtering with the
--spec
CLI flag in run mode option would not find any specs if the project was located at the root directory of a file system. Fixes #23380. - Fixed an issue where projects using Angular
v14.2.0
and above would be unable to run component tests. Fixes #23585. - Fixed an issue where snapshots performed in XHR requests could reflect the primary domain instead of current domain. Fixes #21496.
- An update was made to correctly track Github Actions retries in the Cypress Dashboard. Previously retries data was not being recorded. Addressed in #23445.
- Fixed an issue where an internal TypeScript type was exposed globally. Fixes #23333.
- Fixed an issue where an incomplete
component.devServer
configuration would cause the specs list to not display in the Cypress App when running Component Tests in open mode. Fixes #23486.
Miscellaneous:
- Display a default icon in the browser selection menu for browsers without bundled icons. Fixes #21766.
10.6.0​
Released 8/16/2022
Features:
- Introduced a new Cypress experiment,
experimentalSingleTabRunMode
, for Component Testing. When enabled, all specs will execute in a single tab, similar to the execution behavior observed in Component Testing alpha in Cypress 9, which can improverun
mode performance, but can impact spec isolation and reliability on large test suites. Addresses #22353. - Enhanced the
CYPRESS_DOWNLOAD_PATH_TEMPLATE
environment variable interpolation to accept and replace${version}
to allow version-specific download paths to be honored. Addresses #5141, #16976, and #22864.
Bugfixes:
- Fixed an issue where the Firefox browser was not downloading files to the expected directory in Windows. Fixes #17896.
- Fixed an issue in
cy.session()
where the unique session id logic was not persisting registered session ids, which incorrectly allowed session ids to override previously used session ids with different setups. Fixes #22381. - Fixed an issue where absolute path glob manipulation was incorrectly breaking
supportFile
andspecPattern
glob patterns that contained deep instances of the working directory. Fixes #23361. - Fixed an issue with the Specs list search that prevented full path matching. Fixes #22463 and #21879.
- Fixed an issue where Specs list popovers would not display a spec's full filename. Fixes #23064.
10.5.0​
Released 8/15/2022
Features:
- Display a 'flaky test' indicator in the Specs Explorer for specs that are known to be flaky in the Dashboard. Addresses #22656 & #22657.
- The project drop down is now populated when connecting a project with an organization that only has one project. Addresses #22936.
- Added new
testIsolation
configuration option to allow users to revert tolegacy
mode whenexperimentalSessionAndOrigin
is set to true. Read more about test isolation in Cypress to learn more. Addresses #22279. - React 18 projects will now be scaffolded with the
cypress/react18
mount registration during component setup. Addresses #23033. - A list of Vue components in the project are now available for selection when generating a new spec for component testing in projects that are using the default spec pattern. Addresses #22836.
- If the user logs in to the Dashboard from the app, but the current project does not have a project ID, the user will now be able to enter the connect project workflow directly. Addresses #23022
- Adds Angular component testing support, including Angular template support and support for Angular standalone components. Addresses #22819.
Bugfixes:
- Fixes an issue where usage of the
--spec
option would result in no specs found if the absolute project path included glob pattern characters. Fixes #22272. - Webpack entry points are no longer preserved for CT Webpack projects. Fixes #23224
- Fixes an issue where session state was not being reset when changing between specs in open mode. Fixes #23146
- Add delay to header tooltips so they don't pop open unless hovered on. Fixes #23115
- Fixed an edge-case bug where Cypress would hang in run-mode if an error was
thrown from a
test:before:run
event handler. Fixes #23039. - Fixes an issue introduced in
10.3.0
where network logs could be missing certain information or cause certain requests to be delayed by 500ms. Fixes #23227. - In the 'Create Blank Spec' dialog, pressing enter or return when the focus is on the spec path input field will create the blank spec. Fixes #21815.
- Fixes React 18 unmount component handling to resolve the
lastMountedReactDom.unmountComponentAtNode is not a function
error. Fixes #23081. - Fixes a regression introduced in Cypress 10.0 where Cypress no longer persisted the spec filter in the 'Search Specs' field during a session and when a project is reopened. The same filter will be used in the main specs list as well as the inline specs list present in the Test Runner. Fixes #21837.
- Fixed an issue that could lead to infinite recursion and thus a crash when
running tests that make use of
cy.intercept()
. Fixes #22693. - In the Launchpad, the project's name will no longer link to the 'Choose Testing Type' step of the launchpad. Fixes #21911.
- CT projects using Vite
v3
work with Node versions>=17
. Fixes #23042 & #23114.
Miscellaneous:
- Updated UI styling for Cypress
about:blank
pages. Addresses #20978. - Stable Firefox versions 101 and 102 are now explicitly rendered as unsupported in Windows due to an unpatched browser incompatibility in those versions. Addresses #23164.
- Add a warning for users on the old React API,
cypress/react
, who are using React 18. Users can now take advantage of the React 18 integration,cypress/react18
. Addresses #23032. cy.state('subject')
is deprecated and reading from it will log a warning to the console. Prefercy.currentSubject()
instead. Addresses #23092.
10.4.0​
Released 8/2/2022
Features:
- Cypress Component testing now supports React 18 via the cypress/react18 package. Addresses #21381 & #21946.
- Cypress Component testing now supports Vite 3. Addresses #22784.
- Cypress introduces a new experimental flag, called
experimentalModifyObstructiveThirdPartyCode
. When enabled,experimentalModifyObstructiveThirdPartyCode
will turn on additionalmodifyObstructiveCode
options to prevent frame busting, as well as striping integrity tags out of<link>
and<script>
elements and remove the electron user agent. In the current state of this experimental flag, SRI is not supported. Addresses #21476, #21307, #22953, & #21474. - Cypress will now display a banner with a corrective action when your project uses a projectId that cannot be found in the Cypress Dashboard and when you do not have access to the current project in the Cypress Dashboard. Addresses #22637.
Bugfixes:
- Fixes issue where cookies were not handled within cy.origin for requests other than the AUT page request. Fixes #22952 & #21474.
- Tooltips are now correctly displayed behind modals. Fixes #22595.
- Fixed a hang when sending video to the dashboard from the electron browser. Fixes #17627.
- Cypress will now throw an error when we receive an unexpected return value from a custom config file. Fixes #21948.
- Cypress will now warn when detecting unsupported dependencies for component testing. Fixes #22025.
- cy.type() can now be used to enter datetime values with seconds, to an input of type datetime-local, for example 1959-09-13T10:12:13. Fixes #22884.
- Next.js in Cypress is now allowed to import global styles. Fixes #22525
- Fixed an issue where 'additionalIgnorePattern' was not allowed to be an array of strings. #22551.
- Prevented timer size from changing while counting up. Fixes #22846.
- Added icons to help indicate that column headers provide more information on hover. Fixes #22638.
- Fixed an issue where long "run urls" are cut off in the console. Fixes #22619.
Dependency Updates:
- Upgraded electron from 18.3.0 to 19.0.8. Addressed in #22775.
- Upgraded bundled Node.js version from 16.13.2 to 16.14.2. Addressed in #22775.
- Upgraded bundled Chromium version from 100.0.4896.75 to 102.0.5005.148. Addressed in #22775.
10.3.1​
Released 7/19/2022
Bugfixes:
- Fixed an issue where file watchers were not completely closed prior to the Cypress App quitting, causing crashes on exit in some macOS environments. Fixes #22026.
- Fixed issues with reloading user configuration after it is updated. Fixes #21785 and #22389.
- Fixed issues with
document.cookie
when testing multiple origins. Fixes #22479 and #22674. - Fixed an issue retrieving git information for non-bash Unix shells. Fixes #22454.
- Fixed an issue that prevented displayed "Last Updated" information on Windows for git repositories without a commit history. Addressed in #22741.
- Fixed styling of the Latest Runs tooltip to keep it centered over the latest run entry. Fixes #22629 and #22598.
- Fixed styling issues with the Specs Explorer at narrow viewport widths. Fixes #22626.
- Fixed a visual issue in the reporter where special characters would be incorrectly formatted with markdown. Fixes #5679.
- Fixed an issue where the Proxy-Authorization header included capitalization that would fail with certain proxies. Fixes #22383.
- Added
react-dom
as a required dependency when setting up a React project for Component Testing. Fixes #22371. - The Spec Runner will no longer overflow unexpectedly in Firefox in certain situations. Fixes #21881 and #22610.
- Fixed a regression where the
CYPRESS_NO_COMMAND_LOG
environment variable was not honored. Fixes #21721 and #21271. - Using
cy.contains()
with a regular expression now matches submit-type input labels correctly. Fixes #21166. - Prevent printing "Class WebSwapCGLLayer is implemented in both" warning in stdout. Fixes #21615.
- Fixed the pluralization of Match(es) under Project Settings. Fixes #21728.
- Fixed a regression where absolute elements were not properly blacked out in screenshots. Fixes #22173.
Miscellaneous:
- Improved keyboard navigation for Latest Runs data in the Specs Explorer. Addresses #22628.
- Improved accessibility and styling around Specs Explorer tooltips. Addresses #22597.
- Improved the styling and behavior of the Copy button seen in the Migration workflows. Addresses #21860 and #21862.
- Improved the layout of the Launchpad Docs dropdown when the viewport is narrow. Addresses #21842.
- Removed autocomplete from certain inputs in the Cypress App. Addresses #22102.
- Removed the Projects breadcrumb from the Launchpad when not in global mode. Addresses #21771.
- Added padding to the bottom of the projects list in the Launchpad. Addresses #21724.
- Improved the display of the "Record your first run" banner at smaller widths. Addresses #21856.
- The Cypress App's sidebar will now automatically collapse at narrow widths. Addressed in #22393.
- Improved punctuation consistency and reduced the need to scroll in the Key Differences modal. Addresses #21852.
10.3.0​
Released 6/28/2022
Features:
- Cypress Dashboard test data is now available real-time within Cypress. For more details, read our blog post. Addressed in #21250 and #22497.
- Added a new clear button to easily clear the search text when filtering specs in the Cypress runner. Fixes #21686.
Bugfixes:
- Fixed a memory leak in Chromium-based browsers caused by storing
data:
urls containing base64 encoded files unnecessarily. Fixed #17853 and #22462. - Updated cross-origin cookie handling to align with browser behavior. This fixed various issues with cookies when testing across multiple origins. Fixed #21363 and #20685.
- Updated Cypress to use posix paths to fix an issue on Windows when a project
required
node-ts
. Fixes #22544 and #22297. - Fixed a 9.x to 10.x migration bug where the migration tool would hang without
a response when it attempted to read the
pluginsFile
contents when thepluginsFile
value was a directory path instead of a relative file path. Fixed #22461. - Fixed the process profiler to output Cypress's summarized CPU and memory
metrics when the
cypress:server:util:process_profiler
debug stream is enabled. Fixed #22022. - Fix styling issue observed when long text was entered in the search when filtering specs in the Cypress runner. Fixes #21686.
- Corrected the TypeScript types to include
baseUrl
as a valid test config override option. Fixes #22374 and #22072.
10.2.0​
Released 6/21/2022
Features:
- Cypress is now available natively on Apple silicon, including the M1 and M2 processor families. For more details, read our blog post. Addresses #19908.
- Cypress is now available natively on ARM64 and AArch64 systems running Linux. Addresses #4478.
- The file name input field within the Create Spec modal is now automatically focused when the modal is opened. Addresses #21865.
Bugfixes:
- Suppressed a misleading Chromium warning about CertVerifyProcBuiltin that would appear when visiting HTTPS sites in Cypress. Fixed #22128.
- Users will be able to see the custom reason-phrase in the HTTP response if the custom reason-phrase is set. Otherwise, a default status message is returned based on the corresponding status code as earlier. Fixed #16973.
- Fixed an issue where Cypress would crash with an EMFILE error if the process ran into the file descriptor limit. Fixed #22023.
- Fixed an issue causing a "nohoist config is ignored" warning when installing cypress with yarn. Fixed #22147.
- Spec directories and file names on the Specs page are now truncated if they exceed their column width. Fixed #21895.
- Updated the file links in error views to wrap appropriately and no longer overflow their containers. Fixed #22103.
- The Cypress v10 introduction video will now be skipped if loading the video takes longer than 3 seconds. Fixed #21955.
- Updated the warning banner to use language consistent with the rest of the Cypress application. Addressed in #21551.
Dependency Updates:
- Upgraded the bundled electron version shipped with Cypress from
18.0.4
to18.3.0
. Addressed in #22252.
10.1.0​
Released 6/10/2022
Features:
- Cypress will show an improved error message when running
cypress run --ct
when component testing has not been configured. Fixed#21909
Bugfixes:
- Added support for TypeScript projects using
"type": "module"
using ts-node/esm. Fixed #22096, #21939, and #22074 - Users can now run multiple specs with
cypress run
in headed mode on linux and windows in chrome. Fixed #22155 - The baseUrl config option will now restart the Cypress server automatically when it is updated in a Cypress config file. Fixed #22056
- The supportFile can now be detected within projects that contain glob syntax characters in their absolute paths. Fixed #22040
- Selector Playground "copy to clipboard" now copies full command rather than just the selector. Fixed #22043
- The clickable area for the specs list has been expanded to include the entire row. Fixed #22105
- Removed the trailing period from the "Learn More" button. Fixed #21807
- Clicking the application under test url will now open the application in another tab. Fixed #21823
10.0.3​
Released 6/3/2022
Bugfixes:
- Cypress will only watch files that match the provided
specPattern
. Fixed #22054 - Cypress will no longer crash when run behind a proxy that blocks Cypress's CDN. Fixed #22081
- Contrast increased on inline spec list header items for improved accessibility. Fixed #21870
- Updated UI to not show the spec list as selected when in the runner. Fixed #21873
- "Cypress" is now capitalized step 3 of migration text. Fixed #21798
- The browser list in the cypress apps top nav is now scrollable with a large number of browsers. #22032
- Newly scaffolded spec files will no longer be generated with as a failing test. Fixed #21921
- Cypress will not crash if it fails to access the machine-id on windows. Fixed #22110
10.0.2​
Released 6/2/2022
Bugfixes:
- Cypress will no longer watch files when in run mode. Fixed #22054
- Improved support for esm in windows. Fixed #22038
- Improved TypeScript detection in project:
- Ensures TypeScript actually exists (via
require.resolve
) and is specified in dependencies or devDependencies before migrating a project to use it. - When creating a new project include
*tsconfig.json
glob in algorithm to detect TypeScript. - When migrating the existing files in the
cypress
folder should be enough info to make the determination. - No longer includes
.d.ts
files when detecting TypeScript - Fixed #22034, #22108, and #21997
- Ensures TypeScript actually exists (via
- Vite dev-server for component testing will not crash if user has vite plugins that rely on non-empty plugins list. Fixed #22021
- Post processing ffmpeg is now run at a lower priority. Fixed #21585
10.0.1​
Released 6/1/2022
Bugfixes:
- The inline spec list is now scrollable. Fixed #21995
.check()
and.uncheck()
will now properly remove the indeterminate state from checkboxes. Fixed #21665- An error will no longer throw warning that
cypress
isn't a module after migrating a project's configuration file when using the direct download of Cypress. Fixed #2199 - Cypress will now throw a more description error when TypeScript errors are
encountered when reading a
cypress.config.ts
file. Addressed in #22009, Related to #21997 & #22004 - We now more correctly handle EPERM errors related to chokidar watching files when there are permission issues. Fixed #22002
- The migration step for support file is no longer shown when the user had a custom support file path. Fixed #22012
- Styles are now applied correctly after a user views the runs page and returns to the specs list. Fixed #21931
Misc:
- Updated messaging displayed when the
experimentalStudio
configuration is found. Addresses #22008
10.0.0​
Released 6/1/2022
Summary:
Component testing is now beta! We've also reworked the Cypress app from the ground up to modernize the interface, streamline workflows and integrate better into your overall development experience. Read more about 10.0 in our blog post.
Breaking Changes:
Please run cypress open
to go
through our interactive migration which will guide you in updating your files and
configuration options. Read our Migration Guide
which explains some breaking changes in more detail.**
-
We introduced several breaking changes to the Cypress configuration file detailed below:
- Using a
cypress.json
configuration file is no longer supported. Replace this configuration file with acypress.config.js
,cypress.config.ts
,cypress.config.cjs
orcypress.config.mjs
file. This change provides better flexibility and extensibility of configuration. An error will be thrown if both acypress.json
file andcypress.config.{cjs,js,mjs,ts}
file are found. Addressed in #18221, #18300, #20554, and #20643. - A Cypress configuration file is now required and passing the CLI flag
--config-file=false
will throw an error. Addressed in #20643. - A default configuration file will no longer be auto-generated by Cypress
when a configuration file doesn't exist. Instead, you can run
cypress open
and set up your project with a specific testing type to have this file generated. This allows you to customize the configuration setup by testing-type for the language and dependencies leveraged in your project. - The configuration file's JSON schema is no longer supported since the configuration can no longer be provided via a JSON format.
- Using a
-
Cypress has made several configuration option changes including renaming options, removing options, and only allowing some options within a specific testing type. Please run
cypress open
to have our automated migration update these options for you.- Many configuration options are now specific to either end-to-end or component testing. The types have also been updated to match the new structure. Addressed in #20677.
- The
baseUrl
andexperimentalSessionAndOrigin
configuration options are no longer valid as top-level configuration options and can only be defined within thee2e
configuration. Addressed in #20589 and #21588. - The
supportFile
andslowTestThreshold
options are no longer valid as top-level configuration options and must now be defined within thee2e
and/orcomponent
configurations. - Previously the
supportFile
option defaulted tocypress/support/index.js
. Now thee2e.supportFile
option defaults tocypress/support/e2e.{js,jsx,ts,tsx}
and thecomponent.supportFile
option defaults tocypress/support/component.{js,jsx,ts,tsx}
. Addressed in #19776 and #19364. - The
pluginsFile
option was removed. This option should be replaced with the newsetupNodeEvents()
anddevServer()
configuration options. Addressed in #18798 and #20560. - The
testFiles
option was removed. This option was replaced with the newspecPattern
option. Addressed in #19319 and #20565. - The
integrationFolder
andcomponentFolder
options were removed. These options were made obsolete by the newspecPattern
option. Addressed in #19319. - The
ignoreTestFiles
option was removed. This option was replaced with the newexcludeSpecPattern
option. Addressed in #19319. - The
experimentalStudio
option was removed with the removal of the experimental Cypress Studio feature. If this option is configured in your project, a warning message will be displayed. Please leave any feedback around Cypress Studio here. Addressed in #20515.
-
During
cypress open
, the ability to "Run all specs" and "Run filtered specs" has been removed. Please leave feedback around the removal of this feature here. Your feedback will help us make product decisions around the future of this feature. -
The experimental Cypress Studio feature has been removed. Please leave feedback around the removal of this feature here. Your feedback will help us make product decisions around the future of this feature. Addressed in #20515.
-
You will no longer be able to run your tests during
cypress run
orcypress open
in browser versions that are not supported by Cypress. -
Generated screenshots and videos will still be created inside their respective folders (
screenshotsFolder
,videosFolder
). However, the paths of generated files inside those folders will be stripped of any common ancestor paths shared between spec files found by thespecPattern
option and may no longer be deterministic. Addressed in #19319.
Deprecations:
- The
cypress open-ct
andcypress run-ct
commands have been deprecated. Usecypress open --component
andcypress run --component
instead. Addresses #18418.
Features:
-
Cypress 10 now includes beta support for component testing. More features around component testing are detailed below:
- Component testing is now integrated directly into the main app, allowing you to choose which testing experience you want upon launching Cypress. See our current support for frameworks and bundlers. Addressed in #21111.
- Cypress will now guide you through installing the component testing dependencies and project setup necessary to begin component testing in Cypress. Previously this required manual setup and referencing the documentation.
- When you use the Cypress app during
cypress open
to configure your project for CT testing, acy.mount()
command will be automatically scaffolded for you in act.supportFile
. - You can now create an empty component testing spec file from within the Cypress app directly and preview the specfile upon creation.
- The following component testing plugins are now shipped with Cypress to
enable easy
cy.mount()
implementation. Your local framework dependencies found innode_modules
will be referenced to prevent adding additional dependencies or peer-dependencies to yourpackage.json
. From now on, the latest plugin version will be shipped with each Cypress release. See our current support for frameworks and bundlers. Addressed in #20930.@cypress/[email protected]
@cypress/[email protected]
@cypress/[email protected]
@cypress/[email protected]
-
We've enhanced how you can set and refresh configuration detailed below:
-
We've added several new configuration options detailed below:
-
The
setupNodeEvents()
option is a new testing type specific configuration option. It must be defined within thee2e
and/orcomponent
configurations. This option allows you to modify your loaded configuration, listen to events and register plugins. This option replaces thepluginsFile
option. Addressed in #18798 and #20560. -
The
devServer
option is a new component testing specific option that must be defined within thecomponent
configuration. This option provides a mechanism for starting a component testing dev-server when tests are running. -
The
specPattern
option is a new testing-type specific configuration option that must be defined within thee2e
and/orcomponent
configurations. This option accepts a glob or an array of globs of the spec files to load. This option simplifies the spec discovery by replacing thecomponentFolder
,integrationFolder
andtestFiles
options. Addressed in #19319, #20565 and #20853.- The
e2e.specPattern
default value for new projects iscypress/e2e/**.cy.{js,jsx,ts,tsx}
. For existing projects, please runcypress open
to have your spec files automatically migrated to match thisspecPattern
. Addressed in #21193. - The
component.specPattern
default value is**/*.cy.{js,jsx,ts,tsx}
.
- The
-
The
excludeSpecPattern
option is a new testing type specific configuration option that must be defined within thee2e
and/orcomponent
configurations. This option accepts a glob or an array of globs which allows you to ignore spec files that would otherwise be shown in your list of specs. This option replaces theignoreTestFiles
option. Addressed in #19319, #19980, #20763, #20853.- The
e2e.excludeSpecPattern
default value is the same as the replacedignoreTestFiles
glob pattern of*.hot-update.js
. - The
component.excludeSpecPattern
default value is['**/__snapshots__/*','**/__image_snapshots__/*']
plus thee2e.specPattern
glob patterns. - The
**/node_modules/**
pattern is automatically added to bothe2e.excludeSpecPattern
andcomponent.excludeSpecPattern
and can't be overridden. This is consistent with <10.0 behavior.
- The
-
Intelligent Code Completion was added with the
defineConfig()
helper function. This enables configuration auto-completion and in-line documentation in the configuration file in your IDE. While it's not strictly necessary for Cypress to parse your configuration, we recommend wrapping your config object withdefineConfig()
. Addressed in #18302.
-
-
We've made some updates to Cypress API commands detailed below:
-
Enhancements were made to provide visual indication of nested commands and logs. With this change, users are now able to click on log groups to print additional log details to the dev tools console.
-
The
.within()
command was updated to provide visual indication of logs and commands executed in the.within
command context. Addresses #20433. -
The redundant
cy.session()
log is now removed. Address #7673 in #21457. -
Users can now add custom
cy.hover()
andcy.mount()
implementation usingCypress.Commands.add()
since we don't provide a default implementation. Previously users had to useCypress.Command.override()
to provide the custom implementation. Addresses #18941.
-
-
We've made some updates to the Cypress CLI detailed below:
-
You can now pass in testing type specific configuration options via the
--config
CLI flag without nesting JSON. Addressed in #20127. -
New
--e2e
and--component
CLI flags were added tocypress run
andcypress open
to allow a user to run or launch Cypress for a specific testing-type. If a testing-type specific CLI flag is not provided when runningcypress run
, Cypress will run end-to-end tests by default. -
A warning message is now displayed when
cypress open
is ran with the--browser
CLI flag for a browser that does not exist on the system. Addressed in #18473. -
If a testing type and browser flag are passed to
cypress open
when launching a specific project, the browser will automatically launch. Addressed in #21538.
-
-
The
cypress open
experience has been updated to take you through our Launchpad with many features detailed below:-
When you launch Cypress via
cypress open
you'll be asked whether you want to do end-to-end or component testing and taken through the configuration necessary to set up your project. Addressed in #18924. -
Having files scaffolded on new projects during end-to-end testing is now opt in and not automatic. Addressed in #18924.
-
When Cypress detects you have a
cypress.json
duringcypress run
, it will error and ask you to runcypress open
to migrate. When Cypress detects you have acypress.json
duringcypress open
, it will guide you through project migration to ensure your project continues to work as expected. Addressed in #18924.
-
-
After launching the browser, there are several new features in our App detailed below:
- The Cypress app has been redesigned so that the Command Log and all associated navigation display with a dark background.
- You can now change specs or the browser within the same window as running your tests.
- Many git details are now shown within your current project in Cypress including the current branch and the last commit details of each spec in the spec explorer. Addressed in #20648, #21139, #21436 and #20744
- When creating a new spec within Cypress, your project's language is detected
to provide the correct file extension and the
specPattern
is checked to ensure the spec is found by Cypress. After creating the spec, you can preview the spec that was generated with the option to immediately run the spec or create another spec. Addressed in #21225, #20567, #20657, #20962. - The Settings page has been redesigned to more clearly distinguish between settings that are specific to the project, your device, and the Dashboard.
Bugfixes:
- An error message is displayed when you add a command using
Cypress.Commands.add()
that has the same name as an internal reserved Cypress command. Addresses #6146. - A one pixel, left, vertical border was removed that was incorrectly included
on screenshot artifacts generated from the
cy.screenshot()
command in component tests. Addressed in #21019. - A memory leak was fixed during
cypress run
for end-to-end tests launched in Chromium and Firefox browsers that reduces the overall time it takes to run a set of specs and aligns with how the browser is launched once for all specs in component testing. With this change, thebefore:browser:launch
node event will now properly only fire once per run, instead of firing before each spec. Addressed in #19915. - The default webpack configuration's host value was changed from
localhost
to127.0.0.1
to support the Node 17+ changes with how DNS names are resolved. Addressed in #21430. - Cypress will throw a detailed error when some plugin versions are no longer supported in Cypress 10. Addressed in #21169
Dependencies:
- Added
@cypress/[email protected]
dependency. - Added
@cypress/[email protected]
dependency. - Added
@cypress/[email protected]
dependency. - Added
@cypress/[email protected]
dependency.
Misc:
- The Plugins concept in Cypress still exists with the intent to tap into,
modify or extend the internal behavior(s) of Cypress. It however is expected
to be used in conjunction with our new
setupNodesEvents
configuration option, which was named to reflect that Plugins leverage Cypress's node events.
9.7.0​
Released 5/23/2022
Features:
- The Electron version and shipped Chromium browser version has been updated. Addressed in #21418.
Deprecations:
- The
Cypress.Cookies.preserveOnce()
andCypress.Cookies.defaults()
Cypress APIs have been deprecated. In a future release, support forCypress.Cookies.preserveOnce()
andCypress.Cookies.defaults()
will be removed. Consider using the experimentalcy.session()
command instead to cache and restore cookies and other sessions details between tests. Fixed #21333.
Bugfixes:
- Updated the
cy.contains()
command to correctly error and retry if the provided regex pattern begins with an equal sign and a match was not initially found. Previously the command would incorrectly fail with a syntax error. Fixed #21108. - Corrected the
cy.session()
command log grouping and validation verbiage. This change provides better insights to logs associated with the command. Fixed #21377. - Removed
eventemitter2
third-party type definitions fromcy
andCypress
that were unintentionally exposed. Fixed #20556.
Dependency Updates:
- Upgraded the bundled node version shipped with Cypress from
16.5.0
to16.13.2
. Addressed in #21418. - Upgraded the Chromium browser version used during
cypress run
and when selecting Electron browser incypress open
from94.0.4606.81
to100.0.4896.75
. Addressed in #21418. - Upgraded
electron
dependency from15.5.1
to18.0.4
. Addressed in #21418.
9.6.1​
Released 5/9/2022
Bugfixes:
- Cypress can now launch on systems where Firefox is installed via Snapcraft. Fixed #19793.
- Updates were made to ensure XHR calls are properly displaying the response body in the command log. Fixed #21361.
- Fixed
cy.contains()
and.should('contain', ...)
to handle finding text that contains backslash characters. Fixed #19116 - Updated
.type('{enter}')
to support sending the Enter keystroke to submit buttons that are not rendered within a form html element, but are associated with a form via theform
attribute. Fixed #21163. - Fixed an issue with
cy.session()
such that re-running tests in open mode will now correctly recreate a session. Before this change, an error was thrown indicating the savedsetup
function was not a function because it was serialized. Fixed #17805.
9.6.0​
Released 4/25/2022
Features:
- Now you can easily test multi-domain workflows by using the experimental
cy.origin()
command. This feature allows you to test across different origins or domains within a single test. This experiment was designed to work side-by-side with thecy.session()
experimental feature. You can turn on use of this command by setting theexperimentalSessionAndOrigin
configuration option totrue
. For more details, read our blog post. Addressed #17336 and #944.- Added a new configuration option called
experimentalSessionAndOrigin
. This option enables support forcy.session()
andcy.origin()
for end-to-end testing. - The
experimentalSessionSupport
configuration option has been removed and replaced by theexperimentalSessionAndOrigin
configuration option. Please update your configuration to use the newexperimentalSessionAndOrigin
option to continue to opt-in to this experimental feature. - When
experimentalSessionAndOrigin
is enabled, cross-origin requests will no longer immediately fail, but instead, time out based on thepageLoadTimeout
configuration. This allows the request to be appropriately handled by thecy.origin()
command. - When
experimentalSessionAndOrigin
is enabled, Cypress will no longer wait on page loads between hooks before moving on to the next test.
- Added a new configuration option called
Bugfixes:
- Fixed an issue with Firefox 98+ where the Enter keystroke was not being sent
to an input element when using
.type('{enter}')
. Fixed #21033. - We now verify if an interruption while running tests was signaled by the user or if it came from an error in a plugin before showing the error message. Fixed #21010.
- Improved the error message observed on Windows platforms when unzipping the Cypress binary and the max file length is exceeded. Fixed in #21047.
- Updated the
Cypress.Commands.add()
TypeScript types to better reflect the attributes of the.add()
utility and the JQuery element, a possible previous subject type. #20376.
Dependency Updates:
- Upgraded
electron
dependency from15.3.5
to15.5.1
to consume fixes related to improve performance on macOS Big Sur and later. Addressed #21068.
9.5.4​
Released 4/11/2022
Bugfixes:
- Updates were made to silence Electron warnings related to being unable to connect to dbus. These errors are normal and expected, and do not result in test failures. Because they are always present when running Electron inside docker containers, it has incorrectly led people to believe it is the root-cause of an error within their test run. By silencing these errors, it will improve the debug experience to allow users to focus on meaningful warning and error messages. Fixed #19299.
- Updates were made to ensure that all
*.enable
events are sent if Cypress becomes disconnected from the Chrome DevTools Protocol and must re-establish a connection to ensure all command logs are displayed to the user. This fixes an issue where some command logs, like download or network events, are missing once Cypress has disconnected and then reconnected to the Chrome DevTools Protocol. Fixed #20618. - Fixed an issue where
cy.type('{enter}')
was not sending the Enter key for Firefoxv98+
. This was not an issue with Firefoxv97
and below. Fixed #20562. - Fixed a regression in 9.3.0 where glob
patterns provided to the
--spec
CLI parameter was incorrectly splitting the patterns in unexpected places when it should have split on commas. Fixes #20794. - Fixed an issue with
cy.root()
to respect thetimeout
option passed to the command. Previously, when thetimeout
option was provided, it was ignored and the default timeout was used. Fixed #19985. - Updates were made to decrease the length of the Cypress cache path for Windows to ensure installing pre-release versions of the Cypress binary are within the maximum path length of 260 characters. Fixed in #20961.
- Fixed a regression in 8.6.0 which
prevented
.pause()
from correctly executing when passing the--headed --no-exit
CLI flags tocypress run
. Fixed #20745. - Fixed a regression in 9.2.0 which would
sometimes throw an expected error on navigation with
cy.back()
andcy.go()
. Fixed #19749 and #20539. - Corrected the TypeScript type for a cookie which was incorrectly typed as
any
when the correct type isCookie
. Fixed in #20513. - Added the missing
Cypress.Command.addAll()
TypeScript types. Fixed #18886. - Fixed an uncommon error observed in
cy.session()
where an error was thrown when no cookies had been set for the session and the user clicks the session command log to view additional details in the DevTools console. Fixed in #20946.
Misc:
- A minor visual update was made to the
cy.session()
command log visuals. Fixed #20433.
Dependency Updates:
- Upgraded
ansi-regex
dependency from4.1.0
to4.1.1
to address the CVE-2021-3807 NVD security vulnerability. Addressed in #20807. - Upgraded
plist
dependency from3.0.4
to3.0.5
to address the CVE-2022-22912 NVD security vulnerability. Addressed in #20808.
9.5.3​
Released 3/28/2022
Bugfixes:
- Corrected a logging issue with
cy.intercept()
where the response status code and response body were sometimes missing from the log details inopen
mode. Fixed #18757. - Fixed an issue in
cy.readFile()
where the command would not retry or provide a meaningful error message ifnull
encoding was used and the file was not found. Fixed #20683. - Updated the Cypress Keyboard shortcuts to only run the shortcut when the
pressed shortcut key was not used in conjunction with either the
alt
,ctrl
, orshift
modifier keys. This fixed an issue where the Cypress shortcut handler would override the browser native keyboard shortcut for search (ctrl + f
). Fixed #20222. - Updates were made to correctly escape dollar signs in the
CYPRESS_DOWNLOAD_PATH_TEMPLATE
environment variable. Issues were seen utilizing this template when the env was provided from a package manager file. Fixed #19914. - Fix the
Cypress.Buffer
TypeScript type to reference the static constructor ofBuffer
, instead of incorrectly referencing theBuffer
instance which caused Type errors. Fixes #20542.
Dependency Updates:
- Upgraded
electron
dependency from15.3.4
to15.3.5
to address the CVE-2022-21718 NVD security vulnerability. Addressed in #20750. - Upgraded
minimist
dependency from1.2.5
to1.2.6
. Addressed in #20756. - Upgraded
nanoid
dependency from3.1.20
to3.1.31
to address the CVE-2021-23566 NVD security vulnerability. Addressed in #20726. - Upgraded
node-forge
dependency from1.0.0
to1.3.0
to address the CVE-2022-24771 NVD security vulnerability. Addressed in #20727.
9.5.2​
Released 3/14/2022
Bugfixes:
- Fixed an issue with
.type()
where click events could be fired on the incorrect target element because the target focus changed within a key-down event handler callback. Fixed in #20525. - Fixed a regression in 9.5.0 where ANSI
colors were not removed from the FireFox warning message about the
chromeWebSecurity
configuration option having no effect on the Firefox browser. Fixes #20496. - Updates were made to the pre-release build setup such that Cypress will use a
unique cache folder for each
pre-release installation
on a machine. This removes the need to run
cypress clear cache
before installing a new pre-release version of Cypress or before installing a new released version of Cypress after a pre-release version had been installed. Addressed in #20296.
Misc:
- Updates were made to explicitly disable the
Origin-Agent-Cluster
header for proxied responses to ensuredocument.domain
can continue to be set with Chrome v106+. This was necessary because Chrome is planning to makedocument.domain
immutable in v106+ to relax the same-origin policy by interpreting theOrigin-Agent-Cluster
astrue
, whereas it is currently interpreted asfalse
. Addresses #20147.
Dependency Updates:
- Upgraded
url-parse
dependency from1.5.6
to1.5.9
to address these NVD security vulnerabilities, CVE-2022-0639, CVE-2022-0686 and CVE-2022-0691. Addressed in #20386 and #20439.
9.5.1​
Released 2/28/2022
Bugfixes:
- Added a
ready
event to the Plugins process to ensure all plugins have successfully started before the configuration is loaded and the tests start. Fixed in #19792.- This fixes an issue where the plugin is never executed and leaves Cypress stuck in the initialization phase, where the user can only view the loading spinner.
- This enables support for node's experimental
--loader
flag for plugins.
- Made a change to the DNS lookup to improve test performances and reliability on MacOS machines that leverage the VMWare CBCloud SaaS solution. Before this change, random test failures were observed, as well as hanging tests and initially pending HTTP and HTTPS responses. Fixed in #20062.
- Fixed a regression in 9.5.0 where ANSI
colors were not removed from the
cy.fixtures()
error code frame. Fixes #20208. - Fixed a regression in 9.5.0 where the test config override errors were formatted incorrectly. Fixes #20208.
- Fixed an issue where Cypress would throw an error when reporting or wrapping errors with booleans or numbers. Fixes #19561.
Dependency Updates:
- Upgraded
url-parse
dependency from1.5.2
to1.5.6
to avoid authorization bypass through user-controlled key to address this NVD security vulnerability. Addressed in #20270.
9.5.0​
Released 2/15/2022
Features:
- Enhancements were made to the error experience in both run mode and open mode to improve readability and provide meaningful stack traces. Addressed in #20124.
- Updated the
cy.request()
log message to hide the origin when it matched the browser origin to make debugging easier. This reduces the length of the log message that could be partially hidden if a long url is requested. Addressed in #20009. - Updates were made to log the
ShadowRoot
andDocument
elements as HTML elements. Previously these would be logged as enumerated objects, which were difficult to evaluate. Addressed in #20049. - Updated the terminal output generated in Cypress run mode to de-emphasis the
node
path in the run header. Addressed in #20120.
Bugfixes:
- Fixed an issue where files attached during
.selectFile()
could have the wrongFile
prototype. Fixes #20003. - Updated
.select()
to only dispatch thechange
andinput
events when the selected option is not the currently selected option. This change aligns.select()
with the browser. Fixes #19494. - Updated
.type(' ')
to align with the W3C standards where a click event should be dispatched when the Space key is pressed and the current focus is on a state-changing element with typebutton
,image
,submit
orreset
. Fixes #20067.
9.4.1​
Released 1/31/2022
Bugfixes:
- Fixed a regression in 9.4.0 where the line endings in the public npm package prevented some users from running Cypress. Fixes #19986.
9.4.0​
Released 1/31/2022
Features
- Enhancements were made to
.selectFile()
after receiving feedback after its initial release in 9.3.0.- The default behavior was updated to automatically infer the mime type of files based on their extension to correctly encode file uploads. Addressed in #19751.
- Added the
mimeType
property so you can explicitly set the mime type on files using themimeType
property. Addressed in #19751. - Updated file contents types to allow either a
TypedArray
instance or aCypress.Buffer
instance, where previously file contents were expected to only be an instance ofCypress.Buffer
. Addressed in #19751. - Updated
.selectFile()
to retain the fileName of files read from disk to work with aliases. Addressed in #19803.
Bugfixes:
- Fixed a regression in 9.3.0 to correctly
parse the
--spec
CLI parameter for glob patterns containing a range. Fixes #19783. - Fixed regression in 9.2.1 where the
--openssl-legacy-provider
flag was not being passed to the plugins' child process when the user's system Node version was Node 17+ built with OpenSSL v3+ which resulted in Cypress crashing when trying to run tests. Fixes #19712. - Update
.type('{enter}')
to align with the W3C standards where a click event should be dispatched when the Enter key is pressed and the current focus is on a state-changing element with typebutton
,image
,submit
orreset
. Fixes #19541.
9.3.1​
Released 1/19/2022
Bugfixes:
- Fixed an issue where the bin file was released with windows line breaks. Fixes #19747.
9.3.0​
Released 1/18/2022
Features:
- Added a new Cypress command, called
.selectFile()
, to select a file or files in an HTML5 input element or simulate dragging a file or files into the browser. The API is similar tocypress-file-upload
and we have provided a migration guide for previous users of that plugin. For more details, see our blog post. Fixes #19524 and #170. - Exposed the
Buffer
polyfill, asCypress.Buffer
, to enable working with binary data. Addressed in #19524. - Added the
CYPRESS_DOWNLOAD_PATH_TEMPLATE
environment variable which can be set to a string template for building the download URL for the Cypress binary. This environment variable is useful for users who are downloading the Cypress binary from a proxy that is not one-to-one with the Cypress's default download url. More information can be found in the Install Binary documentation. Fixes #15697.
Bugfixes:
- Fixed an issue where the
--spec
CLI parameter was not working properly when passing multiple glob patterns that are separated by commas. Fixes #16102. - Fixed an issue with how the
CYPRESS_VERIFY_TIMEOUT
environment variable was read so it can set in a project'spackage.json
or its.npmrc
. Fixes #19559.
Dependency Updates:
- Upgraded
graceful-fs
from4.2.0
to4.2.9
. This upgrade resolves issues observed with using graceful-fs v4.2.0 with resolve v1.21+. Addressed in #19676 and resolves #19610.- NOTE: This upgrade to
graceful-fs
breaks Cypress's compatibility with Yarn 2. We have observed errors with Yarn 2.4.2 withgraceful-fs
4.2.9. Before this change, Cypress had minimal Yarn 2 support (see #6377). Between Yarn 3 fixing multiple bugs and the migration path from Yarn 2 to Yarn 3 being minimal, we felt the best step forward was to support and recommend Yarn 3 over Yarn 2.
- NOTE: This upgrade to
- Upgraded
electron
from15.2.0
to15.3.4
. Addressed in #19351.
9.2.1​
Released 1/10/2022
Bugfixes:
- Fixed a regression in 9.2.0 to keep
Cypress open after each spec finishes when the
--headed --no-exit
flags are passed tocypress run
. Fixes #19485. - Improve heuristic for verifying when the
--openssl-legacy-provider
option should be passed to the plugins' child process when the system Node version is v17+. This prevents Cypress from crashing when a user has Node 17 installed which was built with OpenSSL v1. Fixes #19320. - Correctly cast the
CYPRESS_VERIFY_TIMEOUT
environment variable as a number so Cypress will no longer throwTypeError: Expected the timeout option to be a non-negative integer
. Fixes #19476.
Dependency Updates:
- Update pinned resolution of
cli-table3
from~0.6.0
to~0.6.1
to avoid problems with the bug introduced in the colors.js v1.4.44-liberty-2 release. Addresses #19624.
9.2.0​
Released 12/20/2021
Features:
- Cypress will throw an error when a user attempts to update a configuration
value at run-time using either the Test Configuration or using
Cypress.config()
that is a readonly option. Addresses #6407 and #19001. - A
timeout
option has been added to thecy.writeFile()
command, with a default value ofdefaultCommandTimeout
. Addresses #3350. - The default
maxHttpBufferSize
for the internal socket server has been increased to Node's maximum Buffer size (size varies by OS) to allow large file writes withcy.writeFile()
. Addresses #19140. - Add
CYPRESS_VERIFY_TIMEOUT
environment variable to override the timeout duration of theverify
command. Addresses #18290.
Bugfixes:
- Prevent unnecessary snapshotting when running default assertions that would
unnecessarily increase CPU use in
cypress open
mode which lead to out of memory crashes on certain browsers. Fixes #18549. - Removed automatic retries for failed HTTP requests through the proxy. This fixes an issue where failed requests could be re-sent too many times in some conditions. This change could increase the number of failed requests that your app sees. Fixes #19043.
- Reduced the occurrence of an issue where logs for
fetch
andxhr
requests could be associated with the wrong request. Fixes #19043. - Tests that are skipped within
then
blocks will no longer throw errors causing the test to fail. Tests that are skipped outside ofthen
blocks will no longer trigger the fail event. This will prevent screenshots from happening from errors thrown by the fail event. Fixes #14867 and #17660. - Fixed a regression in 9.0.0 where a
fixture provided in a static response to
cy.intercept()
did not support passingnull
to encoding to read the fixture as a Buffer. This identified an undocumented 9.0.0 Breaking Change where the default read behavior of a fixture changed from a Buffer to being read withutf8
encoding. Fixes #19344. - Fixed a regression in 9.0.0 where
cy.contains()
attempted to ignore<script>
and<style>
elements found within<body>
. by deleting them from the dom. This behavior was corrected to ignore the elements without deleting them. Fixes #19377. - Cypress will no longer crash when proxying an ill formed request. For example,
if the application under test has a resource of
"http: //localhost/asset.js"
(notice the extraneous space), Cypress will now log a debug message and the asset will fail to load. Fixes #9220. - Correct
Cypress.Command.add()
andCypress.Command.override()
TypeScript types. Fixes #18879, #19095 and #18940.- Custom command implementations typings take into account
prevSubject
variants. - Custom command implementations now allows to NOT return a value.
- Custom command overwrites typings take into account
originalFn
function.
- Custom command implementations typings take into account
- Add types for
Cypress.session.clearAllSavedSessions()
. Fixes #19363.
Dependencies:
- Upgraded
ssri
from6.0.1
to6.0.2
to mitigate ssri vulnerability. Addressed in #19351.
9.1.1​
Released 12/03/2021
Bugfixes:
- Fixed a regression in 9.1.0 where our
built binary didn't contain patches to some dependencies. Addressed in
#19239. This fixed some
issues including:
- Requests containing
~
will no longer be improperly encoded. Fixes #19083, #19084, #19115, #19096, #19178. - A TypeError displaying
data.hasOwnProperty is not a function
will no longer throw in some situations. Fixes #19091. - Empty extra hooks will no longer be sent as data when recording to the Dashboard. Fixes #19087.
- The Runner hanging when baseUrl is set to null to load a local file. Fixes #19105
- Requests containing
- When using the default configuration of
"nodeVersion": "system"
with an installed system node >=17, Cypress will now work properly rather than throw an error incorrectly pointing to the user's plugin file. Fixes #18914. - Shadow DOM elements no longer error as hidden during actionability when the element is covered by its parent shadow root. Fixes #18008.
- When using
.type()
events now correctly propagate out of the shadow DOM. Fixes #17531. - The
this
context is now properly preserved when overwritingcy.clock()
. Fixes #19158.
Dependencies:
- Upgraded
@cypress/request
from2.88.7
to2.88.10
. Addressed in #19099.
9.1.0​
Released 11/22/2021
Features:
- A
CYPRESS
environment variable will be set to true in child processes where Cypress runs user code in Node.js. You can now detect that you're running in Cypress by looking forprocess.env.CYPRESS
. Addresses #18805.
Bugfixes:
- Specs with % in the filename will no longer fail to load and now behave as any other spec. Fixes #18871.
- When using the Selector Playground, the HTML attribute's value will be wrapped in double-quotes. Fixes #1884.
- The call count is now shown in the Command Log when using
cy.stub().log(false)
. Fixes #18907. - The warning message for retrying connection to a browser has been improved to indicate when it is still waiting. Fixes #18644.
- Cypress commands that rely on
this
context now have access tothis
when overridden. Fixes #18899. - Test configuration is now correctly applied when using
only
. Fixes #18959.
9.0.0​
Released 11/10/2021
Breaking Changes:
- The
nodeVersion
configuration option now defaults tosystem
. The behavior of thesystem
option has changed to always use the Node.js binary/version that launched Cypress. If Cypress was not launched via the terminal, Cypress will use thebundled
Node.js version. This could change the behavior of code within yourpluginsFile
since it may be run in yoursystem
Node.js version. Addresses #18684. - Windows 32-bit is no longer supported in Cypress. Addresses #17962.
- An error will now be thrown if an invalid value is passed to
Cypress.config
. Previously invalid values were ignored and could cause unexpected behavior. Addresses #18589. cy.contains()
no longer yields the<body>
element when it matches the content of<script>
or<style>
tags. Addresses #14861.- Attempting to add an existing built-in Cypress command using
Cypress.Commands.add()
will now throw an error, indicating thatCypress.Commands.overwrite()
should be used instead to overwrite the behavior of existing commands. Addresses #18572. - Custom command implementations are now typed based on the declared custom chainables. Addresses #17496.
- The bundled Node.js version was upgraded from
14.17.0
to16.5.0
. This could change the behavior of code within thepluginsFile
when using the bundled Node.js version of Cypress. Addressed in #18317. - The default read behavior of a fixture provided as a static response in
cy.intercept()
changed from being read as a Buffer to usingutf8
encoding. This aligns the default read behavior ofcy.intercept()
tocy.readFile()
andcy.fixture()
. Addresses #18534.
Deprecations:
- The
nodeVersion
configuration option has been deprecated and will be removed in a future release.
Features:
- When
null
is passed as the encoding tocy.readFile()
orcy.fixture()
, the file is treated as binary and read as a Buffer. Similarly,null
passed as the encoding tocy.writeFile()
allows direct writing of buffers. If the encoding is unspecified, the default remainsutf8
, matching the current behavior. Addresses #18534.
Bugfixes:
- Sticky elements within a fixed container will now be able to be properly scrolled to during action commands. Fixes #4233.
document.referrer
will now correctly reflect the correct value from the application under test aftercy.visit()
. Fixes #4295.
Dependencies:
- Upgraded Chrome browser version used during
cypress run
and when selecting Electron browser incypress open
from91
to94
. Addressed in #15292. - Upgraded bundled Node.js version from
14.17.0
to16.5.0
. Addressed in #15292. - Upgraded
electron
from14.1.0
to15.2.0
. Addressed in #15292.
8.7.0​
Released 10/25/2021
Features:
- There are changes to how "slow" tests are determined and displayed in Cypress.
Addresses #18496.
- Added a
slowTestThreshold
configuration option to customize when tests are considered "slow" duringcypress run
. A test that runs slower than the given threshold will display in orange text in the default 'spec' reporter. This configuration can be set in your Cypress config file or via specific test configuration. - The default slow test threshold was changed from 75ms (Mocha's default) to
10000ms for e2e tests and 250ms for component tests. To restore the old
behavior, you can add
"slowTestThreshold": 75
to your Cypress config file. - All tests will show the time the test ran in milliseconds during
cypress run
with the default 'spec' reporter.
- Added a
- Users can pass an
overwrite: true
option toCypress.Screenshot.defaults
to change default behavior to overwrite existing screenshots without having to setoverwrite
for eachcy.screenshot()
command. Addresses #7955.
Bugfixes:
- Fixed a regression introduced in 8.6.0 where videos recorded in Electron to the Dashboard were not playable in the Firefox or Safari browser and were not compatible with QuickTime player in MacOS.
- Fixed a regression introduced in 8.6.0 so that the warning about the
projectRoot
directory not being writeable will now display correctly. Fixes #18485. - Improved the error message when running Cypress without non-root permissions. Fixes #18445.
- An error now throws when invalid options are passed to the
selectorPriority
configuration option ofCypress.SelectorPlayground.defaults
. Valid values aredata-*
,id
,class
,tag
,attribute
, ornth-child
. Fixes #7745.
Dependency Updates:
- Pinned resolution of
ua-parser-js
to0.7.24
to avoid dependency resolution to the compromised package versions. Please read the security advisory and take actions advised as soon as possible. Addressed in #18611
8.6.0​
Released 10/11/2021
Features:
cy.screenshot()
now acceptsoverwrite: true
as an option to overwrite existing screenshots with the same file name. Addresses #7955.cy.select([])
can now be used to clear any selected options in a multi-value select. Addresses #4318.- Using
cy.pause()
when usingcypress run --headed --no-exit
will now pause a test. Addresses #4044.
Bugfixes:
- Fixed a regression introduced in 8.2.0 where certain XMLHttpRequests would not display their response bodies in the DevTools Console when clicked. Fixes #17656.
- Fixed a regression in 8.3.0 where capturing videos in Chrome versions earlier than 89 would result in choppy videos and skipped frames. Fixes #18021.
- Cypress displays the correct error when certain custom error types are thrown within a test. Fixes #18259.
- The Cypress App will no longer crash when passed a
--spec: {}
from the CLI and instead error when passed an invalid object argument. Fixes #3957. - Logging a plain object no longer results in the error "Cannot convert object to primitive value". Fixes #18143.
Misc:
- Updated the
cy.request()
error message when conflictingfailOnStatusCode
andretryOnStatusCodeFailure
options are passed to be clearer. Fixes #18271.
Dependency Updates:
- Upgraded the Chromium browser version used during
cypress run
and when selecting Electron browser incypress open
from91.0.4472.164
to93.0.4577.58
. - Upgraded
electron
from13.2.0
to14.1.0
. Addressed in #18318 and #18384.
8.5.0​
Released 09/27/2021
Features:
- You can now select an option by index within the
.select()
command. Addresses #757. - Cypress now captures the repository URL on Drone CI. Addresses #18210.
Bugfixes:
- The download of Cypress now respects the
NO_PROXY
environment variable when one is set. Fixes #17702. - When using a custom config file and setting it up to record to the Dashboard,
Cypress now writes the
projectId
in the custom config file instead ofcypress.json
. Fixes #5747.
Misc:
- Windows 32-bit has been deprecated and support will be removed in a later release. A deprecation warning will now display when using Cypress in a Windows 32-bit OS. See #17962 for more detail. Addresses #18094.
- Improved the error messages when an invalid argument type is passed to the
.select()
command. Addressed in #18234.
8.4.1​
Released 09/17/2021
Bugfixes:
- Cypress will no longer crash when setting up a project to record to the Dashboard or viewing the runs or record key for a previously set up project. Fixes #18129.
- The branch collected for Drone CI now correctly reflects the source PR branch for showing in the Cypress Dashboard. Fixes #17860.
8.4.0​
Released 09/13/2021
Features:
- When the URL contains non-ASCII characters, you can use the new
decode
option ofcy.url()
to decode it. Addresses #17399.
Bugfixes:
- Cypress now better handles situations where the extension was installed in a read-only location. Fixes #3852.
- A clearer error message is now thrown for
.check()
or.uncheck()
when there are no matching value attributes found. Fixes#7379. - Hooks will no longer rerun on unrelated tests in some situations after a domain navigation. Fixes #17705.
clientCertificate
types have been added for the Cypress configuration. Fixes #17799.
8.3.1​
Released 08/27/2021
Performance:
- Projects will now open much faster on MacOS Big Sur with improved browser detection performance. Fixes #17773.
Bugfixes:
- Fixed a regression in 8.3.0 where the
correct exit code would not be issued during
cypress run-ct
while running in the Electron browser. Fixes #17752 and #17885. - Fixed a regression in 8.3.0 where
Cypress would cause a
SIGSEGV
error on Mac when closing the Cypress app opened viacypress open
. Fixes #17766. - The
beforeinput
event now correctly fires in Firefox during keyboard events. Fixes #17583.
Misc:
cy.document()
typings now allow for thetimeout
option. Fixes #17695.cy.title()
typings now allow for thetimeout
option. Fixes #17781
Dependency Updates:
- Upgraded
electron
from13.1.7
to13.2.0
. Addressed in #17772. - Upgraded
@cypress/request
from2.88.5
to2.88.6
. Addresses #17622.
8.3.0​
Released 08/16/2021
Features:
- The instructions for recording a run have been updated for some users. Addressed in #17317.
Performance:
- We addressed an issue that increased CPU usage during video recording in Chrome 89+/Electron 12+. Fixes #16152.
- Fixed a regression in 7.2.0 that would
cause
cy.visit()
to take longer to fire its load event in some circumstances. Fixes #16671.
Bugfixes:
- Fixed an issue that could cause intermittent OpenSSL errors when the local CA cert cache becomes corrupted. Fixes #8705.
- Fixed a regression in 7.2.0 causing the menu bar of Cypress to not be clickable in Windows. Fixes #16323.
res.send
ofcy.intercept()
will no longer override JSON-related content types. Fixes #17084.- The
times
option ofcy.intercept
now works properly withreq.reply
. Fixes #17139. - Fixed a regression in 8.0.0 where
Cypress would always warn that
chromeWebSecurity
is set to "false" when it wasn't. Fixes #17614.
Dependency Updates:
- Upgraded Chrome browser version used during
cypress run
and when selecting Electron browser incypress open
from89
to91
. Addressed in #17408. - Upgraded bundled Node.js version from
14.6.0
to14.17.0
. Addressed in #17408. - Upgraded
electron
from12.0.0-beta.14
to13.1.7
. Addressed in #17408. - Upgraded
url-parse
from1.5.1
to1.5.2
. Addressed in #17719.
8.2.0​
Released 08/04/2021
Features:
- You can now cache and restore cookies,
localStorage
, andsessionStorage
in order to reduce test setup times by usingcy.session()
. Thesession
API is experimental and can be enabled by setting theexperimentalSessionSupport
flag totrue
in your Cypress config. See our blog and thecy.session()
doc for more detail. - The logging experience around HTTP requests has been updated.
fetch
requests are always displayed in the Command Log, regardless of ifexperimentalFetchSupport
is enabled.- Duplicate logs for XHRs, fetches, and
cy.intercept()
have been consolidated - Fixes #14843. - The user experience around the information displayed in the console when
clicking on
cy.intercept()
request logs has been improved. - Request logs now indicate if a request has gone to the origin or if it has been stubbed by displaying a filled or empty circle in the request log.
- Request logs now display information about if the request and/or response
was modified by a
cy.intercept()
. - The tooltip displayed when mousing over a request log now displays
information about the matched
cy.intercept()
/cy.route()
rules. - Fixed an issue where pending request logs were not ended between tests. Fixes #14655.
- There's now a
Cypress.currentTest
property to access name the currently executing test viaCypress.currentTest.title
andCypress.currentTest.titlePath
. Addresses #2972.
Bugfixes:
- A "removing cookie failed" error will no longer throw when cookies are cleared in Firefox. Fixes #6375.
- Cypress no longer throws the error "cannot read property split of undefined" in certain circumstances when application errors are thrown. Fixes #17378.
- Cypress now properly runs the final test when nested in a suite with a
before
hook. Fixes #9026. - Fixed a regression in 8.0.0 where an
error would longer throw when there is no
/etc/passwd
entry for the current user, such as in some Docker and GitHub Action setups. Fixes #17415. - Cypress now throws if a function is incorrectly passed as the second argument
to
cy.wait()
. Fixes #17436.
8.1.0​
Released 07/29/2021
Features:
- When using
experimentalStudio
, you can now generate assertions in Cypress Studio by right clicking on an element. Addressed in #16295. - When searching specs in the Test Runner during end-to-end testing, characters that are not letters will be ignored and don't have to be typed. Addressed in #17346.
Performance:
- The Test Runner's performance has been improved when running a large number of commands within a single test. Fixes #6783.
Bugfixes:
- Add Yarn v2 pnp support to our default webpack processor. Fixes #8008 and #16111.
- When running Cypress in global mode, an error will no longer be thrown when trying to add a new project to the Dashboard. Addressed in #17514.
- The Test Runner will no longer crash in some instances when creating a new spec file from the GUI. #17430.
8.0.0​
Released 07/19/2021
Summary:
We've made some updates to ensure a consistent run experience across browsers.
Now all browsers run via cypress run
run headlessly, with a device pixel ratio
of 1, and a screen size of 1280x720 by default.
Breaking Changes:
Please read our Migration Guide which explains the changes in more detail and how to change your code to migrate to Cypress 8.0.**
- When running
cypress run
previous to 8.0, some browsers would launch headed while others were launched headless by default. Cypress now runs all browsers duringcypress run
as headless by default. Addresses #16832. - The default screen size when running a headless browser has been reverted back to 1280x720 pixels (pre 7.0 behavior). Addresses #16853.
- When running the
--headless
Chrome browser viacypress run
, the device pixel ratio will now be 1 by default, matching the behavior of all other browsers. This behavior can be overridden through the browser launch API. Addresses #17375. - Cypress now enforces version checks for browser launching and will error
during
cypress run
and not allow opening the browser incypress open
when attempting to open unsupported browser versions. Cypress supports Chrome >= 64, Firefox >= 86, and Edge >= 79. Addressed in #17355. - Arguments returned from a chained function will no longer incorrectly be of
type
jQuery
and instead have anany
type. Fixes #16669. - The
Cypress.ConfigOptions
,Cypress.ResolvedConfigOptions
andCypress.RuntimeConfigOption
types have been updated so thatConfigOptions
match the JSON schema. Addressed in #17251.
Features:
- You can now configure certificate authority (CA) and client certificates to
use within tests on a per-URL basis via a
clientCertificates
configuration option. See Client certificates for more detail. - Setting the environment variable
ELECTRON_RUN_AS_NODE
now starts Cypress as a normal Node.js process rather than an Electron process. Addresses #16505.
Bugfixes:
console.log
andconsole.error
called within the plugins file will now be captured in thestdout
sent to the Cypress Dashboard, making it visible in Output logs in the Dashboard. Fixes #7434.- There are several fixes for
cy.intercept()
including: - When using the experimental Cypress Studio, there should be a reduced occurrence of "Studio failed to save commands" error messages. Fixes #14767.
cy.invoke()
now retains the properthis
context on nested object methods. Fixes #3871.- We no longer trigger unnecessary snapshot re-renders when hovering over the Command Log. Fixes #17257.
7.7.0​
Released 07/07/2021
Features:
- When using
experimentalStudio
, Cypress Studio can now copy all commands generated to your clipboard. Addressed in #16912.
Bugfixes:
- Cypress now respects
preventScroll
options passed toelement.focus()
calls within the application under test. Fixes #15294. - Using
.contains(0)
will now show the zero in the Command Log. Fixes #1119. - Cypress will no longer show a warning about allowed keys for the
showedOnBoardingModal
when runningcypress open
. Fixes #17095. - The Cypress Studio introduction modal will now display with the correct styling. Fixes #17102.
- The types for
.contains()
now correctly allow for theincludeShadowDom
option. Fixes #17066.
Misc:
- We updated the messaging when Cypress fails to start to be clearer that it's not always due to a dependency missing. Addresses #17112.
7.6.0​
Released 06/23/2021
Features:
- You can now override the default delay between typing characters for
.type()
withCypress.Keyboard.defaults()
or via test configuration. Addresses #566. - The experience when opening a new project via
cypress open
has been improved. Addressed in #15826.- The scaffolded example files have been updated to include examples tests of the TodoMVC project.
- You can now easily delete all of the scaffolded example files directly from the Test Runner GUI.
- There's now a button to create a new spec file when no spec files are found in the project.
- A new onboarding banner with be present with helpful links for new users and new projects.
- The incoming request object yielded to request handler functions passed to
cy.intercept()
(req
) now has areq.query
property, which is a getter/setter for the query parameters on the request URL. Addresses #16327. - You can now pass an
ArrayBuffer
as a request / response body withcy.intercept()
. Addresses #16722
Bugfixes:
- Cypress no longer hangs intermittently when using webpack 5. Fixes #15447.
- It is no longer necessary to return the config from the plugins function when
using the
dev-server:start
event for component testing. Fixes #16860. cy.intercept()
now correctly sets the response body as a string instead of an ArrayBuffer when it contains multi-byte characters. Fixes #16292.cy.intercept()
won't corrupt certain binary responses. Fixes #16722.- On Windows, the Cypress executable is now code signed by "Cypress.io, Inc.".
This fixes
spawn UNKNOWN
errors when launching Cypress with code signing required by policy on Windows. Fixes #2543 - We now warn on
EPERM
errors when accessing the project directory instead of erroring. Fixes #16933. - Cypress now better handles running when browsers with unconventional versions are present on the machine. Fixes #15485.
- Expanded the types for
CyHttpMessages.BaseMessage.headers
to support the value being an array of strings. Fixes #16734.
Dependency Updates:
- Added
enquirer
dependency. Fixes #16846.
7.5.0​
Released 06/07/2021
Features:
- The Test Runner has a new 'Docs' menu with links and prompts specific to helping you get started writing tests, set up in CI, and running tests in the Dashboard. Addressed in #16433.
cy.request()
now accepts a generic in TypeScript for specifying the type of the request body. Addresses #9109.
Bugfixes:
- Cypress will not longer crash with a
hasBinary
infinite recursive call. Fixes #16476. - The
--config-file
option now correctly handles absolute paths. Fixes #6136. cy.location(<key>)
will now retry if the remote location returns an empty string, which is possible during otherwise harmless redirects. Fixes #16463.- Cypress now passes a flag to Chrome browsers to prevent update notifications from displaying in some cases. Fixes #16693.
- TypeScript will now properly error when attempting to use the chai
<value>.should()
syntax. Fixes #16548.
Dependency Updates:
- Replaced deprecated
listr
withlistr2
. Addressed in #16663.
7.4.0​
Released 05/24/2021
Features:
- Cypress now detects and supports testing in the Chrome Beta browser. Addresses #16376.
- There are new keyboard shortcuts to continue (c) and to go to the next test
(n) when the Test Runner is paused via
.pause()
and to toggle auto-scrolling of the Test Runner (a). Addresses #248.
Bugfixes:
cy.request()
can now send binary files in form data. Fixes #1647.cy.request()
can now send blob data. Fixes #6178.- Fixed an issue where
cy.wait()
could yield the incorrect result when used withcy.intercept()
and several simultaneous requests. Fixes #16451. - Improved the way that
cy.intercept()
matchers are displayed in the Command Log when usingRouteMatcher
properties besidesurl
andmethod
. Fixes #9403. cy.intercept()
argument validation has been improved. Invalid hostnames and extra arguments passed tocy.intercept()
now result in an error. Addressed in #16577.cy.screenshot()
no longer incorrectly captures parts of the Test Runner UI during component testing. Fixes #16543.- Spec files that containing spaces in the path will now properly open during
cypress open-ct
. Fixes #16278. - Cypress now correctly uses the
componentFolder
andtestFiles
values from returned from plugins in the component testing runner. Fixes #16424. - Video recordings in Chrome, Chromium, and Electron browsers will no longer drop frames, with the frequency increasing along with the length of the video. Fixes #16648.
- Tests located outside of the
projectRoot
will now open in IDE and generate studio commands when saved. Fixes #16255. config
in the plugins file will now display in alphabetical order. Fixes #16564.
Dependency Updates:
- Upgraded
dependency-tree
from7.0.2
to8.1.0
. Addressed in #16464. - Upgraded
extract-zip
from1.7.0
to2.0.1
. Fixes #6896
7.3.0​
Released 05/10/2021
Features:
- Component tests can now be launched via the
Module API by passing
testingType: 'component'
via the newtestingType
property. ThetestingType
will default toe2e
. Addresses #16302. cy.intercept()
now accepts atimes
option in theRouteMatcher
.times
will specify the number of times that a particularcy.intercept()
should be applied. Addresses #4460 and #8531.cy.intercept()
now accepts invocation usingcy.intercept(url, routeMatcher, handler)
, whereurl
is a regular expression. Previously, this only worked ifurl
was a string. Addresses #16390.- Cypress will now automatically get environment variables for LayerCI when recording to the Dashboard. Addresses #16101.
- Setting the env var
DEBUG=cypress:server:record:ci-info
will print commit information and CI provider information that's sent to the Dashboard as debug logs. Addresses #16236. - Cypress can now use the certificate authority specified in npm config if
CYPRESS_DOWNLOAD_USE_CA
is specified. See "Using a custom CA" for more information. Addresses #8825.
Bugfixes:
- Cypress will no longer incorrectly redirect the AUT window to
/__/
whenlocation.href
is set to a relative path within the call stack of an XHR event handler. Fixes #3975 and #7439. - Cypress now properly handles when a form submit or anchor tag target is set to
_top
or_parent
so that it no longer redirects the parent frame. Fixes #1244. - Fixed a regression in 6.5.0 that could
cause Cypress to crash with a
RangeError: Maximum call stack size exceeded at _deconstructPacket
error. Most commonly, this occurred when handling network errors withcy.request()
. Fixes #15101. - Fixed a regression in 7.0.0 that caused
the Test Runner to crash with an
ERR_INVALID_ARG_TYPE
type error when testing a binary file upload. Fixes #15898 and #16223. - When verifying Cypress, we now listen for the 'close' event instead of the 'exit' event in an effort to fix some situations where the browser cannot be found even though it is on the system. Addressed in #16312.
- Fixed a regression in 6.5.0 that caused
a node warning about
.then()
only accepting functions to display. Fixes #15281. cy.intercept()
now adds aaccess-control-expose-headers: '*'
header by default for CORS requests unless overridden. Fixes #15050.- Improved the way that
cy.intercept()
andcy.route()
requests with multiple aliases are displayed in the command log. Addressed in #16382. - Cypress now correctly shows all
.should('contain')
assertions when chained after.should('be.visible')
. Fixes #16006. Cypress.cookies.debug(true)
will now correctly show cookie-related messages on the console. Fixes #15032.cy.log()
will now show all arguments, not only the first 2. Fixes #16068..select()
now correctly selects option elements with values that have
characters. Fixes #16045.- The
e2e
andcomponent
configuration values will now correctly show when previewing resolved configuration in the Test Runner. Fixes #16282. - When passing the
—quiet
flag, Cypress will no longer print uploading output to Stdout. Fixes #16268. - When pressing the
/
hotkey in Firefox, Cypress will select the SpecList's SearchInput as it does in other browsers. Fixes #16309. - Cypress will now detect the default installation location of the Visual Studio Code editors on Windows machines. Fixes #15080.
- Changing files extensions when creating a new test file should no longer add extra dots to the filename on Windows machines. Fixes #16131.
Dependency Updates:
- Upgraded
classnames
from2.2.6
to2.3.1
. Addressed in #8337. - Upgraded
color-string
from1.5.4
to1.5.5
. Addressed in #16362. - Upgraded
lodash
from4.17.19
to4.17.21
. Addressed in #16406. - Upgraded
registry-js
from1.13.0
to1.15.0
. Addressed in #16409. - Upgraded
url-parse
from1.4.7
to1.5.0
. Addressed in #16408.
7.2.0​
Released 04/26/2021
Features:
- You can now navigate through folders in the Test Runner using the Tab keyboard input and open or close the folder's content with the Enter & Space keyboard inputs. Addresses #3741.
Performance:
- Fixed a regression in 7.0.0 that caused tests to run slowly, especially when run with constrained CPU resources. Fixes #15853.
- Fixed a regression in 7.0.0 causing decreased performance in Chromium browsers due to requesting screencast frames when video is disabled. Fixes #16030.
Bugfixes:
- Fixed a regression in 7.0.0 that caused
the Test Runner to crash with an
ERR_INVALID_ARG_TYPE
type error. We now correctly detect a utf8 request body with multi-byte Unicode characters. Fixes #15901. - Reusing
cy.intercept()
aliases will now work as expected. Fixes #15823. - Fixed an issue in 7.0 where users could get a misleading "must pass a handler
as the 3rd argument" error when using
cy.intercept
. Fixes #16117. cypress run-ct
no longer hangs on Windows machines. Fixes #15976.- Hovering over a command log without a snapshot will no longer cause the error
Cannot read property 'name' of null
. Fixes #15816. - We now throw an error when attempting to
.select()
an<option>
within a disabled<fieldset>
. Fixes #5951. .type()
will no longer change thevalue
attribute of button-like inputs with type button, submit, reset, image, radio, or checkbox. Fixes #15913.- Specs will now load when using a relative directory for
componentFolder
outside of the root project when specifying--project
. Fixes #16053. - The search input will now display when there are many component spec files. Fixes #16089.
Misc:
- Lodash types have been updated. Addressed in #15860.
- Types for the selector playground have been added. Addressed in #15834.
Cypress.Cookies.defaults()
now returns the correct type instead ofvoid
. Addresses #15426..then()
will show the correct type when a collection of HTMLElements is provided. Addressed in #15869.- Improved types for
cy.intercept()
. Addressed in #16167.
Dependency Updates:
- Downgraded the Chromium browser version used during
cypress run
and when selecting Electron browser incypress open
from89.0.4348.1
to89.0.4328.0
. This was done to address a performance regression introduced in 7.0.0. Addressed in #16113. - Upgraded
systeminformation
from5.3.1
to5.6.4
. Addressed in #15819. - Replaced
lolex
with@sinonjs/fake-timers
. Addressed in #15595.
7.1.0​
Released 04/12/2021
Features:
- The events
before:spec
,after:spec
,before:run
, andafter:run
now fire in interactive mode in addition to run mode. This requires theexperimentalInteractiveRunEvents
flag to be enabled. Addressed in #15787.
Bugfixes:
- Viewport configuration set in
cypress.json
is now correctly applied in the Component Test Runner. Fixes #15899. - Running specs on Windows is now supported in the Component Test Runner. Fixes #15842.
- Fixed an issue where crashes in Cypress would cause a misleading "Unknown signal: true" error after the actual crash message. Fixes #15943.
- Fixed an issue introduced in 7.0.0 where requests with responses stubbed via
cy.intercept(routeMatcher, staticResponse)
would still be sent to the destination server. Fixes #15841.
7.0.1​
Released 04/07/2021
Bugfixes:
- Fixed a regression in 7.0.0 that caused the test runner not to check for updates. Fixes #15829.
- The component testing spec list search input no longer throws an exception
when hitting
Enter
. Addressed in #15833. - The preferred file opener modal no longer appears behind the command log. Addressed in #15831.
- Cypress no longer crashes in certain circumstances when running in Docker
without
--ipc=host
. Fixes #15814 and #350. - Node.js warnings are no longer incorrectly printed to
stderr
in production builds of Cypress. Addressed in #15817. - Cypress no longer prints a warning to
stdout
when the video cannot be found after a run. Addressed in #15828. - A warning is no longer displayed when running a TypeScript spec without a
tsconfig.json
file present. Addressed in #15828.
Misc:
- The "New Spec File" in the Desktop GUI has a less pronounced style. Addressed in #15835.
7.0.0​
Released 04/05/2021
Summary:
🎉 Introducing the Cypress Component Test Runner - now in alpha. Today's release includes a brand new test runner designed to replace your Node-based component tests. Our Component Test Runner tests your components in the browser, just like a user would. And, since it runs in the browser, you get to debug your components using your favorite developer tools. Read our Component Testing Guide for more details.
Breaking Changes:
Please read our Migration Guide which explains the changes in more detail and how to change your code to migrate to Cypress 7.0.**
- We introduced several breaking changes to
cy.intercept(). See the
cy.intercept() docs for full usage examples.
Breaking changes:
- Request handlers supplied to
cy.intercept()
are now matched starting with the most recently defined request interceptor. This allows users to override request handlers by callingcy.intercept()
again. This matches the previous behavior that was default incy.route()
. Addresses #9302. cy.intercept()
now automatically parses more JSON MIME types, including 'application/vnd.api+json'. You can now removeJSON.parse(req.body)
orJSON.parse(res.body)
from some tests that previously required it. Addresses #14763.- Falsy values (with the exception of
undefined
) supplied as the body of aStaticResponse
tocy.intercept()
will now be JSONified and sent as the body. Previously, an empty string was sent instead. Addresses #15234 and #14205. - The
matchUrlAgainstPath
RouteMatcher
property has been removed fromcy.intercept()
. - The "substring match" from
cy.intercept()
URL matching has been removed. Previously, a URL would match if it contained the supplied string anywhere. Now, the URL (including querystring) only matches if it is an equality match or a minimatch. res.delay()
andres.throttle()
have been renamed tores.setDelay()
andres.setThrottle()
, respectively. Addresses #15700.cy.route2()
was previously aliased tocy.intercept()
. Now the aliascy.route2()
has been removed. Please update usage ofcy.route2()
tocy.intercept()
. Addressed in #14709.
- Request handlers supplied to
- Component tests have been migrated to use a dedicated test runner and are
bundled differently. See the
Migration Guide for
full examples on how to migrate. Addressed in
#14479.
- Component tests will not be executed when running
cypress open
orcypress run
. Now, they need to be executed by runningcypress open-ct
orcypress run-ct
. Addressed in #15701. experimentalComponentTesting
must be removed from your configuration file,cypress.json
by default, or it will throw an error. Addressed in #15701.- The
file:preprocessor
event is no longer used to compile component tests. Now, adev-server:start
event must be registered.
- Component tests will not be executed when running
- Cypress now catches uncaught errors and fails the test even if the application
under test has defined
window.onerror
. Addresses #8802. - Cypress now fails tests if there is an unhandled promise rejection in the
application under test. Unhandled rejections will trigger the
uncaught:exception
event with the promise as the third argument. Addresses #243. - Cypress now throws an error if the application under test redirects more than
20 times. The number of times allowed to redirect is configurable via the
redirectionLimit
config. Addresses #14445. - The default preprocessor now targets a more modern version of ECMAScript. Addressed in #15274.
- We now enable
contextIsolation
by default in the Electron browser. You can override this option if needed within thebefore:browser:launch
API. Addressed in #15493. Cypress.moment()
has been removed. Please migrate to a different datetime formatter. See our recipe for example replacements. Addresses #8714.- The bundled Node.js version was upgraded from
12.18.3
to14.16.0
. This could change the behavior of code within thepluginsFile
when using the bundled Node.js version of Cypress. Addressed in #15292. - Installing Cypress on your system now requires Node.js 12+. Addresses #9545.
- The default headless browser window size has been increased to 1920x1080 pixels to capture High-definition videos and screenshots. Addresses #15752, #15730, and #15481.
Features:
- A command log entry is now displayed when there is an uncaught exception or unhandled rejection. Addresses #8236.
- We added several features to cy.intercept(). See
the cy.intercept() docs for full usage examples.
Addressed in #14543. New
features:
- There are new events on the req object for
cy.intercept()
includingbefore:response
,response
, andafter:response
. - Response handlers (supplied via event handlers or via
req.continue(cb)
) supplied tocy.intercept()
will be called in reverse order untilres.send
is called or until there are no more response handlers. - A new option,
middleware
, has been added to theRouteMatcher
type. If true, the supplied request handler will be called before any non-middleware request handlers. - A new function,
req.continue(cb)
, is available on request objects yielded bycy.intercept()
. It is functionally the same asreq.reply(cb)
- the request will stop propagating to other event handlers, will be sent outgoing, and the response will be handled by cb. cy.intercept()
can now be called with a new overload:cy.intercept(url, routeMatcher, handler)
.routeMatcher
will be merged withurl
, and the handler is required.
- There are new events on the req object for
cy.visit()
can now visit pages withapplication/xhtml*
content-type. Addresses #15738.- You can now pass runner specific configuration in order to pass different
configuration values to
component
tests versuse2e
tests. Addressed in #15526. - There's a new keyboard shortcut (
ctrl/cmd + f
) to search spec files in the Test Runner based on your OS. Addresses #6229. - You can now create a new spec file directly from the Test Runner in the Desktop. Addressed in #15335.
cy.tick()
now accepts alog
option. Addresses #15180.- The Cypress proxy now adds a
keep-alive
header to all proxy responses. Addressed in #15292 - Cypress no longer forces specific
NODE_OPTIONS
. Addressed in #15292
Bugfixes:
- The
response.body
ofcy.intercept()
is now correct after stubbing a response usingres.send({ fixture })
in areq.continue
callback or abefore:response
orresponse
handler. Addressed in #14543. - Fixed an issue where only the first matching alias for a route would yield a
response object on
cy.wait()
. Fixes #14522. .click()
will no longer fail with "coordsHistory must be at least 2 sets of coords" when specifying{ multiple: true }
. Fixes #3738.- Cypress now checks visibility correctly when an element has CSS "position: sticky". Fixes #14938.
- After selecting a project in global mode and clicking the back button, Cypress will no longer crash. Fixes #15089.
- Errors
Refused to apply style
are gone from the console inopen-ct
during Component Testing. Addressed in #15661. - Some memory leaks were fixed in
@cypress/vue
. Addressed in #15275.
Misc:
- The types for
set-cookie
allowstring[]
, so the header's type has been changed to reflect this. Addresses #15419. - The type definition for
cy.writeFile()
now allows 4 arguments. Addresses #15353. .then()
will show the correct type when raw HTMLElements are provided. Addresses #14875- The Cypress Studio icon now displays properly for tests with long titles. Addresses #15182.
- There were some minor improvements made to the UI when setting up a project in the Test Runner. Addressed in #15665.
Dependency Updates
- Upgraded Chrome browser version used during
cypress run
and when selecting Electron browser incypress open
from87
to89
. Addressed in #15292. - Upgraded bundled Node.js version from
12.18.3
to14.16.0
. Addressed in #15292. - Upgraded
electron
from11.3.0
to12.0.0
. Addressed in #15292.
6.9.1​
Released 4/5/2021
This release contains the same features as 6.8.0. It was published to provide a non-breaking alternative to 6.9.0, which was mistakenly published with breaking changes.
6.9.0​
Released 4/5/2021
This release was mistakenly published with breaking changes, is deprecated, and should not be used. Upgrade to 6.9.1 or 7.0.0, or stay on 6.8.0.
6.8.0​
Released 3/17/2021
User Experience:
- Improved the specs list user interface with a new icon set and accessibility features when in Component Testing mode (alpha). Addressed in #15513
Bugfixes:
- Cypress will no longer exit with an error when recording a run to the Dashboard with empty specfiles. Fixes #15512.
- When using
experimentalStudio
, Cypress Studio the icon to add commands will now fully display on long test titles. Fixes #15182.
6.7.1​
Released 3/15/2021
Bugfixes:
- Interacting with an element that requires scrolling within an element with
scroll-behavior: smooth
no longer fails Cypress's actionability check. Fixes #15453. - A regression in 6.7.0 has been fixed so that the
projectId
will be written correctly to thecypress.json
file on initial creation without an extra config object. Fixes #15497.
6.7.0​
Released 3/15/2021
Features:
- The
experimentalRunEvents
configuration flag has been removed. You can now listen tobefore:run
,after:run
,before:spec
andafter:spec
events in the plugins file without needing the experimentalRunEvents configuration option. See thebefore:run
,after:run
,before:spec
andafter:spec
docs for more information. Addressed in #15276. - When canceling a run from the Dashboard, previously only parallelized runs would cancel correctly. Now all recorded runs will respect cancelation and exit early. Addresses #1691.
- Test configuration is now captured and sent when recording to the Dashboard. Addresses #15487.
- Cypress now sends test details to the Dashboard at the beginning of a recorded run, so historical test code and other data can be provided to the Dashboard upfront. Addressed in #14925.
- The full stack trace from errors thrown in the preprocessor are now displayed. Addressed in #15198.
- Configuration values which are changed at runtime prior to tests running are now properly shown as resolved from the spec code within the Module API to indicate where the change originated from. Addresses #15486.
Bugfixes:
- FFmpeg will no longer error ("width not divisible by 2") during video recording in Chromium-family browsers, including Chrome, Electron, and Edge. Fixes #3491 and #15300.
- cy.wait() no longer falsely returns a timeout when the user aborts an XHR. Fixes #9549.
- .clear() and
.type('{selectall}{del}')
now behave the same when they're used against elements that contain text inputs. Fixes #8447. - When using
experimentalStudio
, Cypress Studio now records typing by using the value of the input rather than the keys that were pressed. Studio also no longer records pressing special keys (such as arrows or ctrl) except for Enter. Fixes #15023. - Empty jQuery objects are now properly shown in error messages in the Command Log. Fixes #14279.
- Length assertions on DOM elements now properly show the user-defined assertion message if specified. Fixes #14484.
- Cypress no longer scrolls on
mouse down
event, fixes #8279.
Misc:
- We updated the UI when connecting a project to the Dashboard. Addressed in #14877.
- "Test recordings" recorded to the Cypress Dashboard are now referred to as recorded "test results." Addresses #15376.
- Errors shown from the plugins file now display top-aligned. Addressed in #15347.
Dependency Updates:
- Upgraded
electron
from11.2.3
to11.3.0
. Addressed in #15201.
6.6.0​
Released 2/18/2021
Features:
- Cypress now extracts and sends CodeFresh CI default variables when recording to the Dashboard. Addresses #4609
Dependency Updates:
- Upgraded
ramda
to version0.27.1
. Addressed in #14958.
6.5.0​
Released 2/15/2021
Performance:
- Improved the startup time of
cypress open
andcypress run
. Addresses #15075.
Bugfixes:
- Fixed an issue where tests would display as failed if an event (such as an XHR request) failed after the test was already completed. This only affects the display of the test and not what was reported in run mode, so it would not have had an effect on suites running in CI. Addresses #14978.
- Fixed a regression introduced in 6.4.0 that caused Electron to crash when opening outside links in the Command Log. Addresses #14912.
- Fixed an issue where browser paths with double backslashes would not work as expected on Windows. Addresses #14719.
- Fixed Microsoft Edge browser detection when passing a path on Windows. Addresses #14716.
- Fixed an issue where the types for
Cypress.on
did not support chaining. Addresses #14991. - Fixed an issue where, when installing two Cypress instances simultaneously,
the downloaded
.zip
could become corrupted and break the install process. Addresses #4595.
Misc:
- Expanded search bar in desktop GUI to fill the entire width. Addresses #14830.
- Added
autoEnd
to the types forLogConfig
. Addresses #9590. - We collect more variables from Bitbucket pipelines to correctly display the pull request information in the Dashboard. Addresses #15081.
Dependency Updates:
- Upgraded
electron
to version11.2.3
. Addresses #15056.
6.4.0​
Released 2/1/2021
Features:
- There's now a Command Log entry in the Test Runner for when a file is downloaded. Addresses #14749.
Deprecations:
- The
delayMs
option for cy.intercept() has been renamed todelay
.delayMs
will still work, but it is deprecated and will be removed in a future release. Addresses #14822.
Bugfixes:
- Fixed an issue causing a webpack compilation error when a
browserslist
is present in project root. Addresses #8864. - 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.
- We now better handle spec paths containing special characters so they properly show in the code frame and work when interacting via your IDE. Addresses #14659.
- We addressed several issues with the experimental
Cypress Studio. To enable the Cypress
Studio you can set
experimentalStudio
totrue
in your Cypress configuration. Issues addressed:- Cypress Studio now prompts to start adding commands after visiting an inputted url. Addresses #14688.
- Empty
.type()
commands will no longer be generated when tabbing through inputs. Addresses #14684. - Cypress Studio no longer prompt to enter a URL if the test is in an errored state. Addresses #14686.
- Cypress Studio now reloads tests when
watchForFileChanges
isfalse
. Addresses #14744. - An empty
.click()
command will no longer be added before.type()
in Cypress Studio when it is followed by typed characters. Addresses #14685. - Cypress Studio will now use the correct selector for an element even if the click event changed the selectors. Addresses #14658.
- Multi-select
selects
are now supported in Cypress Studio. Addresses #14743. - There's an improved UI for command failures within Cypress Studio. Addresses #14691.
- The Selector Playground is now closed automatically when Cypress Studio is opened. #14689.
Misc:
- The "no specs found" error now displays which directory it searched for specs. Addresses #14532.
- More types for the resolved config property have been added. Addresses #14392.
Dependency Updates:
- Upgraded
@cypress/get-windows-proxy
to version1.6.2
. Addressed in #14711. - Upgraded
electron
to version11.2.1
. Addressed in #14764. - Upgraded
recast
to version0.20.4
. Addressed in #14623. - Upgraded
registry-js
to version1.13.0
. Addressed in #14668. - Upgraded
semantic-release
to version17.2.3
. Addressed in #14713. - Upgraded
systeminformation
to version4.31.1
. Addressed in #14715.
6.3.0​
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. ThedownloadsFolder
will be deleted before each run unless trashAssetsBeforeRuns is set tofalse
. 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 tofalse
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.
- You can now open the actively running spec file in your IDE. Addressed in #14521.
Dependency Updates:
- Replaced deprecated
node-sass
withsass
. Addressed in #14415. - Upgraded
debug
from4.1.1
to4.3.1
. Addressed in #14583. - Upgraded
electron
from11.0.3
to11.2.0
. Addressed in #14567. - Upgraded
electron-builder
from22.8.0
to22.9.1
. Addressed in #14493. - Upgraded
shell-env
from3.0.0
to3.0.1
. Addressed in #14622. - Upgraded
uuid
from8.2.0
to8.3.2
. Addressed in #14170.
6.2.1​
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 preventUnexpected 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
andcalledOnceWithExactly
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
from0.0.734984
to0.0.839267
. Addressed in #14353. - Upgraded
electron
from11.0.3
to11.1.1
. Addressed in #14352.
6.2.0​
Released 12/21/2020
Features:
- You can now listen to
before:run
,after:run
,before:spec
andafter:spec
events in the plugins file when setting the experimentalRunEvents configuration option totrue
. See thebefore:run
,after:run
,before:spec
andafter:spec
docs for more information. Addressed in #9646, #14178 #14238 and #14263. - The
Timed out retrying
error message now displays the amount of time Cypress retried. Addresses #5781. - The RouteMatcher argument for cy.intercept() has a
new
matchUrlAgainstPath
property. When set totrue
, Cypress will match the suppliedurl
against incomingpath
s. Addressed in #14241.
Bugfixes:
- Passing a URL as a string or RegExp to
cy.intercept() will automatically set
matchUrlAgainstPath
totrue
. This means that the supplied string or RegExp will be matched against the path if matching against the URL fails. Fixes #9379 and #14256. - 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 thefile:preprocessor
event now includes theEventEmitter
type. Addresses #9276.
Dependency Updates:
- Upgraded
electron
from11.0.2
to11.0.3
. Addressed in #9409.
6.1.0​
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'
, andfalse
, with'top'
being the default.scrollBehavior: false
disables scrolling altogether.scrollBehavior
can be specified in global configuration, test configuration or individual action commands viaoptions
. 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
andAccess-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(). Fixes #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 parameters. Fixes #9360. - Fixed the regression in
Cypress.dom.isVisible
behavior for elements withposition: 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
andanimationDistanceThreshold
types are now included for all actionable commands. Addresses #8854.
Dependency Updates:
- Upgraded
mocha-junit-reporter
from1.23.1
to2.0.0
. Addressed in #9528.
6.0.1​
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 settingsourceMap
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.
6.0.0​
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. See our guide on
Migrating cy.route()
to cy.intercept()
.
Breaking Changes:
Please read our Migration Guide which explains the changes in more detail and how to change your code to migrate to Cypress 6.0.**
- Cypress now always throws an error when asserting on an element that doesn't
exist in the DOM (unless you're asserting that the element should
not.exist
). Assertions such asnot.visible
,not.contains
,not.have.class
, etc will now fail when used on non-existent DOM elements. Addresses #205. - DOM elements where the CSS style (or ancestors) are
opacity: 0
are no longer considered visible. However these are still considered actionable and any action commands used to interact with the element will perform the action. This matches browser's implementation on how they regard elements withopacity: 0
. Addresses #4474. - The type yielded by cy.wait(alias) has changed in order to support use 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()
andcy.route()
have been deprecated. In a future release, support forcy.server()
andcy.route()
will be removed. We encourage you to use cy.intercept() instead. See our guide on Migratingcy.route()
tocy.intercept()
. 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 ofcy.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 yourplugins
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
forcy.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 changedredirectedToUrl
optional for Response types. Addresses #9275.
Dependency Updates
- Upgraded Chrome browser version used during
cypress run
and when selecting Electron browser incypress open
from85
to87
. Addressed in #9222. - Upgraded bundled Node.js version from
12.16.3
to12.18.3
. Addressed in #9222. - Upgraded
electron
from10.1.5
to11.0.2
. Addressed in #9222.
5.6.0​
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
oftext-html
followed by parameters (liketext/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 usingcy.route2()
. Fixes #8926. - Awaiting a request body when providing a static response stub in
cy.route2()
should now work properly. Addressed in #9059. - The way that intercepted
cy.route2()
requests are displayed in the Command Log has been improved, including showing the progress bar correctly. Addresses #9053. - The
Cannot read property 'replace' of 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 tocy.route()
, JSON fixtures containing only a number or boolean will no longer throw an error. Fixes #4899. - Fixed an issue causing failed subresource integrity checks for external scripts. Fixes #8983, #9049, and #8992.
Misc:
- Typings for .invoke() and .its()
now allow for 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
from6.3.0
to7.3.2
. Addressed in #9068. - Upgraded
systeminformation
from4.26.9
to4.27.11
. Addressed in #8979. - Removed
node-webkit-updater
. This should remove some security warnings that were shown during install. Addresses #8314.
5.5.0​
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 thebeforeinput
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.
- This fixed an issue with
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 astatus
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
oropenMode
toretries
alone. Addresses #8869.
Dependency Updates:
- Upgraded
electron
from10.1.3
to10.1.5
. Addressed in #8927 and #8975.- This addresses a Chrome security issue, CVE-2020-15999. Addresses #8922.
- Upgraded
color-string
from1.5.3
to1.5.4
. Addressed in #8945. - Upgraded
pretty-bytes
from^5.3.0
to^5.4.1
. Addressed in #8964.
5.4.0​
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, likecypress open --browser C:/User/App/browser.exe:chrome
, to help detect the browser type. Addresses #6389. - cy.viewport() has new
iphone-7
,iphone-8
, andiphone-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 duringcypress open
orcypress 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 whenbaseUrl
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. - The
request.body
is now available when using cy.wait() on an aliasedcy.route2()
route which had not been intercepted. Fixes #8695. - 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 incypress open
from83
to85
. Addressed in #8406. - Upgraded bundled Node.js version from
12.14.1
to12.16.3
. Addressed in #8406. - Upgraded
electron
from9.2.1
to10.1.3
. Addressed in #8406. - Upgraded
firefox-profile
from2.0.0
to4.0.0
. Addressed in #8786. - Upgraded
node-forge
from0.9.0
to0.10.0
. Addressed in #8800.
5.3.0​
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.
- Versions of Firefox older than 80 can still be used, but will be subject to
the
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 acy.route2()
alias would not always have aresponse
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 receivenull
as the first argument instead ofundefined
. 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 forContent-Security-Policy
. Addresses #7936. - Added a
status
property toCypressRunResult
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.
5.2.0​
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 withcy.route2()
, allowing redirects to be followed before continuing to response interception. Addresses #7967. - Added the capability to specify
delayMs
andthrottleKbps
when stubbing static responses withcy.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 errorroot.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 acontenteditable
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 aKeyboardEvent
event instead of anEvent
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()
, addingPromise
to the list of allowed return types. Addresses #7807.
5.1.0​
Released 9/1/2020
Features:
- Introducing experimental full network stubbing support 🎉.
- With
experimentalNetworkStubbing
enabled, thecy.route2
command is available. Addressed in #4176. - By using
cy.route2()
, your tests can intercept, modify, and wait on any type of HTTP request originating from your app, includingXMLHttpRequest
s,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.
- With
cy.trigger()
now accepts aneventConstructor
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
toTestOptions
types. Addresses #8405. - Added types for
specType
field onCypress.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 theview
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 version0.6.2
. Addresses #8387. - Updated dependency
command-exists
to version1.2.9
. Addresses #8388. - Updated dependency
electron
to version9.2.1
. Addresses #8436.
5.0.0​
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 topreserve
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 toignore
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
, anddataURLToBlob
have changed fromPromise<Blob>
toBlob
. Addresses #6001. - Cypress no longer supports file paths with a question mark
?
or exclamation mark!
in them. We now use the webpack preprocessor by default and it does not support files with question marks or exclamation marks. Addressed in #7982. - For TypeScript compilation of spec, support, and plugins files, the
esModuleInterop
option is no longer coerced totrue
. If you need to utilizeesModuleInterop
, set it in yourtsconfig.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
, andshiftKey
to hold down key combinations while clicking. Addresses #486. - You can now chain
.snapshot()
off ofcy.stub()
andcy.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 duringcypress run
on Firefox versions >= 75. Fixes #6813. - The error
Maximum call stack size exceeded
will no longer throw when callingscrollIntoView
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
orbeforeEach
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 theafterEach
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
to83
. Addressed in #7791. - Upgraded bundled Node.js version from
12.8.1
to12.14.1
. Addressed in #7791. - Upgraded
chalk
from2.4.2
to4.1.0
. Addressed in #7650. - Upgraded
cli-table3
from0.5.1
to0.6.0
. Addressed in #7650. - Upgraded
electron
from8.3.1
to9.2.0
. Addressed in #7791 and #8235. - Upgraded
execa
from1.0.0
to4.0.2
. Addressed in #7650. - Upgraded
express
from4.16.4
to4.17.1
. Addressed in #8179. - Upgraded
fs-extra
from8.1.0
to9.0.1
. Addressed in #7650. - Upgraded
log-symbols
from3.0.0
to4.0.0
. Addressed in #7650. - Upgraded
tmp
from0.1.0
to0.2.1
. Addressed in #7650.
4.12.1​
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
from2.2.1
to2.3.0
. Addressed in #8161. - Upgraded
electron-context-menu
from0.15.1
to2.2.0
. Addressed in #8180.
4.12.0​
Released 8/3/2020
Features:
- Now you can control whether screenshots are automatically taken on test
failure during
cypress run
by settingscreenshotOnRunFailure
in your configuration. Addresses #5029. - The
pluginsFile
now has access to a readonlyversion
property within theconfig
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 withpointer-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 incy.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 containingnull
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 ofnpm 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
from0.13.0
to0.14.0
. Addressed in #8102. - Upgraded
moment
from2.26.0
to2.27.0
. Addressed in #8122.
4.11.0​
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.
- The Module API has a new
cypress.cli.parseRunArguments
function to assist in parsing user-supplied command line arguments using the same logic ascypress run
uses. Addresses #7760.
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 duringcypress 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
orviewportWidth
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 thepluginsFile
now sets the values correctly. Fixes #7959. - The progress bar for
cy.wait()
now reflects the correctrequestTimeout
andresponseTimeout
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
askey=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
andsupportFile
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
from0.4.0
to0.4.1
. Addressed in #8040. - Upgraded
firefox-profile
from1.3.1
to2.0.0
. Addressed in #8000. - Upgraded
fix-path
from2.1.0
to3.0.0
. Addressed in #8028. - Upgraded
human-interval
from0.1.6
to1.0.0
. Addressed in #8031. - Upgraded
lodash
from4.17.15
to4.17.19
. Addressed in #7954. - Upgraded
plist
from2.1.0
to3.0.1
. Addressed in #8045. - Upgraded
proxy-from-env
from1.0.0
to1.1.0
. Addressed in #7900. - Upgraded
resolve
from1.13.1
to1.17.0
. Addressed in #7989. - Upgraded
systeminformation
from4.21.1
to4.26.9
. Addressed in #7975. - Upgraded
uuid
from3.3.2
to8.2.0
. Addressed in #7976, #8002, and #8011.
4.10.0​
Released 7/7/2020
Features:
- You can open a
before
,beforeEach
,after
, andafterEach
hook definition in your IDE from the Test Runner's Command Log by clicking the Open in IDE button. Addresses #7793. before
,beforeEach
,after
, andafterEach
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 anyDEBUG
environment variable was set. Fixed #7723.
Misc:
Dependency Updates:
- Upgraded
recast
from0.18.8
to0.19.1
. Addressed in #7898.
4.9.0​
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 replacewindow.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 errorCannot read property 'length' of undefined
duringcypress 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 indicate when tests are loading in the Command Log. Addresses #7700.
- The type definitions for
fixturesFolder
,pluginsFile
,screenshotsFolders
andvideoCompression
have been updated to allowfalse
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
from2.1.1
to2.1.2
. Addressed in #7672. - Upgraded
eventemitter2
from4.1.2
to6.4.2
. Addressed in #7705 and #7707. - Upgraded
getos
from3.1.1
to3.2.1
. Addressed in #7685. - Upgraded
is-installed-globally
from0.1.0
to0.3.2
. Addressed in #7703. - Upgraded
jimp
from0.12.0
to0.13.0
. Addressed in #7618. - Upgraded
moment
from2.24.0
to2.26.0
. Addressed in #7718. - Upgraded
signal-exit
from3.0.2
to3.0.3
. Addressed in #7738.
4.8.0​
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
andafter
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
orsupportFile
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 #7343 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 experimentalSourceRewriting 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
from0.28.1
to0.28.2
. Addressed in #7615. - Upgraded
electron
from8.3.0
to8.3.1
. Addressed in #7599.
4.7.0​
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 toutf-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 in 4.6.0 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.
4.6.0​
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
, andhave.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 atsconfig.json
would cause errors to throw if you hadexport
,import
orasync
keywords in your code. Fixes #7005, #7011, #7043, and #7151. - When experimentalSourceRewriting is enabled,
setting
location
orlocation.href
to a relative href, or usinglocation.replace
orlocation.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
andwindow.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 otherframes
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
from2.2.2
to2.2.3
. Addressed in #7291. - Upgraded
cookie-parser
from1.4.4
to1.4.5
. Addressed in #7389. - Upgraded
cypress-multi-reporters
from1.2.4
to1.4.0
. Addressed in #7431. - Upgraded
electron
from8.2.3
to8.3.0
. Addressed in #7236 and #7387. - Upgraded
image-size
from0.7.4
to0.8.3
. Addressed in #7236. - Upgraded
jimp
from0.9.3
to0.12.0
. Addressed in #7408. - Upgraded
return-deep-diff
from0.3.0
to0.4.0
. Addressed in #7292.
4.5.0​
Released 4/28/2020
Features:
- Cypress now supports the execution of component tests using framework-specific
adaptors when setting the
experimentalComponentTesting
configuration option totrue
. For more details see the @cypress/react and @cypress/vue 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
istrue
. 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 ofyarn 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
from8.2.0
to8.2.3
. Addressed in #7079.
4.4.1​
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 theclick
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
orundefined
. Addresses #6126. - We're continuing to make progress in converting our codebase from CoffeeScript to JavaScript. Addresses #2690 in #7004.
4.4.0​
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 properoptions
. Fixes #3171. - We fixed an issue where invalid
Set-Cookie
values could cause requests to fail with acannot read property key of undefined
error. Now, invalidSet-Cookie
values will be ignored. Fixes #6890.
Misc:
- Cypress no longer hides output from
cypress --version
,cypress version
,cypress cache path
, orcypress cache list
commands when npm log level issilent
orwarn
. Addresses #2705. - The cy.task() error message is now more specific about the promise resolution value required. Addresses #6241.
Dependency Updates:
- Upgraded
http-proxy
from1.17.0
to1.18.0
. Addressed in #6934.
4.3.0​
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 viacy.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 totrue
. In Cypress 5, this will be the default. Addresses #2437. - Added support for the
SameSite
cookie attribute incy.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
orParse 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() tohttp://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 tonull
. 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 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 incypress open
from80.0.3987.141
to80.0.3987.158
. Addressed in #6855. - Upgraded
electron
from8.1.1
to8.2.0
. This bumps the bundled Chromium to80.0.3987.158
. Addressed in #6855. - Upgraded
@benmalka/foxdriver
from0.2.3
to0.3.0
. Addressed in #6592. - Upgraded
@cypress/get-windows-proxy
from1.6.0
to1.6.1
. Addressed in #6823. - Upgraded
execa
from1.0.0
to4.0.0
. Addressed in #6013. - Upgraded
extract-zip
from1.6.7
to1.7.0
. Addresses #6845 in #6845. - Upgraded
firefox-profile
from1.3.0
to1.3.1
. Addressed in #6594. - Upgraded
get-port
from5.1.0
to5.1.1
. Addressed in #6854. - Upgraded
mime
from1.6.0
to2.4.4
. Addressed in #6764. - Upgraded
minimist
from1.2.2
to1.2.5
. Addressed in #6747. - Upgraded
squirrelly
from7.7.0
to7.9.2
. Addressed in #6735.
4.2.0​
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 anafter
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 incypress open
from78
to80
. Addressed in #6555. - Upgraded
electron
from7.1.13
to8.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
from1.0.19
to1.0.20
. Addressed in #6686. - Upgraded
minimist
from1.2.0
to1.2.2
. Addressed in #6726. - Replaced deprecated
request
withcypress-io/request
. Addressed in #6679.
4.1.0​
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 duringcypress 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) andconfigFile
(absolute path to the configuration file). Addresses #5941.
Bugfixes:
- Fixed a regression in 4.0.2 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. - cy.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 andCypress.$
. More info here 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
from7.1.10
to7.1.13
. Addressed in #6566.
4.0.2​
Released 2/14/2020
Bugfixes:
- We fixed a bug where tests in Firefox would not open on macOS if another instance of Firefox was open. Fixes #6380.
- We fixed a regression in 4.0.0 where using
.should('not.contain', ...)
chained after a .contains() would produce unexpected results. Fixes #6384. - We fixed a regression in 4.0.0 where non-top-level
require()
s in tests no longer worked. Fixes #6403. - Re-running a failed workflow in GitHub Actions now properly generates a new Dashboard run. Fixes #6450.
Misc:
- We fixed incorrect type definitions for Cypress.isBrowser. Addresses #6447.
- We improved the error experience when launching a browser fails. Addresses #6432.
- We improved the error experience when visiting the Cypress server outside of a Cypress-launched browser. Addresses #6435.
Dependency Updates
- Upgraded
@cypress/browserify-preprocessor
from2.1.1
to2.1.4
. Addressed in #6419.
4.0.1​
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.
4.0.0​
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:
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 anoptions
object with anargs
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 theirfamily
field. Addresses #6243. - The
--browser
flag no longer acceptscanary
as its sole argument to run Chrome Canary. You now have to specifychrome:canary
to use the Chrome Canary browser. Addresses #6243. - .contains() now ignores leading, trailing, duplicate whitespaces. Addresses #92.
- cy.writeFile() now yields
null
instead of the contents written to the file in order to more align with the behavior offs
. 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. - There is a new
matchCase
option for .contains(). Addresses #2785. - 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
from1.1.2
to2.1.1
. Addressed in #4308 and #4226. - Upgraded
bluebird
from3.5.0
to3.7.2
. Addressed in #4226. - Upgraded
cachedir
from1.3.0
to2.3.0
. Addressed in #4208 and #4226. - Upgraded
chai
from3.5.0
to4.2.0
. Addressed in #2862 and #4226. - Upgraded
chai-as-promised
from6.0.0
to7.1.1
. Addressed in #4226. - Upgraded
chalk
from2.4.0
to3.0.0
. Addressed in #4226. - Upgraded
commander
from2.15.1
to4.0.1
. Addressed in #4208 and #4226. - Upgraded
debug
from2.15.1
to4.0.1
. Addressed in #4226. - Upgraded
execa
from0.10.0
to3.3.0
. Addressed in #4226. - Added
firefox-profiler
. Addressed in #1359. - Added
foxdriver
. Addressed in #1359. - Upgraded
fs-extra
from5.0.0
to8.1.0
. Addressed in #4226. - Upgraded
getos
from3.1.1
to3.1.4
. Addressed in #4226. - Upgraded
is-ci
from1.2.1
to2.0.0
. Addressed in #4226. - Upgraded
mocha
from2.5.3
to7.0.1
. Addressed in #2703 and #4226. - Upgraded
listr
from0.12.0
to0.14.3
. Addressed in #4226. - Upgraded
log-symbols
from2.2.0
to3.0.0
. Addressed in #4226. - Added
marionette-client
. Addressed in #1359. - Upgraded
ramda
from0.24.1
to0.26.1
. Addressed in #4226. - Upgraded
sinon
from3.2.0
to8.1.1
. Addressed in #2881 and #4226. - Upgraded
strip-ansi
from3.0.1
to6.0.0
. Addressed in #1359. - Added
systeminformation
. Addressed in #1359. - Upgraded
support-colors
from5.5.0
to7.1.0
. Addressed in #4208 and #4226. - Upgraded
untildify
from3.0.3
to4.0.0
. Addressed in #4226.
3.8.3​
Released 1/24/2020
Bugfixes:
- We fixed an error during
cypress run
indicatingcould 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
from7.1.7
to7.1.10
. Addressed in #6180 and #6242. - Upgraded
http-status-codes
from1.3.2
to1.4.0
. Addressed in #6134. - Upgraded
socket.io
andsocket.io-client
from2.2.0
to2.3.0
. Addressed in #6179.
3.8.2​
Released 01/10/2020
Bugfixes:
- We fixed a regression in 3.8.0 on Linux when
unzip
is not installed where the progress ofcypress install
would show up to 200%. Fixes #5967. - We fixed a regression in 3.7.0 that would prevent
.type() from typing valid characters after invalid
characters were typed in
type="number"
inputs. Fixes #6055. - Child elements of an element that uses both
transform
andheight
orwidth
are now properly seen as visible during visibility 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. - .should() and .and() commands with function arguments can now be chained with multiple assertions without throwing an error. Fixes #4981.
Misc:
- We replaced the browser icons in the Test Runner with more official browser brand icons. Addresses #5921.
- 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
andremoveAllListeners
have been added toCypress
andcy
. Addresses #5228. - Types for the
runUrl
property returned fromcypress.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
from4.0.3
to4.0.4
. Addressed in #6074. - Upgraded
electron
from7.1.4
to7.1.7
. Addressed in #6085.
3.8.1​
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 plugins 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
from5.0.0
to5.1.0
. Addressed in #6004. - Upgraded
chrome-remote-interface
from0.28.0
to0.28.1
. Addressed in #6008. - Upgraded
which
from1.3.1
to2.0.2
. Addressed in #6017. - Upgraded
ansi_up
from1.3.0
to4.0.3
. Addressed in #4331. - Upgraded
jimp
from0.6.4
to0.9.3
. Addressed in #4331.
3.8.0​
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 duringcypress install
before trying the slower, Node.js-based unzipping method. Addresses #3803.
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() or cy.request() would be overwritten by theCookie
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)
orrotateY(90deg)
as not visible. Fixes #723. - Fixed a bug where the specs list during
cypress open
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
electron
from5.0.10
to7.1.4
. This bumps the internal Node version to 12.8.1 and the internal Chromium version to 78.0.3904.113. Addressed in #5849. - Upgraded
ansi-escapes
from4.2.1
to4.3.0
. Addressed in #5815. - Upgraded
electron-context-menu
from0.11.0
to0.15.1
. Addressed in #5495.
3.7.0​
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 accessingconfig.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. Addresses #5609.
- .its() and .invoke() now support
a Number for its
propertyName
andfunctionName
arguments respectively. Addresses #5754.
Bugfixes:
- We fixed a regression in 3.5.0 where a cy.visit() that changes superdomain would incorrectly clear cookies of other domains. Fixes #5756.
- We fixed a regression in 3.5.0 where cookies set in a redirect on a
cy.visit() or in a
cy.request
with a customDomain
that is not a subdomain of the current domain would fail to set. Fixes #5656. - We fixed a regression in 3.5.0 which caused .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 aSet-Cookie
header was present in the response. Fixes #5654. - The context of
window
is no longerundefined
within the application under test when called within asetTimeout
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.visit
s 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.
Documentation Changes:
- Updated the its() and invoke() doc to allow for arguments of type Number for their first argument.
- Documented
how to pass in a custom list of browsers
using
config.browsers
.
Dependency Updates:
- Upgraded
parse-domain
from2.0.0
to2.3.4
. Addressed in #5726.
3.6.1​
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 wasundefined
. 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
3.6.0​
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 modifier key during
.type()
. Fixes #5439. - We now send all the proper events during
.type()
to input elements with typedate
,time
, anddatetime-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
withsquirrelly
to reduce dependency size. Addressed in #5521. - Upgraded
graceful-fs
from4.2.0
to4.2.3
. Addressed in #5497.
3.5.0​
Released 10/23/2019
Features:
- We now record video by default when you run Cypress in Chrome, Chromium, or Canary such as during cypress run --browser chrome. 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 passfalse
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
tosystem
in your configuration. This Node version will be used to build files in yourintegrationFolder
andsupportFile
and also be used to execute code in yourpluginsFile
. If not set, Cypress will continue to use the Node version bundled with Cypress. Addresses #4432. - .dblclick() now accepts
position
,x
, andy
arguments. Addresses #116. - .dblclick() now accepts
force
andmultiple
in itsoptions
. 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 parameters 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
andsamsung-note9
. Addresses #4967. - Passing a
~
toCYPRESS_CACHE_FOLDER
will automatically resolve to the user's home directory. Addresses #5386.
Bugfixes:
- .dblclick() and .click() now
fire all appropriate mouse events including
mouseover
,mousemove
,mouseout
,pointerdown
,pointerup
, andpointermove
. Fixes #1016, #1847, #2045, #2521, #2768, #2928, #2957, and #3224. - We updated .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 theirvalue
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
andscreenY
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 anERR_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 thecommandTimeout
. 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 usingContent-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
orvalue
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 inNO_PROXY
. To make Cypress send traffic forlocalhost
through the proxy, you will now have to pass<-loopback>
inNO_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
andmessage
types when a run fails using the Module API. Addresses #5335. - We're continuing to make progress 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
, andy
arguments plusforce
andmultiple
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 How to use Plugins and Node Events Overview 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 Cypress App 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 thecy.route()
doc. - Mention that the
file://
prefix is not supported in the cy.visit() doc. - Add a note about when passing
<-loopback>
inNO_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 incypress open
from61
to73
. Addressed in #4720. - Upgraded
electron
from2.0.18
to5.0.10
. Addressed in #4720. - Upgraded
node
from8.9.3
to12.0.0
. Addressed in #4720. - Upgraded
jquery
from2.2.4
to3.1.1
. Addressed in #1229. - Upgraded
sanitize-filename
from1.6.1
to1.6.3
. Addressed in #5216. - Upgraded
@cypress/get-windows-proxy
from1.5.4
to1.6.0
. Addressed in #5108.
3.4.1​
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
andincludes
assertion chainers now correctly work the same ascontain
andcontains
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 befalse
before attempting to type. Fixes #1246. - Variables beginning with
top
andlocation
in your application code are no longer modified whenmodifyObstructiveCode
istrue
. 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 accommodate 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
from1.0.17
to1.0.19
. Addressed in #4792. - Upgraded
browserify
from13.3.0
to16.3.0
. Addressed in #4751, #4825 and #4826. - Upgraded
data-uri-to-buffer
from1.2.0
to2.0.1
. Addressed in #4622. - Upgraded
duplexify
from4.0.0
to4.1.1
. Addressed in #4853. - Upgraded
graceful-fs
from4.1.15
to4.2.0
. Addressed in #4818. - Upgraded
lodash
from4.17.11
to4.17.15
. Addressed in #4684, #4709, #4784. - Upgraded
mocha-junit-reporter
from1.23.0
to1.23.1
. Addressed in #4785. - Upgraded
p-queue
from1.2.0
to6.1.0
. Addressed in #4750. - Upgraded
semver
from6.0.0
to6.3.0
. Addressed in #4797. - We also updated and removed some dependencies used for development.
3.4.0​
Released 7/9/2019
Features:
- Users can now log in to the Test Runner through the browser installed on their system. This also allows for login via GitHub with U2F keys. Addresses #3583, #4337, and #1162.
- Google or SSO (if configured) login is now supported in the Test Runner. Addresses #3519.
Bugfixes:
- Cypress now properly supports partial matching of string values for assertions
contain.text
,contain.html
, andcontain.value
. Fixes #1969. - A form is now properly submitted when using
.type('{enter}')
on a form containing no buttons and only one input that allows implicit submission. Fixes #4495. - Extra whitespace and quotations are now stripped from the
CYPRESS_INSTALL_BINARY
environment variable to help prevent some unexpected results when set in Windows. Fixes #4506. - Electron rendering warnings are no longer printed to console output. Fixes #4288.
Misc:
- We now expose a downloadable binary for each commit made into the develop branch of the cypress repository so that pre-released versions can be installed. See this commit for an example. Addresses #4525.
- There are now a series of checks that are run during download of Cypress to verify that the zip file downloaded is the correct file. Addresses #812 and #3515.
- A warning now displays for Windows' users who have Group Policy settings that may interfere with usage of Cypress. Addresses #4391.
- There's a new warning when mouse interactions fail displaying that it failed
due to the element having CSS
pointer-events: none
. Addresses #3164. - If a URL is passed to
cy.route()
containing percent-encoded characters, we now display a warning explaining thatcy.route()
expects a decoded URL. Addresses #2372. - Environment variables for Semaphore 2.0 are now captured when recording tests to the Dashboard. Fixes #4671.
- We now capture environment variables set from Concourse CI when recording tests to the Dashboard. Fixes #4376.
- We replaced capturing environment variables from SnapCI (which is no longer available) to instead capture ones set from GoCD when recording tests to the Dashboard. Fixes #2680.
- The JSON schema file used for intelligent code completion for the Cypress configuration file has been updated to match our documentation.
Documentation Changes:
- New error message added about policy settings to our Error Messages doc. Addressed in #1567.
- Real World example tests were added to Example Applications doc. Addressed in #1567.
- More content was added to our Code Coverage doc.
Dependency Updates
- Removed
string-to-stream
since it was no longer being used. Addressed in #4619. - Upgraded
@cypress/commit-info
from2.1.3
to2.1.4
. Addressed in #4597. - Upgraded
@cypress/react-tooltip
from0.4.0
to0.5.0
. Addressed in #4610. - Upgraded
errorhandler
from1.5.0
to1.5.1
. Addressed in #4618. - Upgraded
fs-extra
from8.0.1
to8.1.0
. Addressed in #4620. - Upgraded
request-progress
from0.4.0
to3.0.0
. Addressed in #4584. - We also updated and removed some dependencies used for development.
3.3.2​
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. - 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 whennumTestsKeptInMemory
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 anENOSPC
error. Fixes #4283. - Cypress now correctly handles
blur
andfocus
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 withoverflow: 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 CSSvisibility: 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 typereset
. Fixes #3909. - If a site's
content-type
isnull
,undefined
or cannot be determined duringcy.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'scontent-type
istext/html
. #1727 #773 #3101. - Previously Cypress would send the
auth
header to any URLs that match the CORS origin of the originalauth
header. We now correctly only send theauth
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
parameter 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()
orcy.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 onlocalhost
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 returnundefined
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 settingCYPRESS_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 ellipsis 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
from1.7.0
to3.0.1
. Addressed in #4487. - Upgraded
cookie
from0.3.1
to0.4.0
. Addressed in #4329. - Upgraded
dependency-tree
from6.5.0
to7.0.2
. Addressed in #4364. - Upgraded
fs-extra
from0.30.0
to8.0.1
. Upgraded in CLI package only to5.0.0
. Addressed in #4418, #4419, #4422, #4437, #4555, #4559, #4571, #4581. - Upgraded
mocha-junit-reporter
from1.18.0
to1.23.0
. Addressed in #4417. - Upgraded
pluralize
from7.0.0
to8.0.0
. Addressed in #4438. - Upgraded
shell-env
from0.3.0
to3.0.0
. Addressed in #4466, #4467, and #4471. - Upgraded
winston
from0.9.0
to2.4.4
. Addressed in #4538. - We updated and removed some dependencies used for development.
3.3.1​
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
andnot.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.
3.3.0​
Released 5/17/2019
News:
- We've
written a blog post
about the 300% increase in proxy performance delivered in
3.3.0
.
Features:
- Cypress now automatically reads from your system's
HTTP_PROXY
,HTTPS_PROXY
, andNO_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
andnot.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
andretryOnNetworkFailure
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 oftype="module"
. Fixes #3696. - Exposed Cypress.isCy() method to check if a value is
a valid instance of
cy
or acy
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
andcypress run
commands by starting its own Xvfb server on Linux if the first attempt fails due to possibleDISPLAY
misconfiguration. Addresses #4034. - Cypress now properly handles typing JavaScript object prototype methods (like
hasOwnProperty
) into.type()
. Fixes #3423. - We now set the
form
option totrue
if theContent-Type
header equalsapplication/x-www-form-urlencoded
andjson
is not already set by a user. This fixes a situation where Cypress would try to parse thebody
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 acceptsRegExp
type arguments. Fixes #2578. - The .trigger() type definition now expects its
options
to beObjectLike
. 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
andretryOnNetworkFailure
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
from2.1.2
to2.1.2
. Addressed in #4045 - Upgraded
data-uri-to-buffer
from0.0.4
to1.2.0
. Addresses #4152. - Upgraded
electron
from1.8.2
to2.0.18
. Addresses #4000. - Upgraded
electron-packager
from9.1.0
to13.1.1
. Addresses #4155. - Upgraded
express-handlebars
from3.0.0
to3.0.2
. Addressed in #4086. - Upgraded
find-process
from1.2.1
to1.4.1
. Addressed in #4087. - Upgraded
getos
from2.8.4
to3.1.1
. Addressed in #4222. - Upgraded
http-status-codes
from1.3.0
to1.3.2
. Addressed in #3949. - Upgraded
jimp
from0.6.0
to0.6.4
. Addressed in #4097. - Removed
method-override
. Addressed in #4209. - Upgraded
node
from8.2.1
to8.9.3
. Addressed in #4001. - Downgraded
parse-domain
from 2.1.7 to 2.0.0 to avoid a regression released inparse-domain
. Addresses #3717. - Upgraded
pluralize
from3.1.0
to7.0.0
. Addressed in #4205 and #4206. - Upgraded
semver
from5.6.0
to5.7.0
. Addressed in #4112. - Upgraded
send
from0.16.2
to0.17.0
. Addressed in #4134. - Upgraded
supports-color
from5.5.0
to6.1.0
. Addressed in #4150. - Removed
tar-fs
. Addressed in #4148. - Upgraded
term-size
from1.2.0
to2.0.0
. Addressed in #4148. - Upgraded
tmp
from0.0.33
to0.1.0
. Addressed in #4111. - Upgraded
trash
from4.3.0
to5.2.0
. Addressed in #4140. - Upgraded
url-parse
from1.4.4
to1.4.7
. Addressed in #4110. - Upgraded
widest-line
from2.0.1
to3.1.0
. Addressed in #4139. - We updated and removed some dependencies used for development.
3.2.0​
Released 3/15/2019
Features:
- cy.visit() has been expanded to allow options
url
,method
,body
, andheaders
. This allows cy.visit() to be called with aPOST
method or with headers likeAccept-Language
orAuthorization
. Fixes #1500, #1904 and #908. - cy.request() now allows any valid HTTP
method
to be used includingTRACE
,COPY
,LOCK
,MKCOL
,MOVE
,PURGE
,PROPFIND
,PROPPATCH
,UNLOCK
,REPORT
,MKACTIVITY
,CHECKOUT
,MERGE
,M-SEARCH
,NOTIFY
,SUBSCRIBE
,UNSUBSCRIBE
,SEARCH
, andCONNECT
. Addresses #1302 - The
--browser
argument of the Command Line and thebrowser
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 your allowed extensions 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 Cypressdependencies
intodevDependencies
. 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
orsetInterval
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()
returnsundefined
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 toundefined
until it meets the requirements of the assertion or thecy.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 alongsidenpm
. 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 forwindow.alert
events to allow forSinon.stub
. Fixes #3451. - Fixed typo in typing for .trigger options. Addressed in #3588.
Documentation Changes:
- New Retryability doc #1278
- Updated
--browser
andbrowser
args to acceptpath
#1419 - Document how to accept or reject project transfers #1474
- Updated docs on explain how to run Chrome and Chromium browsers #1339
- Added
{home}
and{end}
character sequences tocy.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 Troubleshooting doc explaining how to allow the Cypress Chrome extension.
- Fixed code example for google analytics stubbing #1454
Dependency Updates
- Upgraded
@cypress/commit-info
from2.1.1
to2.1.2
. #3327. - Upgraded
@cypress/xvfb
from1.2.3
to1.2.4
. #3328. - Upgraded
@ffmpeg-installer/ffmpeg
from1.0.15
to1.0.17
. #3329. - Upgraded
cachedir
from1.3.0
to2.1.0
. #3660. - Upgraded
chalk
from2.4.1
to2.4.2
. #3362. - Upgraded
chokidar
from1.6.0
to1.7.0
. #3363. - Upgraded
coffee-script
from1.12.5
to1.12.7
. #3365. - Upgraded
commander
from2.11.0
to2.19.0
. #3366. - Upgraded
common-tags
from1.4.0
to1.8.0
. #3368. - Upgraded
compression
from1.7.2
to1.7.3
. #3379. - Upgraded
cookie
from0.2.4
to0.3.1
. #3380. - Upgraded
cookie-parser
from1.4.3
to1.4.4
. #3443. - Upgraded
dependency-tree
from6.4.0
to6.5.0
. #3381. - Upgraded
electron-context-menu
from0.8.0
to0.11.0
. #3383. - Upgraded
electron-packager
from9.0.1
to9.1.0
. #3384. - Upgraded
electron-positioner
from3.0.0
to3.0.1
. #3385. - Upgraded
errorhandler
from1.1.1
to1.5.0
. #3386. - Upgraded
express
from4.16.2
to4.16.4
. #3409. - Upgraded
extract-zip
from1.6.6
to1.6.7
. #3410. - Upgraded
glob
from7.1.2
to7.1.3
. #3412. - Upgraded
image-size
from0.5.5
to0.7.2
. #3413 and #3500. - Upgraded
is-ci
from1.0.10
to1.2.1
. #3414. - Upgraded
lodash
from4.17.4
to4.17.11
. #3344. - Upgraded
mocha-junit-reporter
from1.17.0
to1.18.0
. #3417. - Upgraded
moment
from2.23.0
to2.24.0
. #3433. - Upgraded
morgan
from1.3.0
to1.9.1
. #3434. - Upgraded
node-uuid
from1.4.1
to1.4.8
. #3436. - Upgraded
parse-domain
from2.0.0
to2.1.7
. #3437. - Upgraded
request
from2.87.0
to2.88.0
. #3444. - Upgraded
request-progress
from0.3.1
to0.4.0
. #3445. - Upgraded
request-promise
from4.1.1
to4.2.4
. #3446 and #3476. - Upgraded
return-deep-diff
from0.2.9
to0.3.0
. #3447. - Upgraded
send
from0.14.2
to0.16.2
. #3448. - Upgraded
ssl-root-cas
from1.2.5
to1.3.1
. #3449. - Upgraded
supports-color
from5.1.0
to5.5.0
. #3464. - Upgraded
through
from2.3.6
to2.3.8
. #3465. - Upgraded
tmp
from0.0.31
to0.0.33
. #3466. - Upgraded
tough-cookie
from2.4.3
to3.0.1
. #3477 and #3659. - Upgraded
trash
from4.0.0
to4.3.0
. #3478. - Upgraded
underscore.string
from3.3.4
to3.3.5
. #3480. - Upgraded
yauzl
from2.8.0
to2.10.0
. #3481. Potentially fixes #3515. - We also updated many dependencies used for development and removed some unused dependencies.
3.1.5​
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 anInvalidStateError
when visiting a page with an XHR request with aresponseType
other thantext
or''
. Fixes #3008. - Fixed several issues in Chrome* versions >= 72 in the Cypress proxy that
caused using
cy.visit()
withlocalhost
to fail, or usinglocalhost
inside of thebaseUrl
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 largetimeout
values would causeESOCKETTIMEDOUT
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. - Using .clear() on inputs of type 'date' is now working. Fixes #2738
- Fixed issue where
event
was undefined when using anonload
event handler. Fixed #2859
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.
- Updated error messages to include single quotes when displaying written test code. Addresses #2684
Documentation Changes:
- Added example on how to use a fake video for webcam testing to Browser API doc.
Dependency Updates
- We've begun automating our dependency update process in order to avoid accidental dependency updates. Addresses #2990 and #3025.
- Upgraded
sinon
from3.2.0
to3.3.0
. Addresses #1328.
3.1.4​
Released 12/25/2018
Merry Christmas everyone!
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 theirdisposer
function called in frameworks likerxJS
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. Addresses #2754.
- Fixed incomplete type definitions for cy.request. Fixes #2305.
Dependency Updates
- Upgraded
commit-info
from2.0.0
to2.1.1
. Fixes #2848. - Upgraded
lodash
from4.17.10
to4.17.11
. Fixes #2929.
3.1.3​
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
andresponseTimeout
. Fixes #2446.
Documentation Changes:
- Added
requestTimeout
andresponseTimeout
options to cy.wait() - Added 'History' table to cy.wait()
- Added 'Alias' for assertions that are aliases of each other to Assertions
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.
3.1.2​
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
andkeyCode
when using.type()
on a few different special characters such as{
. Fixes #2105. - Fixed another regression in
3.1.1
where passingundefined
to asetTimeout
caused Cypress to error. Fixes #2719. - Fixed a bug in node core where Cypress would not show up in
Windows
for users onnode >= 11
. Fixes #2667. - Fixed a bug with trashing assets in linux that caused recursive
.Trash
files to show up. We now have opted to actuallyrm -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.
3.1.1​
Released 11/2/2018
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
fromcypress.run()
. Fixes #2596. - Specs now properly display as focused when navigating through specs via the keyboard. Fixes #2273.
- Tasks registered in the plugins file with the 'task' event are merged with any
tasks registered by previous calls to
on('task')
, instead of overwriting the previous tasks. Fixes #2284.
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
andvideosFolder
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 samereadyState
. 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.
- The Test Runner's search now resets when switching between projects. Fixes #2512.
- Fixed internal Cypress tests. Fixes #2606.
- Replaced use of
new Buffer
withBuffer.from
. Fixes #2626. - Allowed
autoScrollingEnabled
to be saved instate.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.
Documentation Changes:
- Added
flag
option tocy.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.
Dependency Updates
- Upgraded common-tags from
^1.4.0
to^1.8.0
#2415 - Upgraded @cypress/browserify-preprocessor from
1.1.0
to1.1.1
#2513 - Upgraded lolex from
^1.5.2
to^3.0.0
#2570 - Upgraded @types/jquery from
3.2.16
to3.3.6
#2363 - Upgraded zunder from
5.6.5
to6.1.1
#2541
3.1.0​
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 #2169cypress 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 and #1235 and #1333. - 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 thantype='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 to1.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 when run via 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.
3.0.3​
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 theRootLayerScrolling
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()
orcypress.run()
. Passing nested objects inreporterOptions
now works correctly. This is especially useful when usingmocha-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 asblacklistHosts
. 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 open 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 ofblur
andfocus
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
ornumber
will no longer fire unnecessary additionalblur
andfocus
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
andclick
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 oninput[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
andselectionEnd
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 becomebody
. Fixes #2234. - Using
cy.get('body').click()
now correctly changes theactiveElement
back tobody
and causes the existingactiveElement
to receiveblur
. 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 regulartext
inputs and allows you to type into them. Fixes #586. - Using
{uparrow}
or{downarrow}
with .type() on aninput[type=number]
element now increments or decrements the number configured via thestep
attribute. Fixes #2110. - Using
{uparrow}
or{downarrow}
with .type() now correctly moves the cursor ontextarea
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 from1.12.1
to1.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. - 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:
3.0.2​
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 runningcypress 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 returntrue
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 duringnpm 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 usedsetTimeout
with a string argument would see the errorfn.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 localstate.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
to4.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
andonBeforeScreenshot
callbacks ar enow invoked for failed tests. They include atestFailure
property to distinguish between automatic ones and your own use ofcy.screenshot()
. Fixes #2040. - There's now an
after:screenshot
plugin event you can use in yourpluginsFile
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.
3.0.1​
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 openingChrome
no longer causescy.screenshot()
to fail. Fixes #1820. - Fixed a bug with Windows users seeing crashes with
tty.getWindowSize is not a function
. Fixes #1815 and #1817.
3.0.0​
Released 5/29/2018
Summary:
- There is a new
cy.task()
command that enables you to go outside the browser to perform tasks directly innode
. This will make it easy to setup, scaffold, seed, talk to your database, or anything else useful on a back end. 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 variableCYPRESS_INSTALL_BINARY
instead. - The environment variable
CYPRESS_SKIP_BINARY_INSTALL
has been removed. To skip the binary install, setCYPRESS_INSTALL_BINARY=0
. screenshotOnHeadlessFailure
has been removed as an option incypress.json
. Instead you can now control this behavior directly with code by settingscreenshotOnRunFailure
tofalse
within the new Screenshot API. Fixes #1140 and #1754.trashAssetsBeforeHeadlessRuns
has been renamed totrashAssetsBeforeRuns
in our configuration. Fixes #1754.videoRecording
has been renamed tovideo
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
andafter
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 arbitrarynode
code. - You can now run multiple specs by passing a glob to the
--spec
argument ofcypress 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 anexamples
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 thecypress-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 thanpending
tests. #244. - Standard output now displays the number of
skipped
tests within the summary output duringcypress 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'swindow
. Fixes #1436. - The
close
event now properly fires onfile
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()
orcypress.run()
through the Module API, just as you would from the command line. #1442. - Added type definitions for
Cypress.off
andCypress.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 aduration
option. Fixes #1606. NODE_OPTIONS
environment variables now print within thecypress:cli
logs when running inDEBUG
mode. Although usingNODE_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 accompanyinghooks
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 to20
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
andheadless
to be more specific and instead referencerun mode
andinteractive 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 seededexamples
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 waysclose
event could be triggered - Updated use of "running headlessly" to more accurate "during
cypress run
"
2.1.0​
Released 3/1/2018
Bugfixes:
- Prevent a bug with
node-sass
on OSX + Windows when localnode
version does not match bundlednode
when importing components directly in spec files. The underlying issue was because we forgot to updateBuildkite
andAppveyor
when we upgradedElectron
in2.0.0
. Fixes #1387 and #1390.
Features:
- The
Selector Playground
has been updated to automatically prefer
data-cy
,data-test
ordata-testid
attributes when providing the unique selector for an element. Additionally it now exposes a public API that you can use to control how it determines which selector to use. Fixes #1135.
Documentation Changes:
- Added
Selector Playground Guide
- Added
Selector Playground API
- Updated
Best Practices
- Updated
FAQ
- Updated
Introduction to Cypress
2.0.4​
Released 2/25/2018
Bugfixes:
- The
cypress
npm package now has the correctengines
set inpackage.json
. This was accidentally getting overwritten and caused errors whenengineStrict
was set in environments usingnode
older than8.2.1
. Fixes #1373.
2.0.3​
Released 2/21/2018
Bugfixes:
- The runner no longer appears to "hang" if a
before
hook fails in a test with siblings. Previously the test would never generate astatus
and look pending forever. This was a visual bug only. Fixes #1343. - The Desktop GUI properly renders folders that contain specs in Windows now. Fixes #1335.
Misc:
- The viewport dropdown helper in the Runner now displays string quoted JSON
instead of an object literal. This better matches how you should write those
options in
cypress.json
. Fixes #1350.
2.0.2​
Released 2/17/2018
Bugfixes:
- Fixed more edge cases where legitimate JavaScript code was being modified unexpectedly by the modifyObstructiveCode configuration. We've tightened up the RegExp even more and added 40 popular JS libraries to test against to ensure they are not modified. Fixes #1334.
- Fixed an edge case when hooks such as
beforeEach
orafterEach
threw an identical error message, Cypress would hang indefinitely and never finish running the tests. Fixes #674. - Fixed bug when
Errors
that threw with no arguments:throw new Error()
and had their messages appended would duplicate the message over and over again. Fixes #1338.
2.0.1​
Released 2/16/2018
Bugfixes:
- Using cy.contains() with a RegExp argument is now properly escaped. Fixes #1322.
- Fixed a runaway RegExp causing large
.js
files to take dozens of seconds to process. This was a regression caused by2.0.0
with the new modifyObstructiveCode option. We've optimized the RegExp and the performance is back to being almost identical to transparently passing responses through. Fixes #1330.
2.0.0​
Released 2/15/2018
Breaking Changes:
- The built in default
Electron
browser has been bumped from version53
to59
. This version represents the version ofChromium
that Electron is using. In other words, runningcypress run
(or viaElectron
) will be like running your tests inChrome 59
now. Although it is unlikely this would actually break any of your tests - it is technically possible they could behave differently. Fixes #895 and #891 and #823 and #860 and #1011 and #1252 and #1276. - We are now detecting and automatically stripping code that obstructs Cypress
from being able to test your application. Specifically, we are removing
JavaScript code that tries to prevent clickjacking and framebusting.
We have written very conservative rules that do their best to only strip
these specific JS snippets, but it is technically possible that it may
unintentionally rewrite valid JS if they match the RegExp patterns. There is a
new configuration option called
modifyObstructiveCode that is
true
by default. If you are experiencing problems after upgrading, you can turn this off and this will disable modifying your JS code. If you were using Cypress and upon visiting your website you would experience seemingly "random" redirects - these problems should now be eliminated. Fixes #886 and #1245 and #1064 and #992 and #692 and #352. - We are now clearing the browser's disk cache each time it opens (before any
tests run). This means that any files that have been cached from
Cache-Control
headers will be cleaned and removed. In the future, we will expose a newcy.clearCache()
method to provide finer grained control of clearing the cache on a per test basis. But for now, this is an improvement. Fixes #1124. - The
--spec
option is now normalized against the current working directorycwd
instead of the project that you are running Cypress in. That means passing a path from the command line to a spec file will now work even when the project path is notcwd
. Fixes #1159.
Bugfixes:
- blacklistHosts would occasionally not work if you were blocking a host that had previously cached a file. In this case, the browser would serve it from disk and not make an actual HTTP request. This issue has been solved by clearing the cache when the browser opens. Fixes #1154.
- blacklistHosts is now correctly
accepted via the
--config
CLI flag. - Spies and Stubs created with cy.stub() and cy.spy() will now retry their assertions when utilized from an alias. Fixes #1156.
- Basic auth is working again in Chrome 63 and Chrome 64. We "for real" fixed it
this time by adding auth headers automatically at the network proxy layer and
bypassed the browser altogether. We automatically apply auth headers if you
provide a username/password in the URL of a
cy.visit(url)
. We also added a newauth
option to specify theusername/password
usingcy.visit(url, options)
. All of the requests that match the origin of the URL will have theAuthorization: Basic <...>
headers added. Fixes #1288. - Fixed domain parsing failures when
local
orlocalhost
was not used as atld
. Fixes #1292 and #1278. - Removed the flag
--disable-background-networking
from the Chrome launch args to fix problems in CI that would throttle XHR callbacks by up to 20-30 seconds. Fixes #1320.
Misc:
- We now properly display nested objects and arrays that come from
cypress.json
in the Settings tab in the Desktop Application. - There's now a proper "empty view" when you go to setup your project to record on our Dashboard and you have not created any Organizations. Fixes #1306.
- Removed the message about private projects requiring a paid account in the future. There will be a free tier including private projects. Fixes #827.
- We moved the location of the browser's disk cache. That means that if you've
been using Cypress for a really long time - you may have built up quite a
large existing cache (in the hundreds of
mb
). Before upgrading, you should open the browser and then manually clear the Cache. Or - if you have already upgraded to2.0.0
delete the following folders:- OSX:
~/Library/Caches/Cypress
- Linux:
~/.cache/Cypress
- Windows:
%APPDATA%\Cypress\cy\production\browsers
- OSX:
1.4.2​
Released 2/4/2018
Bugfixes:
- Fixed not being able to visit subdomains when using 2nd level sub domains. Fixes #1175 and #600.
- Fixed not being able to visit private TLD's from the public suffix such as
github.io
,gitlab.io
orherokuapp.com
. These now all work correctly. Fixes #380 and #402 and #802 and #493 and #1161. - Fixed not being able to visit URLs that used
*localhost
such ashttp://app.localhost:8080
. Fixes #451. - Mochawesome now works correctly and outputs files in all versions. Fixes #551.
- Mochawesome will exit correctly with code
1
when a hook fails. #1063. - Fixed some incorrect typings with TypeScript. Fixes #1219 and #1186.
- Fixed bug with custom 3rd party Mocha reporters relying on
test.titlePath
being a function. Fixes #1142. - Fixed typo in
cypress.schema.json
. Fixes #1167. - Fixed typo in CLI deps error about Docker. Fixes #1136.
- Prevent
NODE_ENV
from being set toundefined
when parent process did not have it defined. Fixes #1223.
Misc:
- We have begun to aggregate failures and other stats ourselves instead of relying on Mocha reporters. Fixes #1141.
- Added TypeScript
should/and
autocomplete and typings for Cypress events. Fixes #1187 and #1132. - Upgrade deps. Fixes #1174.
1.4.1​
Released 12/26/2017
Bugfixes:
- Using
DEBUG=cypress:*
now correctly outputs all debugging information on OSX and Linux. Previously output other thencypress:cli
was ignored due to the CLI ignoringstderr
from the binary. Fixes #921. stdout
is now captured correctly in Windows when recording to the Dashboard. Fixes #977 and issue #711.- Windows now forcibly displays colors correctly to the terminal. Fixes #1127.
Misc:
TTY
is now handled correctly for Linux and OSX. This means that CI providers which turned off colors due toTTY
being false will now display colors again such as TravisCI. Fixes #1126.- We now handle Xvfb exiting with a non zero status code and display that error to you. This should help with situations where Xvfb is misconfigured on the system. Fixes #1113.
- We've added debug output for Xvfb when
DEBUG=cypress:xvfb
is enabled. Helpful when diagnosing problems with Xvfb. Fixes #1128. - We've added more TypeScript documentation for
cy.*
methods. Fixes #1117. - When developing on Cypress, we now start the process through the CLI to bring it into parity with how it works when used in production. Fixes #838.
- Upgraded various CLI dependencies that were flagged for security warnings. There wasn't an actual security problem - just static analyzers complaining. Fixes #1103.
1.4.0​
Released 12/19/2017
Features:
- There is now a Search Bar in the Desktop GUI that enables you to filter the list of specs. Helpful for projects with a ton of spec files. Fixes #1098.
Bugfixes:
- The seeded
example_spec.js
file no longer fails in Windows on the cy.exec() test. It now conditionally runs a command appropriate for Windows. Fixes #1097. - Trying to log in to Cypress no longer causes the app to crash. This area has had many more tests added. Fixes #1093.
- Some minor improvements to TypeScript definitions around .then(). Fixes #1084.
- The Selector Playground now works correctly in the Electron browser. Fixes #1086.
1.3.0​
Released 12/17/2017
Features:
- Plugins now emit a before:browser:launch event exposing you the browser that will be launched and its launch arguments. This enables you to modify the arguments prior to launching the browser. You can also use these arguments to modify how Chrome runs and to also test Chrome extensions. Fixes #691 and #298.
- We have launched a "CSS Selector Playground", a new UI button in the Test Runner that enables you to highlight elements in your application and receive a unique selector. You can also find elements by their text content. These mimics cy.get() and cy.contains() behavior. Additionally you can copy the generated Cypress command to your clipboard or output the generated selector to your console. This feature is in beta. It only works in Chrome (not in Electron). We are aware of some bugs in it, but it is good enough for use and feedback. Please check out issue #917, watch an animated gif demonstration, and leave any feedback you have there. Fixes #917.
Documentation Changes:
1.2.0​
Released 12/14/2017
Features:
- Plugins can now return a
Promise
and modify the yieldedconfig
to set new configuration values and environment variables. Fixes #1042 and #909 and #576. - There is a new userAgent option in
cypress.json
. This enables you to change theuserAgent
of the browser for the entire browsing session. Fixes #364. - There is a new blacklistHosts
option in
cypress.json
that allows you to block requests made to those hosts. Blocked requests will respond with a503
status code. This is useful for blocking 3rd party domains like Google Analytics. We have added a new 'Stubbing Google Analytics' recipe demonstrating this. Fixes #442. - Added chai assertions in TypeScript to generate autocompletion. Fixes #1073.
Bugfixes:
- Updated TypeScript definitions to more accurately match the current Cypress
API. Fixes #1050. Also
note that if you were extending Cypress in TypeScript the
Chainer
interface changed. Please read issue #1048 to understand what you will need to update.
Misc:
- Renamed
environmentVariables
toenv
in the Desktop GUI. Fixes #1052. - Cypress.config() now returns a complete set of configuration values. Fixes #509.
- Added TypeScript typings for bundled Cypress tools like
$
,_
, etc. Fixes #1046. - Some error messages were made more passive. Fixes #1025.
Documentation Changes:
- Added
Configuration API
- Added
Recipes
- Updated
Configuration
- Updated
Environment Variables
- Updated
Using Cypress FAQ
- Updated
Plugins Guide
- Updated
Writing a Plugin API
1.1.4​
Released 12/6/2017
Bugfixes:
- Fixed an issue causing
Chrome
to timeout when attempted to be run through our docker containers. Fixes #1031. - Several TypeScript typings were added, updated and fixed. Fixes #1006.
- Using a regular
http://
URL now works when using theCYPRESS_BINARY_VERSION
flag to point the binary at an external location. Fixes #1001. - File watching is fixed (again) when changing between specs. Fixes #1018.
Misc:
- There is now a new
CYPRESS_SKIP_BINARY_INSTALL
flag you can pass duringnpm install
which skips the binary installation after thecypress
npm module completes its installation. Fixes #1005. - We now launch Chrome with
--no-sandbox
and--disable-gpu
options in Linux. We will soon release a new plugin event that enables you to modify the browser arguments we use by default. This shouldn't cause issues with existing Linux users, and instead it should fix many CI setups that were using our Docker containers or your own home grown installed Chrome setup. Fixes #1021 and #1020. - Removed several aliases from our browser detector. These were not implemented properly and not needed - and thus only caused indirection. Fixes #1023.
1.1.3​
Released 12/3/2017
Bugfixes:
- JSON fixtures with unicode escape sequences are now parsed correctly. Fixes #964.
- The default
browserify
plugin no longer fireswatched:file:changed
twice leading to an uncaught exception that was popping up in the console. Also fixed a minor state bug in thebrowserify
package. Fixes #968. - Cypress no longer reports
Electron
as the browser that ran in the Dashboard Service when a different browser was run. Fixes #854. - Invalid cookie values no longer crash Cypress. Fixes #962.
Misc:
- We are now bundling our own
TypeScript
definitions with thecypress
npm module. You no longer have to install@types/cypress
anymore. We'll continue to keep these updated with API changes. Fixes #856. - Uncaught exceptions originating from your application code and/or test code are now distinctly and clearly indicated in the error message. We included a link to our docs to educate you on how you can optionally disable Cypress from catching these. Fixes #825.
- cy.visit() now accepts
{ failOnStatusCode: false }
which enables you to visit pages that respond with a non2xx
status code. This brings it into parity with cy.request(). Fixes #421 and #574. - The contributing Readme's have been updated and improved for each package. Fixes #995.
- Added utility methods Cypress.platform and
Cypress.arch for returning the underlying OS
information. Uses node's
os
module under the hood. Fixes #824 and #675.
Documentation Changes:
1.1.2​
Released 11/26/2017
Bugfixes:
- Fixed a regression caused by .type() adhering to
maxlength
incorrectly. Special character sequences were not respected. Now .type() works with special characters and implements a complete fix formaxlength
. In addition to it working, it now fires all applicable browser events without modifying the actual input value. Fixes #955. - Errors coming from plugins now display correctly in the Test Runner. Fixes #945.
Documentation Changes:
- Added ESLint, Docker, and TypeScript to Plugins
- Added recipe for TypeScript with Browserify
- Added recipe for TypeScript with webpack
- Added recipe for Direct Controlling AngularJS
- Added recipe for E2E API Testing
- Added more video tutorials
- Improved displaying list of Tutorials, Recipes, Applications, and Docker examples
1.1.1​
Released 11/20/2017
Bugfixes:
- Fixed a bug swallowing plugin errors due to undefined
reject
function. Fixes #934. - .type() now respects the
maxlength
attribute and will not type beyond it. Fixes #928.
1.1.0​
Released 11/19/2017
Summary:
- We have officially launched the new Plugins API interface. This adds a
cypress/plugins/index.js
file to new and existing projects. Using this file will enable you to modify the internals of Cypress running in the backgroundnode
process. This means you will be able to usenode
APIs that are executed outside of the browser. - We have currently added only one event for modifying the test file preprocessor, but this paves the way for adding many more event types. You can now modify every aspect of how files are sent to the browser.
- We have extracted the default Browserify preprocessor into its own package -
@cypress/browserify-preprocessor
. This is bundled with Cypress, but it is extracted so it can be used / modified by you to change the default options we pass to Browserify. Additionally, you can swap out this preprocessor for something else entirely.
Features:
- There is now a Plugins API interface. Partially addresses #684.
- We have added the first Plugin API event called: file:preprocessor. Fixes #580 and #581.
- You can now customize the default Babe; configuration options for the Browserify preprocessor. Fixes #343 and #905.
- CoffeeScript 2 is supported via modifying the default options for the Browserify preprocessor. Fixes #663.
- You can swap out or extend the default preprocessor to do exotic things like compile ClojureScript into JavaScript. Fixes #533.
- We have created a
@cypress/webpack-preprocessor
preprocessor npm package for you webpack users (because we are nice!). Fixes #676.
Bugfixes:
cy.contains(selector, regexp)
now works as intended. Fixes #801.- We no longer format fixtures in any capacity. This fixes a bug with improperly formatting fixtures in Windows. You should handle formatting fixtures yourself. Fixes #884 and #902.
- cy.viewport() resolves if only width or only height changes. Fixes #873.
- Cypress now auto reloads when spec files are modified in Windows. Fixes #712.
Misc:
- There is a new
--global
option useful with cypress open to force Cypress to open in global mode. This is helpful when you have multiple nested Cypress projects but only want to install Cypress once in the root project. Fixes #889. - The module API accepts
reporterOptions
as an object literal like it does for theenv
andconfig
properties. Fixes #899.
Documentation Changes:
- Created "Testing React TodoMVC" tutorials
- Created "Variables and Aliases" core concept
- Created "Conditional Testing" core concept
- Created "Plugins" guide
- Created "List of Plugins"
- Created "Writing a Plugin" API
- Created "Preprocessors API"
- Updated "Using Cypress FAQ"
- Updated "Best Practices"
1.0.3​
Released 10/29/2017
Features:
- The Test Runner now enables you to collapse folders when displaying a list of specs. Fixes #760.
Bugfixes
- The
onChange
event callback for React now works (again) oninput
typenumber
oremail
. Fixes #816 and #770. - Fixed error when recording and failing to parse the git commit message. Fixes #847 and #841.
- Using a single space on:
cy.type(' ')
now works. Fixes #807. cy.spread()
can now be used on a collection of DOM elements. Fixes #735.- CLI shows help message when it is invoked with an unknown command like
$(npm bin)/cypress foo
. Fixes #641.
Misc:
- Enable passing
CYPRESS_RECORD_KEY
without using the CLI by invoking the binary directly. Fixes #820. - Cypress binaries can now be pointed to a staging environment with
CYPRESS_ENV=staging
. Fixes #813. - The Test Runner displays the scrollbar correctly when the update banner is displayed. Fixes #803.
- The branch name is now properly collected when recording in Buildkite CI. Fixes #777.
- You can install the Cypress binary from any URL or file path using the
CYPRESS_BINARY_VERSION
environment variable. Closes #701.
Documentation Changes:
- Created "Conditional Testing" core concept
- Created "Key Differences" core concept
- Updated "Best Practices"
- Updated "FAQ Usage"
1.0.2​
Released 10/13/2017
Bugfixes:
cy.type
now correctly fires change events on React 16. Fixes #647.- Fixed some problems serializing objects during domain change caused by
circular references. In this case
zone.js
was the culprit. Fixes #741.
Misc:
cy.scrollTo
now logs its coordinates when options are used. Fixes #725.- You can now use environment variables that have a
=
character as values. Fixes #620. - There is now a new
videoUploadOnPasses
configuration option incypress.json
. Turning this off will only compress and upload videos on failures. This only affects projects which are setup to record to the Dashboard. Fixes #460.
Documentation Changes:
- Added examples for "Catalog of Events"
- [Added](/ Updated FAQ for "Using Cypress"' using-cypress-faq)
1.0.1​
Released 10/10/2017
Bugfixes:
- Prevent error during verification in the CLI on Linux / OSX. Also makes terminal colors work again. Fixes #717 and #718.
1.0.0​
Released 10/09/2017
Summary:
1.0.0
marks our transition out of a private beta and into a public beta. We've lifted all the restrictions for using Cypress. It is now accessible to everyone. Until we are out of beta, the Dashboard Service will continue to be free.- We will continue to follow
semver
from this point on (and also a bit more rigorously). - Cypress is now open source! This project is licensed under the terms of the MIT License.
- We have a Contributing Guideline to help
contributors get started as well as
issues labeled
first-timers-only
for those wanting to contribute right away. - You can now use the Test Runner application without logging in. Some areas of the application still require logging in through GitHub, like the 'Runs' tab and viewing the project's 'Record Key'. The only places where login is required is when it interacts with our external servers. Naturally these places are optional and will not affect the local test writing + running experience.
- We've removed the requirement of filling out an early adopter form and approval for logging in with GitHub to Cypress.
- www.cypress.io has an all new design to help new visitors get started quickly and understand our future pricing more clearly.
- We are still updating the docs to reflect the
1.0.0
release.
Features:
- Windows is now supported. We have been running it successfully on EC2 and all of our example projects are also running in CI with AppVeyor. It is still super beta (we're aware of a couple issues already) and we're still updating our own infrastructure to manage and test it as comprehensively as we do OSX and Linux. We are only building a 32bit version of Windows, but will soon be building a 64bit as well. As of today the Windows binary is about 2x the size of what it will be. Unzipping takes a long time, we are sorry. Fixes #74 and #444.
Misc:
- Added the
Beta
flag everywhere (since we are still technically in beta). - Reduced the frequency the app checked for updates. Fixes #713.
- The CLI now sends
arch
parameter to the download server so we can build and serve multiple binaries for Windows + Linux.
Documentation Changes:
- Updated "Installing Cypress"
- Updated "Writing your First Test"
- Added a 10 minute Getting Started video that Andrew Van Slaars created.
0.20.3​
Released 10/06/2017
- Improved verifying the binary for the first time after an
npm install
. Fixes #709.
0.20.2​
Released 10/06/2017
Possibly Breaking Changes:
- cy.exec() now trims output by default. That means if you
were using an
eq
assertion the output will no longer have a trailing newline character\n
. It's unlikely you are doing this, but it is possible you may need to update your assertions to remove this character. Fixes #697.
Bugfixes:
- Handle errors gracefully when Electron window has been closed before paint events happen. Fixes #705.
- Basic auth now works again. Fixes #573.
- cy.exec() now properly sources each time it is invoked instead of only once. Fixes #694.
Misc:
cypress open
now accepts the--project
flag which enables you to use a root level Cypress installation and point to multiple sub projects. Fixes #661.- Prevent newer versions of Chrome from prompting you to save passwords and suppressed other extension related popups for Windows. Fixes #704.
0.20.1​
Released 09/17/2017
Features:
cypress run
now supports a--headed
option so the Electron browser will display instead of running headlessly. This matches what you can already do in the GUI. Fixes #657.
Bugfixes:
- Using Cypress on nested projects now correctly works. Fixes #635.
- Using
cy.type
on Angular 2 apps now works. We're now firing thekey
property when typing. We've properly mapped all the special keys too. onBeforeLoad
now gets invoked when overridingcy.visit
. Fixes #656 and #640.- Using multiple
cy.visit
back to back which only change thehash
now properly wait for thehashchange
event to occur before moving on. Fixes #652. - CLI now displays the correct overridden
CYPRESS_BINARY_VERSION
on first open. Fixes #659. - Fixed the incorrectly spelled chainer
descendents
. It is now correctly spelled asdescendants
. Fixes #642. - The visibility algorithm has been considerably improved. Should fix most if
not all visibility problems. We accounted for CSS transforms, translations,
and added a new branch of logic for
position: fixed
elements which should be much more accurate. Fixes #631. - The CLI now treats
-h
and--help
andhelp
as valid commands. Fixes #645.
Misc:
- You can now pass an object literal as
config
when using Cypress as a node module. Fixes #639. - Passing
--reporter
can now reference an absolute path instead of just relative. Fixes #658. - The algorithm that ensures an element is not covered now calculates this at the center coordinates instead of the top left. This should yield more accurate results, be closer to the default expectations of users, and bypass fractional pixel problems we were having. Fixes #655.
- Improved crash reporting when the binary throws an uncaught error.
Documentation Changes:
0.20.0​
Released 09/10/2017
Summary:
0.20.0
is our biggest technical release ever. It accounts for more than 2,000 commits. It's full of breaking changes we wanted to land prior to having our public1.0.0
release.- You can now
install Cypress as a real
npm
module, and evenrequire
it in your node files. - We rewrote the entire driver (we've all been there) and converted all 2,500+ tests to be run within Cypress itself.
CLI Changes:
- You now use
npm
to manage Cypress versions like every other dev dependency. - Running
npm install --save-dev cypress
will automatically download the CLI + binary. - There is no longer a separate
cypress install
step, but this command still exists if you want to reinstall the binary for whatever reason. - No need to use
cypress-cli
anymore to manage Cypress versions. You will need to uninstall thecypress-cli
by runningnpm uninstall -g cypress-cli
. - The
cypress
module can berequired
in your own node projects to programmatically control Cypress the same way you would from the command line. - We've updated the installation experience to account for running locally and
in CI so it doesn't generate a ton of logs in
stdout
. - The
CYPRESS_VERSION
environment variable is gone because now the version of the binary is controlled by the npm module version. If for some reason you want to download the binary of a different version you can use the newCYPRESS_BINARY_VERSION
environment variable - but you'll get a warning message when the versions don't match. - If you install cypress globally using
npm install -g cypress
we will warn you that you should check this in as adevDependency
but Cypress will continue to work in "global mode". - Cypress now verifies it can run on your system prior to actually running. It'll do this for each new version the first time you try to use it. Errors it receives from attempting to run will bubble up nicely, so you'll get output for things like missing linux dependencies instead of absolutely nothing like before.
- We have better error handling and messaging around Xvfb failures.
- There is a new
--browser
option that lets you change the browser that runs from the command line. This works the same way as changing the browser in the GUI, with the exception that any browser other than the defaultelectron
browser will not record a video. This is solvable but requires more work. - Whenever you encounter errors in the CLI we'll output helpful debugging information at the bottom of each error.
- You can use the new environment variable
DEBUG=cypress:cli
to see debugging output from the CLI.
Breaking Changes:
- We've removed the undocumented
cy.chain()
command. You should be able to safely remove this from your code. Fixes #456. - Updated Cypress._ to use lodash instead of Underscore. Fixes #548.
- If any of an element's parent's overflow is 'hidden', we now calculate if the element is outside of the boundaries of that parent element and validate visibility assertions accordingly. This may cause some tests that were previously passing to now accurately fail. Fixes #410.
.select()
should now look for the trimmed value inside of an<option></option>
. This may change the content argument required to select the option you intended in your.select()
command. Fixes #175.- When passing the option
{ force: true }
to.click()
and.type()
, we no longer attempt to scroll the element into view. We've also disabled the check that the element is in view before clicking or typing. Fixes #553 and #537. Cypress.Dom
has been renamed toCypress.dom
.Cypress.Log.command
has been renamed to Cypress.log.chai-jQuery
assertions no longer change the subject when usingprop
,attr
, andcss
with the 3rd argument (which acts as equality check). Fixes #605.- We now throw when a value other than
cy
is returned from a test or command function. Fixes #463. - Returning a promise in a custom command while also invoking cy commands now throws. Fixes #435.
- cy.then() will now only pass its subject through when
its callback function returns
undefined
. Previous it would pass the subject onnull
values as well. - cy.contains() can no longer be chained on subjects
which aren't
window
,document
orelement
. This brings it into parity with the new custom command rules and makes it much less "magical". It enforces you to use it in a much clearer way when querying the entire document. - Removed
Cypress.addParentCommand()
,Cypress.addChildCommand()
, andCypress.addDualCommand()
in favor of the new custom command interface.
Features:
chai-jQuery
assertions have improved error messaging, and have had their internal double assertions removed, and can now be made on raw DOM objects. Fixes #605.chai-jQuery
assertions now throw a nice error message when you're asserting on a non DOM object. Fixes #604.- New .trigger() command. Useful for triggering arbitrary events. Fixes #406.
- New cy.scrollTo() command. Useful for having a container scroll to a specific position. Fixes #497 & #313.
- New .scrollIntoView() command. Useful for scrolling an element into view. Fixes #498 & #313 & #519.
- Input ranges are now more easily testable using the new .trigger() command. See our new recipe for details on how. Fixes #287.
- Testing drag and drop is now possible using the new .trigger() command. See our new recipe for details on how. Fixes #386.
- Updated .click() command to accept more position arguments. Fixes #499.
- Added support to
.type()
for inputs of typedate
,time
,month
, andweek
. Fixes #27. - You can now pass a browser option to
cypress run as
--browser <browser name>
. This enables you to run the same set of browsers when running from the CLI as when you're running from the GUI. Fixes #462 and #531. - cypress open no longer opens a
detached process by default. Instead
cypress open
now accepts a new flag--detached
, which replicates this behavior. Fixes #531. - We have all new docker examples you can check out.
- The
cypress
npm package now checks the currently installed version oninstall
and run and does not re-install Cypress if it is already installed. Fixes #396. - We've added a new Cypress.Commands interface to handle adding your own custom commands. Fixes #436.
- You can now overwrite existing commands with Cypress.Commands.overwrite.
- We removed an artificial delay that was being set in between commands. This means test commands now run faster.
- You can now disable Cypress global exception handlers for your application. Fixes #254
- Uncaught errors appearing in your spec files or support files are now properly caught, have the right exit code, and display correctly. Fixes #345
- Cypress will now scroll past multiple elements that cover up an element to be
interacted with. It also now factors in elements with
position: sticky
. Fixes #571 and #565. - Cypress now scrolls all parent containers (not just
window
) when attempting to check an element's actionability. Fixes #569. - Using Chai.js's
assert
interface now works correctly in your specs. - Screenshots are now taken during each runnable that fails. Errors in tests will happen there. Errors in hooks will also happen there. Previously a screenshot would only happen after everything (including hooks) ran. Fixes #394
- cy.screenshot() now synchronizes its state with the reporter. This means you should see error messages (on the left side) on automatic screenshot errors.
- Using mocha's async
done
callback now works properly. - You can now programmatically intercept and potentially turn off uncaught application errors from failing your tests.
- You can now programmatically control whether you accept or cancel window.confirm() calls from your application.
Dependencies:
- Updated Cypress.Promise (which is Bluebird) from
version
2.9.25
to3.5.0
- Updated chai from version
1.9.2
to3.5.0
- Updated sinon from version
1.x
to3.2.0
- Updated jQuery from version
2.1.4
to2.2.4
. - Removed chai-jQuery and rewrote it from scratch.
Deprecations:
- The
cypress-cli
npm package has been deprecated. Fixes #316. - The interface for writing custom commands has been deprecated. Please read our docs on the new custom commands interface. Fixes #436 and #465.
- There are no more global, in-app updates. Versioning should be primarily
controlled via
npm
like every other package / dependency in your project. For users not usingnpm
you can manually download new versions of Cypress when they're released.
Bugfixes:
- Fixed busted internal timers that caused random timeouts, proxy errors, incorrect delays, and long pauses when loading the GUI. Fixes #572.
cy.route()
now matches requests opened with lowercase methods. Fixes #607.- Fixed regression where multiple uses of
cy.server()
in abefore
hook was throwing an error. Fixes #80 and #510 and #595. - When editing
cypress.json
file, the dead browser page no longer appears. Fixes #492. .type()
should now work on inputs regardless of capitalization oftype
attribute. Fixes #550.- Fixed issues where
.type()
was not appending text properly. Fixes #503 and #568. - Fixed issue where
.type()
withtype="email"
inputs were throwing an error. Fixes #504. - Fixed issue where using
.type()
on an input with atype
defined in uppercase (input type="TEXT"
) would throw an error and not type. Fixes #550. - Fixed issue with .clear() and
type="number"
inputs. Fixes #490. - Fixed issue where
cy.exec()
was failing when running Cypress in docker. Fixes #517. - Cypress CLI no longer requires
git
to install. Fixes #124 - Improved the reporter's responsive design so controls still show at narrower widths. Fixes #544.
- Commands text will no long cut off into ellipses when the Command Log is set to a wider width. Fixes #528.
- Fixed issue where setting
fixturesFolder
tofalse
would throw an error. Fixes #450. - Fixed issue where Cypress hanged due to Xvfb permissions. More intuitive output is given during install failures. Fixes #330.
- The checks used to determine an element's actionability are now run synchronously. This solves some circumstances where the element could have moved or otherwise change between the checks. Fixes #570.
- Fixed issue where clipped elements with
overflow-y: hidden
were falsely passing as "visible". Fixes #563. - When using
.select()
on a select with multiple options with the same value, we now properly setselectedIndex
andselectedOptions
on theselect
. Fixes #554. - Fixed issue where changing any spec file (renaming, adding, deleting) would remove the highlighted styling of the currently active spec file in the Test Runner. Fixes #547.
- We now get the absolute paths of styles to use when displaying snapshots. This will fix situations where some stylesheets were improperly referenced during the snapshot, so did not display styles correctly. Fixes #525.
- Fixed issue where commands would retry and potentially exceed their timeout values during page transitions. Fixes #594
- Fixed issue where server routes were lost after page load if not initiated by
a
cy.visit()
command. Fixes #177 - Using mocha's
done
callback now works correctly. We've improved mocha's handling of uncaught exceptions and properly associate them to test failures. - cy.viewport() is now synchronized with the UI so that it does not resolve until the DOM has re-rendered using the dimensions.
- "outer assertions" now are correctly retried by previous commands. Fixes #543.
- The example_spec from the kitchen-sink will never accidentally be seeded when running cypress run on a brand new project.
Misc:
- We now display a warning in the console when returning a promise from a test and also invoking a Promise or cy commands. Fixes #464.
- Reduced the number of internal Cypress network requests in the "Network Panel" of Dev Tools. Fixes #606.
- We've moved our entire codebase into one into a private "Monorepo". This is in anticipation for going open source (making the GitHub repo public) and should make it easier for everyone to contribute to our code. Fixes #256.
- When element's are not visible due to being covered by another element, the error message now says what element is covering what element. #611
- Improved the calculations to calculate an elements visibility. Additionally updated error messages to be clearer whenever an element isn't considered visible. Fixes #613
- The "Can't start server" error displayed in the Desktop-GUI no longer prevents you from interacting in the Desktop App. It now displays as a warning. Fixes #407.
cy.focused()
now automatically retries until the element exists in the DOM. This makes it behave the same as cy.get() Fixes #564 and #409.- We now support per-project
state.json
. Fixes #512. - We can now handle multiple projects per server. Fixes #512.
- The Test Runner can now have projects added by being 'dragged' in. Fixes .
- The Test Runner update window now has messaging about
package.json
versioning. Fixes #513. - The Test Runner now accounts for cypress being installed per project as npm module. Fixes #500 and #514.
- cypress install
-d
option. Fixes #389. - Exposing Cypress Binary should no longer be necessary when cypress is locally installed. Fixes #379.
- Added an 'App Data' option in the Desktop App that displays app data. Fixes #475.
- When
cy.spy()
orcy.stub()
are never called, the error now displays a clearer, grammatically correct error. Fixes #520. - Detection of installed browsers has been improved. Fixes #511.
- When commands are clicked on and logged into the console from the Command Log, they now display their 'yield' instead of 'return', since they really yield instead of return. #612
- The build process of the driver has been modernized. Fixes #429.
- XHR's from your application are no longer forcefully aborted between tests.
- Better error handling when running commands outside of a test.
- URL changes from navigation events or hashchanges now display more accurately.
- cy.go() now snapshots before and after the navigation event.
- Page load events no longer forcibly
null
out the current subject. This was very unexpected and difficult to debug. Now stale elements or other objects from previous pages are yielded to you. - Using an array of the same alias in a cy.wait() now yields you those XHR's in the order they were requested. Previously it was based on when the responses were returned.
- Returning
null
from a .then() will now change the subject to that. Previously returningnull
would not cause subject changes. - We now no longer remove spies, stubs, or routes at the end of the very last test. This enables you to continue to manually use your app and have Cypress continue to instrument it.
- Updated a few things to more aggressively cause GC.
- Onboarding dialogs will never show up again once they are dismissed. Fixes #522.
window.alert()
andwindow.confirm()
now generate a page event in the Command Log (including the message).cy.spy()
andcy.stub()
now have a.log(bool)
method to disable their calls from generating a Command Log. Useful when your spies or stubs are called an excessive number of times.- Improved command subject validation error messages.
- Improved the element detachment error messages (when you try to interact with an element that's become stale / detached from the document).
- We finally have partial iframe support. You can at least now cy.wrap() iframe elements and interact with them using Cypress commands. More work needs to be done to "switch into" and back "out of" iframes. But we're getting there.
- Scaffolding new projects no longer generates a
default.js
file. - Scaffolded
index.js
andcommands.js
have had their content updated to point to the custom commands API. - You can now call .focus() and .blur() on cy.window().
- The
CYPRESS_DEBUG
env option has been removed in favor of thedebug
module andDEBUG=cypress:*
usage. - Attempting to run cypress run on a
project without a
cypress.json
now errors instead of scaffolding and running the kitchen sink.
Documentation Changes:
Note: we are still updating all of the docs to reflect all the 0.20.0 changes.
- New "Catalog of Events"
- New "Cypress.Commands"
- New "Cypress.log"
- New ".trigger()"
- New "cy.scrollTo()"
- New ".scrollIntoView()"
- Updated "Installing Cypress"
- Updated "Writing Your First Test"
- Updated "Testing Your App"
- Updated "Command Line"
- Updated "Debugging"
- Updated "Assertions"
- Updated "Interacting with Elements"
0.19.4​
Released 06/18/2017
Bugfixes:
Fixed .type() not firing input
event for
React on versions 15.6.x. Fixes
#536.
0.19.3​
Released 06/14/2017
Bugfixes:
- Server's that send
Content-Encoding: br
no longer cause Cypress to fail due to incorrect decoding. Cypress now strips encodings it cannot accept. Fixes #535.
0.19.2​
Released 04/16/2017
Features:
- You can now run your tests in the
Electron browser that
comes built with Cypress. You will see it as an option in the browser
dropdown. This is the same browser that Cypress uses when running
cypress run
. This is useful for debugging issues that only occur during headless runs. Addresses #452. - New traversal commands
.nextAll()
,.nextUntil()
,.parentsUntil()
,.prevAll()
, and.prevUntil()
have been added. Addresses #432.
Bugfixes:
- An error is now thrown if an
undefined
value is mistakenly passed intocy.wait()
. Previously, it would set the command timeout to an unimaginably large number of ms. Fixes #332 - Fixed issue where the contents of
state.json
were emptied, which would cause a crash and loss of state information. Fixes #473 and #474. - We no longer write the chrome extension within
node_modules
, and instead write this to the proper OS specificappData
folder. Fixes #245 and #290.
Misc:
- Error handling for invalid arguments passed to
cy.wait()
have been improved and will now suggest valid arguments that are acceptable. - Browsers in the browser dropdown now have colored icons, which help visually distinguish the variants of Chrome.
- Increased timeout for browser to make a connection when running during
cypress run
from 10 seconds to 30 seconds. - Internally refactored how browsers are added and spawned in preparation of us adding cross browser support.
- Switching specs in the GUI now closes the browser and respawns it and refocuses it.
0.19.1​
Released 03/09/2017
Features:
- Added
Cypress.version
property. Fixes #404. - Selecting
<option>
inside<optgroup>
now works with.select()
. Fixes #367.
Bugfixes:
EMFILE
errors have been fixed. These were being caused due toulimit
being too low on your OS. This should fix the file watching problems people were having. Essentially we just replacedfs
withgraceful-fs
and crossed our fingers this works. (It did on our machines). Fixes #369.- Now you can select the error text in the GUI. Fixes #344.
- Cypress now correctly re-bundles files even when
watchForFileChanges
is set tofalse
. Fixes #446 and #347. - Fixed file watching when changing the
integrationFolder
to something other than the default value. Fixes #438. .select()
now works on options that have the same value. Fixes #441.- Cypress no longer crashes when you click links in the on-boarding screen called "To help you get started...". Fixes #227.
- The
example_spec.js
file that gets seeded on a new project no longer fails oncy.readFile()
. Fixes #414.
Misc:
- We now preserve the Test Runner's position and sizing after it's closed + reopened. Fixes #443.
- We now ignore watching
node_modules
,bower_components
and a few other folders to reduce the number of watched files. Fixes #437.
0.19.0​
Released 02/11/2017
Notes:
- We have updated all of the docs related to these changes. The CI Docs got a much needed facelift.
- There is a new docs section related to the Dashboard and the new features.
Overview:
- We have officially released our Dashboard which is our service that will display recorded runs.
- This service has now been fully integrated into the Desktop Application. There is a new on-boarding process that helps you setup projects for recording.
Breaking Changes:
- We have done our very best to create as little breaking changes as possible.
- You will need to download a new cypress-cli -
version
0.13.1
. - Older CLI versions will continue to work on
0.19.0
except for the cypress open command - and will we print a warning to nudge you to upgrade. - Newer CLI versions will not work on versions of Cypress <
0.19.0
(but we don't know why this would ever even happen).
Features:
- There is a new Dashboard service that displays your recorded runs.
- The Dashboard enables you to view your recorded runs, manage projects, create organizations, invite users and set permissions.
- Projects are either public with their runs being publicly viewable by anyone, or private which restricts their access to only users you've invited. All existing projects were set to private by default.
- When you invite users (from the Dashboard) we will automatically allow them. This means you can invite all of your teammates (or anyone else). They can start using Cypress without talking to us.
- We now list all of the recorded runs directly in the Test Runner under a new
Runs
tab. Fixes #236. - Your list of projects in the Test Runner now displays their last recorded run status - passing, failing, pending, running, etc.
- We've changed the "Config" tab to now be called "Settings". We added two new
sections to the "Settings" tab which displays your
projectId
and your Record Key. These sections do a much better job explaining what these are and how you use them. - You no longer have to use
cypress get:key
to get your Record Key. We now display this in your "Settings" tab and also in the Dashboard. - Projects will no longer automatically acquire a
projectId
when being added. There is now a very explicit opt-in process where you setup your project to record. This should make it much clearer what's going on behind the scenes. - cypress run now behaves likes
cypress ci
previously did and downloads + installs Cypress if it's not already installed. cypress ci
now works in OSX, and also works in Linux in Desktop flavors (like Ubuntu).
Misc:
- cypress run will now download and install Cypress if it is not already installed.
- We renamed
CYPRESS_CI_KEY
TOCYPRESS_RECORD_KEY
. This makes it clearer what this key actually does - and the fact that it can be run anywhere irrespective of CI. We still look for the old named key but will print a warning if we detect it. - We print a warning when using an older CLI tool version. Fixes #424.
- We've improved many of the error messages related to recording runs. Fixes #423.
cypress ci
has been deprecated. You now usecypress run --record --key <record_key>
. The key you used to pass tocypress ci
is the same key. We've consolidated these commands into just cypress run which makes it simpler and clearer. Their only difference is that passing--record
to cypress run will record the build to our Dashboard. Fixes #417.
0.18.8​
Released 02/05/2017
Overview:
- We have officially implemented our Sinon.JS
integration: adding
cy.stub()
,cy.spy()
,cy.clock()
, andcy.tick()
. We've matched Sinon's APIs and addedsinon-as-promised
andchai-sinon
. In addition we've fixed Sinon performance issues, and improved the display of assertion passes and failures. - These new APIs will work well in both
unit
tests andintegration
tests.
Features:
- You can now use
cy.stub()
andcy.spy()
synchronously. These both match the Sinon API identically. We will displaystub/spy
calls in the Command Log and provide the call count, arguments, context, and return values when you click on the log. Stubs are automatically reset between tests. Fixes #377. - We've added our own special aliasing flavor to
cy.stub()
andcy.spy()
. You can use the.as()
command and we will associate spy and stub invocations (the same way we do with XHR aliasing and route matching). - We've added
cy.clock()
andcy.tick()
which are both asynchronous methods to modify timers in your application under test. We automatically apply clock (even if you invoke it before your firstcy.visit()
) and will automatically reapply it after page load.cy.tick()
will enable you to control the amount of time you want passed in your application. This is great for controlling throttled or debounced functions. sinon-as-promised
is automatically applied under the hood which extends Sinon and provides the.resolves(...)
and.rejects(...)
APIs which makes it easy to stub promise returning functions.- We support and display multiple sub spies when using Sinon's
.withArgs(...)
function.
Misc:
- We've enhanced
chai-sinon
by improving the output during passes or failures. Fixes #31. - We've ripped out Sinon's argument serialization in favor of our own.
- We no longer send Sinon to the remote application under test. In other words,
you'll no longer see
sinon.js
being sent as a network request. - Deprecated the undocumented
cy.agents
function, but it will continue to work and will be officially removed later.
0.18.7​
Released 01/30/2017
Bugfixes:
- Fixed regression in
0.18.6
that caused Cypress to fail when switching spec files whenbaseUrl
was set incypress.json
. Fixes #403.
0.18.6​
Released 01/29/2017
Features:
- We now launch Cypress tests directly to the
baseUrl
to avoid an initial page refresh when encountering the firstcy.visit()
command. This should help tests run faster. Fixes #382.
Bugfixes:
- Uninstalling the last used browser no longer causes the Test Runner to error and hang. Fixes #371.
- Fixed issue where
stdout
would not be displayed on a completedcypress ci
run. Fixes #398. - Fixed a longstanding issue in Cypress where logging in from another computer
would kill the session on all other computers, and prevent you from accessing
cypress get:key
(amongst other things). Fixes #400.
Misc:
- We now validate all of the configuration options set in
cypress.json
to ensure it has valid types. Fixes #399. - We now validate that
baseUrl
is accessible prior to running tests. This prevents a common situation where you may forget to boot your web server and have instantly failing tests. Fixes #383. - We now show the entire scaffolded tree of files when adding a brand new project. Fixes #401.
- We display errors coming from
babel
with more helpful information now. - Changed the
Test Runner
to use
JWT
for authorization. You will have to log in again.
0.18.5​
Released 01/08/2017
Features:
- You can now disable
videoCompression
by passingfalse
incypress.json
or env variables. In very long runs and on CPU throttled instances compression can take a considerable amount of time, possibly as much as 50% of the time spent running actual tests. Fixes #372.
Misc:
- Improved performance when running
cypress run
by caching the last bundled spec. This prevents having the same spec file rebundled each timecy.visit()
caused a full page navigation. You should see a moderate improvement in test run time. Fixes #370. - We are now capturing
stdout
and several other properties for use + display in our Dashboard oncypress ci
runs. - Enable
cy.fixture()
to send an encoding for images other than forcing the default encoding ofbase64
. Fixes #373. - Enable
cy.route()
to pass anencoding
parameter when usingfx:fixture
syntax. Fixes #374.
0.18.4​
Released 12/28/2016
Bugfixes:
- Prevent
cy.url()
from accessing the URL during transition phase and throwing an error. Fixes #356. - Stubbed functions now serialize correctly when switching domains on a
cy.visit()
. Fixes #354. - Fixed a handful of scenarios and edge cases where cookies were not properly synchronized between external requests and the browser. This led to situations where cookies were either duplicated on requests, or were not sent. Fixes #357 and #361 and #362.
Misc:
cy.request()
now favorsbaseUrl
config over remote origin when you do not pass a fully qualified URL. Fixes #360.
0.18.3​
Released 12/18/2016
Features:
- There is now a
cy.log()
command for displaying an arbitrary message and args. Useful for providing context while testing and debugging long tests. Fixes #342.
Bugfixes:
cy.title()
now uses thedocument.title
property as opposed to querying for<title>
elements in the<head>
. Fixes #351 and #331.- We now exit correctly (with status of 1) in the case of headless renderer crashes. Additionally we capture these errors properly, explain what happened, and link to external error document to suggest fixes. Fixes #270 and #348.
Misc:
- Improved headless performance, and added optimizations for early and often GC.
0.18.2​
Released 12/15/2016
Bugfixes:
- Under the hood
cy.visit()
now sets anAccept: text/html,*/*
request header to prevent some web servers from sending back404
in the case where they required this header. Only a small % of servers would ever do this, butwebpack-dev-server
was one of them. Fixes #309. cy.request()
now sends anAccept: */*
request header by default too. Fixes #338.
Misc:
cy.request()
now includes more debugging information (related to headers) in the error output. Fixes #341.- When
cy.request()
times out, we now output much better error messages including information about the request sent. Fixes #340.
0.18.1​
Released 12/11/2016
Notes:
- There is a new recipe showcasing these new features.
- We are adding several other recipes to show examples of all the ways you can
use
cy.request()
to improve your tests.
Features:
cy.request()
can now have its automatic redirect following turned off by passing{followRedirect: false}
. Fixes #308.cy.request()
now has aqs
option that automatically appends query params to theurl
property. Fixes #321.cy.request()
now follows redirects exactly like a real browser. Previously if youPOST
ed to an endpoint and it redirected to aGET
thency.request()
would not follow it due to themethod
changing. It now follows method changing redirects by default. Fixes #322.cy.request()
now accepts theform
option which will convert thebody
values to urlencoded content and automatically set thex-www-form-urlencoded
header. This means you can now usecy.request()
to bypass your UI and login with standard form values. Fixes #319.- When
cy.request()
fails, it now outputs the full request / response information. This behaves more similar tocy.visit()
failures. Fixes #324. cy.request()
now prints all of the underlying HTTP request / response information into the Dev Tools' console (when clicking on the Command Log). This means that you will see everything you would normally see from theNetwork
tab as if the request were made from the browser. We even print redirect information. Fixes #325.
Bugfixes:
- Cypress' internal
babel
will no longer attempt to load your project's.babelrc
. This helps avoid potential version conflicts. Fixes #312. - We no longer watch the
supportFile
while runningcypress run
. Fixes #329. watchForFileChanges
is now correctly respected in regards to watching all files, including thesupportFile
. Fixes #336.- There is no longer an error when scaffolding a new Cypress project. Fixes #326.
- The Runner UI no longer appears to be "running" when there is a spec bundle
error in the
supportFile
. - Cypress now correctly exits during
cypress run
inlinux
when the browser fails to connect. Fixes #333. - Cypress now correctly exits during
cypress run
inlinux
when there is a spec bundle error. Fixes #337. - Cypress now retries up to 3 times for the browser to connect during
cypress run
. The warning / error messages were also updated to be clearer. Partially addresses #334.
Misc:
- Deprecated
failOnStatus
property forcy.request()
and renamed tofailOnStatusCode
. Fixes #323. - Removed the
cookies
option fromcy.request()
because cookies are now always get/set on requests. This option really never made any sense to have. Fixes #320. - Better data reporting when recording builds in CI.
- We now collect "global" errors that may prevent any tests from running. We will be displaying these in our future CI platform.
0.18.0​
Released 11/27/2016
Notes:
- We've created a new example recipes repo to show you common testing scenarios including how to use the new module support.
Summary:
- We've added automatic ES2015+, module, JSX, and CJSX support to all test
files. This means you can use
require
,import
, orexport
declarations to load other files. You can also use this to import your own application specific JavaScript modules and write unit tests for them. More of these details are yet to come. See this issue. - You can now use your regularly installed
node_modules
in your project to do things like utilizinglodash
for utility functions or extendingchai
with assertion plugins. - Because we're now processing the spec files prior to handing them off to the
browser, this means we will display problems like syntax errors when something
in the processing goes wrong. Additionally, we print these out during
cypress run
, so you're not stuck wondering what went wrong.
Breaking Changes:
- Previously, we auto-magically included all files within
cypress/support
. This has now gone away and we've simplified this to automatically including a singlecypress/support/index.js
file. That single file acts as the entry point meaning you shouldimport
orrequire
the other support files you'd like to include. Although this is still "automatic" it's much less magical and we'll be updating all of our docs to reflect this. The purpose ofcypress/support
hasn't really changed, just the implementation of it has. We will automatically seed acypress/support/index.js
file for you (even on existing projects). The file location ofcypress/support/index.js
can be changed with the newsupportFile
option in yourcypress.json
. This feature can also be turned off by specifyingsupportFile: false
.
Features:
- We now support ES2015+, modules, and JSX in all spec files. Fixes #246.
- Spec files may now be written as
.js
,.jsx
,.coffee
, orcjsx
files. - Test files with JS syntax errors are now
handled and we provide a GUI that points
to the exact line/column number. Additionally we print these out during
cypress run
and exit the process withcode 1
. Fixes #293.
Misc:
- We improved the logic around when and if we scaffold files on a new project. We're much smarter about this and not generating these forcibly every time. Fixes #285.
- Simplified handling of support files and made them less "magical". Fixes #286.
- Renamed
supportFolder
tosupportFile
incypress.json
. We will automatically rename yourcypress.json
if this property was present on update.
0.17.12​
Released 11/21/2016
Bugfixes:
- You no longer have to log in again after updating. Fixes #305.
- Updating in app now works again. Sorry about that. Fixes #304.
- Headless frame rate is now correctly set to
20
instead of resetting back to60
. Fixes #303. - We now automatically drop frames that the CPU cannot keep up with while video
recording during
cypress run
. Previously we would buffer all frames in memory and it was possible to exhaust all memory due to the way that streaming backpressure works. Fixes #302. - Fixed an edge case in the
driver
that could lead to memory leaks. This happened when Command Logs updated from previously run tests. Normally, in headless mode, we automatically remove references to purge memory after each test, but when logs were updated after this, their references were merged back in again and held onto forever. If you were seeing long Cypress runs die or eventually halt, this was likely the cause. We did extensive memory regression analysis on Cypress and could not find any more memory leaks. Fixes #301.
Misc:
- Improved cypress run and
cypress ci
headless output. Fixes #306. - Improved performance by preventing
snapshots
from being taken during headless runs.
0.17.11​
Released 11/16/2016
Roadmap:
- The changes in version
0.17.11
below are in preparation for Cypress platform service: a portal where screenshots, videos, config, and logs of your builds are accessible.
Overview:
cypress ci
now uploads build assets to our servers after a test run completes. Additionally, it tracks theconfig
settings used during the build and tracks each individual test failure.- If you do not want these assets to be tracked by Cypress, you need to switch to using cypress run. We will happily remove any build assets that are accidentally uploaded to us during the update transition.
Features:
- We now record videos during a headless run with both
cypress ci
and cypress run. Fixes #229. - After completing
cypress ci
, we now upload build assets (such asscreenshots
andvideos
) to be used in our upcoming admin interface. This will enable you to review assets without having to touch your CI server. Fixes #292.
Misc:
- We've redesigned the headless run
stdout
to give you more details of the run, the stats after the run, what screenshots were taken, the video that was recorded, compression settings for the video, uploading asset progress, etc. - Screenshot names now include their parent titles, and invalid file system characters are scrubbed. Fixes #297.
- We no longer artificially restrict the environment
cypress ci
can run in. It can now run anywhere. Fixes #296. - We removed scaffolding any directories on a new project (during
cypress run
). Fixes #295. - cypress run no longer prompts the user for any kind of interaction, thus enabling you to use this in CI if you choose to do so. Fixes #294.
- There is a new configuration property
called:
(This was changed totrashAssetsBeforeHeadlessRuns
trashAssetsBeforeRuns
in 3.0.0) that is set totrue
by default and will automatically clear out screenshots + videos folders before each run. These files are not deleted, they are just moved to your trash. - There are several new configuration
properties for video recording:
videoRecording
,videoCompression
, andvideosFolder
.
0.17.10​
Released 11/07/2016
Bugfixes:
- Fixed switching between two different spec files from the desktop app causing
document.domain
to be wrong. Fixes #276. - Fixed inserting the string
null
intocy.request()
urls when providing abaseUrl
incypress.json
while origin could not be determined. Fixes #274. - Fixed incorrect error message on reverse visibility assertions. Fixes #275.
Misc:
- We've improved the way we inject content into
<html>
responses by filtering the underlying HTTP request headers. We no longer inject content into templates which were loaded via XHR. Fixes #257 and #288.
0.17.9​
Released 10/22/2016
Bugfixes:
- Cypress now applies cookies to the browser which were cleared between redirects. Fixes #224.
- Snapshots now work even when
<html>
tag has invalid attributes. Fixes #271. - Cypress no longer crashes on initial
cy.visit()
when the 3rd party web server never ends the response. Fixes #272.
Misc:
- Changed default
responseTimeout
from20000
to30000
. - Changed default
pageLoadTimeout
from30000
to60000
. - The internal Cypress proxy now forcibly responds to requests taking longer
than
responseTimeout
. Currently this sends backtext/html
with theETIMEDOUT
error, but this likely needs to be configurable. The reason we are now forcibly applying timeouts is to preventsocket pooling exhaustion
where tests are running and a 3rd party server never responds to the request.
0.17.8​
Released 10/13/2016
Bugfixes:
- Fixed
opener of undefined
errors due topage load
events causing snapshots prior to theload
event of the remote application. Thanks to everyone who helped pitched in on this one! Fixes #258. - Cypress now correctly sets cookies with
expirationDate
in the past. Chrome did not handle these cookies as documented and our code did not take this into account. We also added a lot moree2e
tests around this behavior. Fixes #266. - We are now taking additional precautions to prevent Cypress from trashing the
wrong folder during an upgrade (with an open project). This was actually fixed
in
0.17.7
but the problem was is that during an update, the new version (which was fixed) was still being passed the wrong arguments from the older (broken) application. We've now upgraded0.17.8
to detect this, and just use the expected default install location of Cypress. If you're concerned, just close your currently open project before updating. Fixes #265.
Misc:
- When an in app update fails in
linux
we now provide instructions on how to manually update Cypress. - We now properly take the
maxAge
cookie flag into account and give it preference over theexpires
flag as per the cookie spec.
0.17.7​
Released 10/12/2016
Features:
- There is now a new
chromeWebSecurity
option you can set incypress.json
to turn off Chrome's Web Security features. We've written a brand new reference that details why and how you could use this. Cypress Web Security. This option can be used for accessingcross origin
<iframes>
or if your application needs to test navigation across super domains. Fixes #262.
Bugfixes:
- We now capture
cross origin
errors correctly instead of these showing asUncaught DOMExceptions
in the console. Fixes #261. - We no longer trash the wrong folder on OSX in-app updates (when a project is open). Sorry about this! Fixes #260.
cy.visit()
urls with domain-like segments (which weren't actually the domain) no longer cause Cypress to think you're trying to navigate to a different superdomain. Fixes #255.
0.17.6​
Released 10/04/2016
Features:
- Snapshots will now be pinned when clicking on a command in the Command Log. This enables you to inspect the state of the DOM when the snapshot was taken. We've given you a new series of controls for turning off the element highlighting and hitboxes. Additionally we've given you the ability to manually click through each named snapshot when there are multiple states (like before and after). Fixes #247.
Bugfixes:
- Fixed a regression where tests that failed outside of a hook would incorrectly
indicate themselves as a
before each
hook. In addition, in the defaultspec
, reporter will now display the test name when a hook was the source of failure. Fixes #253. - Fixed a deployment bug in the
core-desktop-gui
. - We now prevent
cy.visit()
from accidentally snapshotting twice.
Misc:
cy.request()
andcy.visit()
now correctly sendUser-Agent
headers based on the current open browsing session. Fixes #230.
0.17.5​
Released 10/02/2016
Features:
- We've added
JUnit
as a valid built-in reporters. Fixes #178. - You can now
add or write your own custom reporters. This
means you can
npm install xyz-mocha-reporter
and we'll automatically correctlyrequire
that package. Alternatively you can write your ownxyz-custom_reporter.js
file. Fixes #231. - The
reporter
can now be resized. We persist this state locally so it should "stick" between browser launches / app restarts. Fixes #204. - Cypress now "remembers" the last browser you had open and will suggest opening that whenever a project is opened. Addresses #193.
- Instead of seeing
Script error.
- cross origins script errors are now handled specially and we throw a very long and exciting error explaining what just happened. Fixes #241. - When uncaught errors are thrown in hooks we now indicate Mocha's behavior as part of the error - that it is skipping the remaining tests in the current suite. Fixes #240.
Bugfixes:
- The reporter now more intelligently scrolls to prevent commands from being cut off. Useful in screenshots / video recording. Fixes #228.
- We've improved the logic of ho