Skip to content

Commit b0677f5

Browse files
Update why cypress to more closely integrate our Cloud features
1 parent e096abb commit b0677f5

File tree

1 file changed

+68
-36
lines changed

1 file changed

+68
-36
lines changed

docs/guides/overview/why-cypress.mdx

Lines changed: 68 additions & 36 deletions
Original file line numberDiff line numberDiff line change
@@ -21,53 +21,54 @@ sidebar_position: 10
2121
## In a nutshell
2222

2323
Cypress is a next generation front end testing tool built for the modern web.
24-
We address the key pain points developers and QA engineers
25-
face when testing modern applications.
24+
We address the key pain points teams
25+
face when testing modern applications and maintaining test suites.
2626

2727
We make it possible to:
2828

29-
- [Set up tests](#Setting-up-tests)
30-
- [Write tests](#Writing-tests)
31-
- [Run tests](#Running-tests)
32-
- [Debug Tests](#Debugging-tests)
29+
- [Set up tests](#Set-up-tests)
30+
- [Write tests](#Write-tests)
31+
- [Run tests](#Run-tests)
32+
- [Debug Tests](#Debug-tests)
33+
- [Integrate with CI](#Integrate-with-CI)
34+
- [Optimize your Test Suite](#Integrate-with-CI)
35+
- [Debug Tests from CI](#Integrate-with-CI)
36+
- [Analyze Testing Trends](#Integrate-with-CI)
37+
- [Integrate into your workflow](#Integrate-with-CI)
3338

34-
Cypress is most often compared to Selenium; however Cypress is both
35-
fundamentally and architecturally different. Cypress is not constrained by the
36-
same restrictions as Selenium.
3739

38-
This enables you to **write faster**, **easier** and **more reliable** tests.
40+
Cypress is most often compared to Selenium; however Cypress is both
41+
fundamentally and architecturally different. [See our comparison of Cypress vs Selenium](https://www.cypress.io/comparison/selenium).
3942

4043
## Who uses Cypress?
4144

42-
Our users are typically developers or QA engineers building web applications
43-
using modern JavaScript frameworks.
45+
Our users are typically developers, QA engineers, and teams looking to build web applications and increase the quality of their existing application.
4446

45-
Cypress enables you to write all types of tests:
47+
Cypress enables you to write:
4648

4749
- [End-to-end tests](/guides/end-to-end-testing/writing-your-first-end-to-end-test)
4850
- [Component tests](/guides/component-testing/overview)
49-
- Integration tests
50-
- Unit tests
51+
- API tests
5152

5253
Cypress can test anything that runs in a browser.
5354

5455
## Cypress ecosystem
5556

5657
Cypress consists of a free,
5758
[open source](https://github.com/cypress-io/cypress),
58-
[locally installed](/guides/getting-started/installing-cypress) application
59-
**and** Cypress Cloud for [recording your tests](/guides/cloud/introduction).
59+
[locally installed](/guides/getting-started/installing-cypress) app
60+
**and** [Cypress Cloud](/guides/cloud/introduction) for recording tests, surfacing test results, and providing test analytics.
6061

6162
- **First:** Cypress helps you set up and start writing tests every day while
6263
you build your application locally. _TDD at its best!_
6364
- **Later:** After building up a suite of tests and
6465
[integrating Cypress](/guides/continuous-integration/introduction) with your
6566
CI Provider, [Cypress Cloud](/guides/cloud/introduction) can record your test
66-
runs. You'll never have to wonder: _Why did this fail?_
67+
runs surfacing exactly what happened during the test in [Test Replay](/guides/cloud/test-replay). You'll never have to wonder: _Why did this fail?_
6768

6869
## Our mission
6970

70-
Our mission is to build a thriving, open source ecosystem that enhances
71+
Our mission is to build a thriving testing solution that enhances
7172
productivity, makes testing an enjoyable experience, and generates developer
7273
happiness. We hold ourselves accountable to champion a testing process **that
7374
actually works**.
@@ -95,7 +96,9 @@ that makes everyone happy.
9596
## Features
9697

9798
Cypress comes fully baked, batteries included. Here is a list of things it can
98-
do that no other testing framework can:
99+
do:
100+
101+
#### Cypress App
99102

100103
- **Time Travel:** Cypress takes snapshots as your tests run. Hover over
101104
commands in the [Command Log](/guides/core-concepts/cypress-app#Command-Log)
@@ -115,12 +118,13 @@ do that no other testing framework can:
115118
involving your server. You can stub network traffic however you like.
116119
- **Consistent Results:** Our architecture doesn't use Selenium or WebDriver.
117120
Say hello to fast, consistent and reliable tests that are flake-free.
118-
- **Screenshots, Videos, and Test Replay:** View screenshots taken automatically on failure,
119-
or videos, if enabled, of your entire test suite when run from the CLI. Record
120-
to [Cypress Cloud](/guides/cloud/introduction) and replay the test as it executed during the run for zero-configuration debugging using [Test Replay](/guides/cloud/test-replay).
121121
- **Cross Browser Testing:** Run tests within Firefox and Chrome-family browsers
122122
(including Edge and Electron) locally and
123-
[optimally in a Continuous Integration pipeline](/guides/guides/cross-browser-testing).
123+
[in a Continuous Integration pipeline](/guides/guides/cross-browser-testing).
124+
125+
#### Cypress Cloud
126+
127+
**Test Replay:** Record to [Cypress Cloud](/guides/cloud/introduction) and replay the test exactly as it executed during the run for zero-configuration debugging using [Test Replay](/guides/cloud/test-replay).
124128
- **Smart Orchestration:** Once you're set up to record to Cypress Cloud, easily
125129
[parallelize](/guides/cloud/smart-orchestration/parallelization) your test
126130
suite, rerun failed specs first with
@@ -130,35 +134,67 @@ do that no other testing framework can:
130134
tight feedback loops.
131135
- **Flake Detection:** Discover and diagnose unreliable tests with Cypress
132136
Cloud's [Flaky test management](/guides/cloud/flaky-test-management).
137+
- **Branch Review:** Quickly identify the impact a pull request might have on your test suite in a single view using [Branch Review](/guides/cloud/branch-review). Compare which tests are failing, flaky, pending, added, or modified between the source and base branches and prevent the merging of low-quality code.
138+
- **Integrations:** Integrate with [GitHub](/guides/cloud/integrations/source-control/github), [GitLab](/guides/cloud/integrations/source-control/gitlab), or [Bitbucket](/guides/cloud/integrations/source-control/bitbucket) to see test results directly on every push or pull request. Cypress Cloud also integrates with
139+
[Slack](/guides/cloud/integrations/slack), [Jira](/guides/cloud/integrations/jira), and [Microsoft Teams](/guides/cloud/integrations/teams) to keep your team in the loop.
140+
- **Test Analytics:** Track test results over time with [Test Analytics](/guides/cloud/analytics) to identify trends, regressions, and improvements in your test suite. Use our [Data Extract API](/guides/cloud/integrations/data-extract-api) to extract the data that is important to your team.
133141

134-
### <Icon name="cog" /> Setting up tests
142+
### <Icon name="cog" /> Set up tests
135143

136144
There are no servers, drivers, or any other dependencies to install or
137-
configure. You can quickly see your first passing test using template example test specs for
145+
configure. You can quickly see your first passing test within minutes for
138146
[End-to-end tests](/guides/end-to-end-testing/writing-your-first-end-to-end-test) or
139147
[Component tests](/guides/component-testing/getting-started).
140148

141-
### <Icon name="code" /> Writing tests
149+
### <Icon name="code" /> Write tests
142150

143-
Tests written in Cypress are meant to be easy to read and understand. Our API
151+
Tests written in Cypress are meant to be easy to read and understand. Our [API](/api/table-of-contents)
144152
comes fully baked, on top of tools you are familiar with already.
145153

146154
<DocsVideo src="/img/snippets/writing-tests.mp4" title="Writing Tests" />
147155

148-
### <Icon name="play-circle" /> Running tests
156+
### <Icon name="play-circle" /> Run tests
149157

150158
Cypress runs as fast as your browser can render content. You can watch tests run
151-
in real time as you develop your applications. TDD FTW!
159+
in real time as you develop your applications and time travel to previous steps. TDD FTW!
152160

153161
<DocsVideo src="/img/snippets/running-tests.mp4" title="Running Tests" />
154162

155-
### <Icon name="bug" /> Debugging tests
163+
### <Icon name="bug" /> Debug tests
156164

157165
Readable error messages help you to debug quickly. You also have access to all
158166
the developer tools you know and love.
159167

160168
<DocsVideo src="/img/snippets/debugging.mp4" title="Debugging Tests" />
161169

170+
### <Icon name="bug" /> Integrate with CI
171+
172+
Cypress can be easily integrated into your CI provider. We have guides for all
173+
the popular CI providers. You can also use [Cypress GitHub Action](/guides/guides/github-actions) to run your tests.
174+
175+
### <Icon name="bug" /> Optimize your Test Suite
176+
177+
Cypress can run tests in parallel, and you can group test runs by browser or
178+
device. You can also run tests in a headless mode to speed up your test suite.
179+
180+
### <Icon name="bug" /> Replay Tests
181+
182+
With [Cypress Cloud](/guides/cloud/introduction), you can record your tests and replay them exactly as they
183+
executed during the run and debug using [Test Replay](/guides/cloud/test-replay).
184+
185+
### <Icon name="bug" /> Integrate into your workflow
186+
187+
Cypress Cloud integrates with GitHub, GitLab, and Bitbucket to see test results
188+
directly on every push or pull request. You can also integrate with Slack, Jira,
189+
and Microsoft Teams to keep your team in the loop.
190+
191+
### <Icon name="bug" /> Analyze Testing Trends
192+
193+
Track test results over time with [Test Analytics](/guides/cloud/analytics) to
194+
identify trends, regressions, and improvements in your test suite. Use our [Data
195+
Extract API](/guides/cloud/integrations/data-extract-api) to extract the data
196+
that is important to your team.
197+
162198
## Test types
163199

164200
Cypress can be used to write several different types of tests. This can provide
@@ -225,11 +261,7 @@ it('adds a todo', () => {
225261
### Other
226262

227263
Finally, through a large number of [official and 3rd party plugins](/plugins)
228-
you can write Cypress [a11y](https://github.com/component-driven/cypress-axe),
229-
230-
<a href="/plugins#visual-testing">visual</a>,
231-
[email](/faq/questions/using-cypress-faq#How-do-I-check-that-an-email-was-sent-out)
232-
and other types of tests.
264+
you can write other types of tests.
233265

234266
## Cypress in the Real World
235267

0 commit comments

Comments
 (0)