Cette page décrit les méthodes de l'API JavaScript reCAPTCHA Enterprise et leurs paramètres de configuration que vous pouvez utiliser pour afficher les pages Web avec une clé reCAPTCHA (clé de site).
Méthodes de l'API JavaScript reCAPTCHA Enterprise
Cette section décrit la syntaxe et les paramètres des méthodes de l'API JavaScript reCAPTCHA Enterprise.
grecaptcha.enterprise.render
Affiche le conteneur sous forme de widget reCAPTCHA et renvoie l'ID du widget créé.
Syntaxe
grecaptcha.enterprise.render(container: string | HTMLelement, parameters: Object): number
Paramètres de méthode
Paramètres | Description |
---|---|
container | Élément HTML permettant d'afficher le widget reCAPTCHA. Spécifiez l'ID du conteneur (chaîne) ou l'élément DOM lui-même. |
parameters |
Objet contenant des paramètres sous forme de paires clé=valeur (par exemple, Pour en savoir plus sur chaque paramètre configurable, consultez la section Attributs et paramètres. |
Valeur renvoyée
Renvoie l'ID du widget créé.
grecaptcha.enterprise.reset
Réinitialise le widget reCAPTCHA.
Syntaxe
grecaptcha.enterprise.reset(widget_id: number): void
Paramètres
Paramètre | Description |
---|---|
widget_id | Facultatif. ID de widget renvoyé par grecaptcha.enterprise.render() . S'il n'est pas spécifié, il utilise par défaut l'ID du premier widget créé.
|
Valeur renvoyée
Ne renvoie pas de valeur.
grecaptcha.enterprise.execute
Il appelle de manière automatisée la validation de reCAPTCHA Enterprise.
Syntaxe
grecaptcha.enterprise.execute(widget_id: number): Promise<string>
grecaptcha.enterprise.execute(sitekey: string, action: Object): Promise<string>
Paramètres
Paramètre | Description |
---|---|
widget_id | Facultatif. ID de widget renvoyé par grecaptcha.enterprise.render() .
S'il n'est pas spécifié, il utilise par défaut l'ID du premier widget créé. |
sitekey |
Spécifiez la clé du site reCAPTCHA à protéger. |
action | Objet avec une seule paire clé/valeur, où la valeur de la clé action spécifie le nom de l'action associé à l'élément protégé.
Par exemple : |
Valeur renvoyée
Si la requête aboutit, renvoie un objet Promise contenant le jeton en cas de succès.
grecaptcha.enterprise.ready
Exécute votre fonction lorsque la bibliothèque JavaScript de reCAPTCHA Enterprise se charge.
Syntaxe
grecaptcha.enterprise.ready(callback: function): void
Paramètres
Paramètre | Description |
---|---|
callback | Fonction à appeler lorsque le chargement de la bibliothèque reCAPTCHA est terminé. |
Valeur renvoyée
Ne renvoie pas de valeur.
grecaptcha.enterprise.getResponse
Récupère la réponse du widget reCAPTCHA.
Syntaxe
grecaptcha.enterprise.getResponse(widget_id: number): string
Paramètres
Paramètre | Description |
---|---|
widget_id | Facultatif. ID de widget renvoyé par grecaptcha.enterprise.render() . S'il n'est pas spécifié, il utilise par défaut l'ID du premier widget créé.
|
Valeur renvoyée
Récupère la réponse du widget reCAPTCHA. Il peut s'agir d'une chaîne avec le jeton créé par grecaptcha.enterprise.execute()
ou d'une chaîne vide si le jeton n'a pas encore été créé.
Configuration
Cette section décrit les paramètres de ressource JavaScript, les paramètres utilisés par grecaptcha.enterprise.render()
et les attributs du widget g-recaptcha
.
Paramètres de ressource JavaScript (enterprise.js)
Le tableau suivant répertorie les paramètres de la ressource JavaScript (enterprise.js
) que vous devez inclure lorsque vous utilisez reCAPTCHA Enterprise.
Pour en savoir plus sur l'utilisation de ces paramètres, consultez les exemples de la section Afficher le widget reCAPTCHA sur l'interface.
Paramètres | Valeur | Description |
---|---|---|
onload |
callback | Facultatif. Nom de la fonction de rappel à exécuter une fois toutes les dépendances chargées. |
render
|
onload |
Facultatif, valeur par défaut. Affiche le widget dans la première balise |
explicit
|
Facultatif. N'affiche pas le widget automatiquement. Vous devez appeler |
|
siteKey |
Lorsqu'il est utilisé avec des clés de site basées sur des scores, ce paramètre n'est pas facultatif. La valeur siteKey spécifie la clé de site basée sur des scores associée. |
|
hl |
Voir les codes de langue | Facultatif. Force l'affichage du widget dans une langue spécifique. Si aucune valeur n'est spécifiée, détecte automatiquement la langue de l'utilisateur. |
Attributs de tag g-recaptcha et paramètres grecaptcha.enterprise.render()
Le tableau suivant répertorie les attributs de tag g-recaptcha
et les paramètres grecaptcha.enterprise.render()
correspondants.
Attribut de tag g-recaptcha |
Paramètre grecaptcha.enterprise.render() |
Valeurs autorisées | Par défaut | Description |
---|---|---|---|---|
data-sitekey |
sitekey |
Clé reCAPTCHA. | ||
data-badge |
badge |
bottomright , bottomleft et inline
|
bottomright |
Facultatif. Repositionnez le badge reCAPTCHA. inline vous permet de le positionner avec du code CSS. |
data-action |
action |
Facultatif. Chaîne décrivant l'action actuelle. | ||
data-theme |
theme |
dark |
light |
Facultatif. Thème de couleur du widget. |
data-size |
size |
compact , normal |
normal |
Facultatif. Taille du widget. |
data-tabindex |
tabindex |
Integer | 0 | Facultatif. Tabindex du widget et du challenge. Si d'autres éléments de votre page utilisent des tabindex, il doit être défini pour faciliter la navigation de l'utilisateur. |
data-callback |
callback |
Chaîne | Non disponible | Facultatif. Nom de votre fonction de rappel exécutée lorsque l'utilisateur envoie une réponse réussie. Le jeton g-recaptcha-response est transmis à votre rappel. |
data-expired-callback |
expired-callback |
Chaîne | Non disponible | Facultatif. Nom de votre fonction de rappel exécutée lorsque la réponse reCAPTCHA expire et que l'utilisateur doit à nouveau effectuer la validation. |
data-error-callback |
error-callback |
Chaîne | Non disponible | Facultatif. Nom de votre fonction de rappel exécutée lorsque reCAPTCHA rencontre une erreur (généralement un problème de connectivité réseau) et ne peut pas poursuivre tant que la connectivité n'est pas rétablie. Si vous spécifiez ici une fonction, il vous incombe d'indiquer à l'utilisateur qu'il doit réessayer. |