[docs] Add a reCAPTCHA article (#5204)

* Add a reCAPTCHA article * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse <dirk.pieterse@devexpress.com> * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse <dirk.pieterse@devexpress.com> * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse <dirk.pieterse@devexpress.com> * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse <dirk.pieterse@devexpress.com> * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse <dirk.pieterse@devexpress.com> Co-authored-by: DirkPieterse <dirk.pieterse@devexpress.com>
DevExpress · Jun 18, 2020 · 43a0a08 · 43a0a08
1 parent c3406f7
commit 43a0a08
Show file tree

Hide file tree

Showing 4 changed files with 36 additions and 1 deletion.
diff --git a/docs/README.md b/docs/README.md
@@ -193,19 +193,24 @@
       * [createBrowserConnection](articles/documentation/reference/testcafe-api/testcafe/createbrowserconnection.md)
       * [createLiveModeRunner](articles/documentation/reference/testcafe-api/testcafe/createlivemoderunner.md)
       * [createRunner](articles/documentation/reference/testcafe-api/testcafe/createrunner.md)
+  * Plugin API
+    * [BrowserProvider Interface](articles/documentation/reference/plugin-api/browserprovider.md)
+    * [Reporter Interface](articles/documentation/reference/plugin-api/reporter.md)
 * [Recipes](articles/documentation/recipes/README.md)
   * Basics
-    * [Test \<select\> Elements](articles/documentation/recipes/basics/test-select-elements.md)
+    * [Test &lt;select&gt; Elements](articles/documentation/recipes/basics/test-select-elements.md)
     * [Test Static HTML Pages](articles/documentation/recipes/basics/test-static-html-pages.md)
     * [Test on Remote Computers and Mobile Devices](articles/documentation/recipes/basics/test-on-remote-computers-and-mobile-devices.md)
   * Best Practices
     * [Create Helpers](articles/documentation/recipes/best-practices/create-helpers.md)
     * [Create Data-Driven Tests](articles/documentation/recipes/best-practices/create-data-driven-tests.md)
   * Integrations
     * [Import Third-Party Modules](articles/documentation/recipes/integrations/import-third-party-modules.md)
+    * [Testing Library API](articles/documentation/recipes/integrations/use-testing-library-api.md)
     * [Angular CLI Builder](articles/documentation/recipes/integrations/use-angular-cli-builder.md)
     * [Gulp](articles/documentation/recipes/integrations/gulp.md)
     * [Grunt](articles/documentation/recipes/integrations/grunt.md)
+    * [Test Websites That Use reCAPTCHA](articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md)
     * [Flow Type Checker](articles/documentation/recipes/integrations/find-code-issues-with-flow-type-checker.md)
   * Configuration
     * [Access Environment Variables in Tests](articles/documentation/recipes/configuration/access-environment-variables-in-tests.md)

diff --git a/docs/articles/documentation/recipes/README.md b/docs/articles/documentation/recipes/README.md
@@ -28,6 +28,7 @@ This section provides examples and recipes of how to use TestCafe in different s
 * [Angular CLI Builder](integrations/use-angular-cli-builder.md)
 * [Gulp](integrations/gulp.md)
 * [Grunt](integrations/grunt.md)
+* [Test Websites That Use reCAPTCHA](integrations/test-websites-that-use-recaptcha.md)
 * [Flow Type Checker](integrations/find-code-issues-with-flow-type-checker.md)
 
 **Configuration**

diff --git a/...articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md b/...articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md
@@ -0,0 +1,27 @@
+---
+layout: docs
+title: Test Websites That Use reCAPTCHA
+permalink: /documentation/recipes/integrations/test-websites-that-use-recaptcha.html
+---
+# Test Websites That Use reCAPTCHA
+
+TestCafe does not implement mechanisms that circumvent CAPTCHA challenges. However, many CAPTCHA providers allow you to disable or simulate the verification in test environments.
+
+This topic describes how to configure reCAPTCHA for TestCafe tests.
+
+## reCAPTCHA v3
+
+Create a separate key for testing environments in the [reCAPTCHA admin console](https://www.google.com/recaptcha/admin/create). Then follow the instructions on the page to use this key when you build the site for testing.
+
+> Scores may not be accurate in testing environments as reCAPTCHA v3 relies on real traffic.
+
+Alternatively, you can change the `score` threshold or disable the reCAPTCHA check in your development build.
+
+## reCAPTCHA v2
+
+Use the following test keys that generate the `No CAPTCHA` response and pass all verification requests:
+
+**Site key**: `6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI`  
+**Secret key**: `6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe`
+
+With these keys, the reCAPTCHA widget shows a warning message that indicates reCAPTCHA is not used for production traffic.
diff --git a/docs/nav/nav-menu.yml b/docs/nav/nav-menu.yml
@@ -426,6 +426,8 @@
       url: /documentation/recipes/integrations/gulp.md
     - name: Grunt
       url: /documentation/recipes/integrations/grunt.md
+    - name: Test Websites That Use reCAPTCHA
+      url: /documentation/recipes/integrations/test-websites-that-use-recaptcha.md
     - name: Flow Type Checker
       url: /documentation/recipes/integrations/find-code-issues-with-flow-type-checker.md
   - name: Configuration