Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ce document liste les problèmes d'intégration reCAPTCHA courants que les développeurs peuvent rencontrer lorsqu'ils utilisent reCAPTCHA dans leur environnement.
SecurityError: blocked a frame with origin "https://www.google.com" from accessing a frame with origin "<your domain>"
Cela se produit généralement si l'élément HTML du widget reCAPTCHA est supprimé de manière programmatique après que l'utilisateur final a cliqué sur la case à cocher.
Nous vous recommandons d'utiliser la fonction JavaScript grecaptcha.enterprise.reset() pour réinitialiser le widget reCAPTCHA.
L'hôte local ne figure pas dans la liste des domaines acceptés
Les domaines localhost ne sont pas acceptés par défaut. Si vous souhaitez continuer à les prendre en charge pour le développement, vous pouvez les ajouter à la liste des domaines acceptés pour votre clé de site.
Accédez à la consoleGoogle Cloud pour mettre à jour votre liste de domaines compatibles. Nous vous conseillons d'utiliser des clés distinctes pour le développement et la production, et de n'autoriser que localhost sur la clé de votre site de développement.
reCAPTCHA a renvoyé BROWSER_ERROR lors de la création d'une évaluation
Les jetons BROWSER_ERROR se produisent lorsque le script reCAPTCHA ne peut pas effectuer une opération execute. Dans la plupart des cas, cela est dû à un échec ou à un délai d'expiration du réseau côté client. Vous devez réessayer execute() à l'aide de JavaScript.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[],[],null,["# Troubleshoot reCAPTCHA integration issues\n\n\u003cbr /\u003e\n\nThis document lists common reCAPTCHA integration issues that\ndevelopers might encounter when using reCAPTCHA in their environment.\n| **Note:** If you're an end user experiencing issues with reCAPTCHA visual challenges, ensure that your browser is up to date or try a different browser. If the problem persists, contact the website's support team.\n\nInvalid site key\n----------------\n\nIf you see the `Invalid site key` error, your reCAPTCHA\nsite key is no longer valid. [Create a new key](/recaptcha/docs/create-key-website)\nand [install it on your web pages](/recaptcha/docs/instrument-web-pages).\n\nKeys migration failure\n----------------------\n\nSite keys can fail to migrate in one of the following scenarios:\n\n- You've exceeded the number of projects that you\n or your organization can create.\n\n To resolve this, you can reuse an\n existing project, [request an increase in project creation quota](https://support.google.com/cloud/answer/7283050),\n or wait for the automated migration to complete.\n- Your workspace organization has restricted creating of new Google Cloud\n projects.\n\n To turn on the Google Cloud service in the Google Admin console,\n contact your administrator. For more information, see\n [Turn Google Cloud on or off for users](https://support.google.com/a/answer/182442).\n\nSecurityError: blocked a frame with origin \"https://www.google.com\" from accessing a frame with origin \"\\<your domain\\>\"\n----------------------------------------------------------------------------------------------------------------------------\n\nThis typically occurs if the reCAPTCHA widget HTML element is\nprogrammatically removed sometime after the end user clicks on the checkbox.\nWe recommend using the [grecaptcha.enterprise.reset()](/recaptcha/docs/api-ref-checkbox-keys#grecaptchaenterprisereset)\nJavaScript function to reset the reCAPTCHA widget.\n\nLocalhost is not in the list of supported domains\n-------------------------------------------------\n\nLocalhost domains are not supported by default. If you want to continue\nsupporting them for development, you can add them to the list of supported\ndomains for your site key.\nGo to the [Google Cloud console](https://console.cloud.google.com/security/recaptcha)\nto update your list of supported domains. We advise to use separate keys for\ndevelopment and production, and to only allow localhost on your development site\nkey.\n\nreCAPTCHA returned BROWSER_ERROR when creating an assessment\n------------------------------------------------------------\n\n`BROWSER_ERROR` tokens occur when the reCAPTCHA script cannot perform\nan `execute` operation. In most cases, this is due to a client-side network\nfailure or timeout. You must retry `execute()` using the JavaScript."]]
