Auf dieser Seite werden die Methoden der reCAPTCHA Enterprise JavaScript API und ihre Konfigurationsparameter beschrieben, die du zum Rendern der Webseiten mit einem Websiteschlüssel verwenden kannst.
JavaScript API
In folgender Tabelle sind die Methoden der reCAPTCHA Enterprise JavaScript API aufgeführt.
Methode | Beschreibung |
---|---|
grecaptcha.enterprise.render(
)
|
Rendert den Container als reCAPTCHA-Widget und gibt die ID des neu erstellten Widgets zurück. Container Das HTML-Element, das das reCAPTCHA-Widget rendert. Geben Sie entweder die ID des Containers (String) oder das DOM-Element selbst an.
Parameter Ein Objekt, das Parameter als Schlüssel/Wert-Paare enthält, z. B. {„sitekey“: „your_site_key“, „theme“: „light“}. |
grecaptcha.enterprise.reset(
|
Setzt das reCAPTCHA-Widget zurück. opt_widget_id Optionale Widget-ID. Standardmäßig wird das erste erstellte Widget verwendet, wenn nichts angegeben ist. |
grecaptcha.enterprise.execute
(
|
Ruft programmatisch die reCAPTCHA Enterprise-Prüfung auf. opt_widget_id Optionale Widget-ID. Standardmäßig wird das erste erstellte Widget verwendet, wenn nichts angegeben ist. |
grecaptcha.enterprise.execute
(
|
Rufen Sie programmatisch die reCAPTCHA Enterprise-Bestätigung für wertbasierte Websiteschlüssel auf. Websiteschlüssel Geben Sie den reCAPTCHA-Websiteschlüssel an, der geschützt werden soll.aktion Geben Sie den Aktionsnamen an, der mit dem geschützten Element verknüpft ist.Weitere Informationen zur Verwendung dieser Methode finden Sie unter Punktbasierten Websiteschlüssel in das Front-End einbinden. |
grecaptcha.enterprise.ready
( )
|
Führt die Funktion aus, während die reCAPTCHA-Bibliothek geladen wird. Weitere Informationen zur Verwendung dieser Methode finden Sie unter Punktbasierten Websiteschlüssel in das Front-End einbinden. |
grecaptcha.enterprise.getResponse
(
|
Ruft die Antwort für das reCAPTCHA-Widget ab. opt_widget_id Optionale Widget-ID. Standardmäßig wird das erste erstellte Widget verwendet, wenn nichts angegeben ist. |
Konfiguration
JavaScript-Ressourcenparameter (enterprise.js)
In folgender Tabelle sind die Parameter der JavaScript-Ressource (enterprise.js
) aufgeführt, mit der Sie ein Widget automatisch oder explizit auf einer Webseite rendern können.
Parameter | Wert | Beschreibung |
---|---|---|
onload |
Optional. Der Name Ihrer Callback-Funktion, die ausgeführt werden soll, sobald alle Abhängigkeiten geladen wurden. | |
render |
Explizit onload |
Optional. Gibt an, ob das Widget explizit gerendert werden soll. Der Standardwert ist onload, wodurch das Widget im ersten gefundenen Weitere Informationen zur Verwendung dieser Parameter finden Sie in den Beispielen unter reCAPTCHA-Widget im Front-End rendern. |
hl |
Siehe Sprachcodes. | Optional. Erzwingt das Rendern des Widgets in einer bestimmten Sprache. Erkennt automatisch die Sprache des Nutzers. |
g-recaptcha-Tag-Attribute und grecaptcha.enterprise.render-Parameter
In der folgenden Tabelle sind die Tag-Attribute g-recaptcha
und die entsprechenden grecaptcha.enterprise.render()
-Parameter aufgeführt.
g-recaptcha -Tag-Attribut |
grecaptcha.enterprise.render Parameter |
Wert | Standard | Beschreibung |
---|---|---|---|---|
data-sitekey |
sitekey |
reCAPTCHA-Schlüssel | ||
data-action |
action |
Optional. String, die die aktuelle Aktion beschreibt. Nicht unterstützt. | ||
data-theme |
theme |
dark light | light | Optional. Das Farbdesign des Widgets. |
data-size |
size |
compact normal | normal | Optional. Die Größe des Widgets |
data-tabindex |
tabindex |
0 | Optional. Der Tabindex des Widgets und der Challenge. Wenn andere Elemente auf Ihrer Seite tabindex verwenden, sollte sie so eingestellt werden, dass eine einfachere Navigation möglich ist. | |
data-callback |
callback |
Optional. Der Name Ihrer Callback-Funktion, die ausgeführt wird, wenn der Nutzer eine erfolgreiche Antwort sendet. Das g-recaptcha-response -Token wird an Ihren Callback übergeben. |
||
data-expired-callback |
expired-callback |
Optional. Der Name Ihrer Callback-Funktion, die ausgeführt wird, wenn die reCAPTCHA-Antwort abläuft und der Nutzer sich noch einmal verifizieren muss. | ||
data-error-callback |
error-callback |
Optional. Der Name Ihrer Callback-Funktion, die ausgeführt wird, wenn reCAPTCHA auf einen Fehler stößt (in der Regel die Netzwerkverbindung) und nicht fortfahren kann, bis die Verbindung wieder hergestellt ist. Wenn Sie hier eine Funktion angeben, sind Sie dafür verantwortlich, den Nutzer darüber zu informieren, dass er es noch einmal versuchen soll. |