Diese Seite wurde von der Cloud Translation API übersetzt.

JavaScript API-Referenz für reCAPTCHA Enterprise

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( container, parameters` )	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( opt_widget_id )`	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 ( opt_widget_id )`	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 ( site_key, {action: 'action_name'} )`	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 ( opt_widget_id )`	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.

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 `g-recaptcha`-Tag gerendert wird. 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.

render

Explizit

onload

Optional. Gibt an, ob das Widget explizit gerendert werden soll. Der Standardwert ist onload, wodurch das Widget im ersten gefundenen g-recaptcha-Tag gerendert wird.

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.