Skip to content

Commit d00625d

Browse files
[Testing] Mention Panther for E2E tests
1 parent 633c448 commit d00625d

File tree

1 file changed

+26
-6
lines changed

1 file changed

+26
-6
lines changed

testing.rst

Lines changed: 26 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1137,12 +1137,30 @@ Mailer Assertions
11371137
address. This assertion normalizes addresses like ``Jane Smith
11381138
11391139

1140-
.. TODO
1141-
.. End to End Tests (E2E)
1142-
.. ----------------------
1143-
.. * panther
1144-
.. * testing javascript
1145-
.. * UX or form collections as example?
1140+
End to End Tests (E2E)
1141+
~~~~~~~~~~~~~~~~~~~~~~
1142+
1143+
End to end tests (E2E) are a special type of application tests that
1144+
simulate a real user interacting with your application. They are
1145+
typically used to test the user experience (UX) of your application.
1146+
The difference with functional tests detailed above is that E2E tests
1147+
use a real browser instead of a simulated one. This browser can run in
1148+
headless mode (without a graphical interface) or not. The first option
1149+
is convenient for running tests in a Continuous Integration (CI), while
1150+
the second one is useful for debugging purpose.
1151+
1152+
This is the purpose of `Panther`_, a library that provides a real browser
1153+
to run your tests. Here are a few things that make Panther special, compared
1154+
to other End to End testing tools:
1155+
1156+
* Possibility to take screenshots of the browser at any time during the test
1157+
* The JavaScript code contained in webpages is executed
1158+
* Panther supports everything that Chrome (or Firefox) implements
1159+
* Convenient way to test real-time applications (e.g. WebSockets, Server-Sent Events
1160+
with Mercure, etc.)
1161+
1162+
You can learn more about Panther and how to use it by visiting the
1163+
`Github page of Panther`_, where you'll also find its detailed documentation.
11461164

11471165
Learn more
11481166
----------
@@ -1166,3 +1184,5 @@ Learn more
11661184
.. _`SymfonyMakerBundle`: https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
11671185
.. _`PHPUnit Assertion`: https://docs.phpunit.de/en/9.6/assertions.html
11681186
.. _`section 4.1.18 of RFC 3875`: https://tools.ietf.org/html/rfc3875#section-4.1.18
1187+
.. _`Panther`: https://github.com/symfony/panther
1188+
.. _`Github page of Panther`: https://github.com/symfony/panther

0 commit comments

Comments
 (0)