@@ -1137,12 +1137,30 @@ Mailer Assertions
1137
1137
address. This assertion normalizes addresses like ``Jane Smith
1138
1138
1139
1139
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.
1146
1164
1147
1165
Learn more
1148
1166
----------
@@ -1166,3 +1184,5 @@ Learn more
1166
1184
.. _`SymfonyMakerBundle` : https://symfony.com/doc/current/bundles/SymfonyMakerBundle/index.html
1167
1185
.. _`PHPUnit Assertion` : https://docs.phpunit.de/en/9.6/assertions.html
1168
1186
.. _`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