From 43a0a08ec0c7b82dc4552d25ff8f1904c88fdcff Mon Sep 17 00:00:00 2001 From: Vasily Strelyaev Date: Thu, 18 Jun 2020 13:03:54 +0300 Subject: [PATCH] [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 * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse * Update docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md Co-authored-by: DirkPieterse Co-authored-by: DirkPieterse --- docs/README.md | 7 ++++- docs/articles/documentation/recipes/README.md | 1 + .../test-websites-that-use-recaptcha.md | 27 +++++++++++++++++++ docs/nav/nav-menu.yml | 2 ++ 4 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md diff --git a/docs/README.md b/docs/README.md index 7d3ee587fd..ce2d8d0810 100644 --- a/docs/README.md +++ b/docs/README.md @@ -193,9 +193,12 @@ * [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 \ Elements](articles/documentation/recipes/basics/test-select-elements.md) + * [Test <select> 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 @@ -203,9 +206,11 @@ * [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 index d3ba1bbf83..28d9520afd 100644 --- 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/docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md b/docs/articles/documentation/recipes/integrations/test-websites-that-use-recaptcha.md new file mode 100644 index 0000000000..abc24e0a01 --- /dev/null +++ b/docs/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 index c08c864fc3..9ec5d82b96 100644 --- 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