JavaScript-Rückrufe
Das MTCaptcha-Widget unterstützt die folgenden callbacks
Callback | Description |
---|---|
jsloaded-callback | Die MTCaptcha JavaScript library wurde geladen. |
rendered-callback | Das MTCaptcha-Widget wird gerendert (sichtbar gemacht). Dies kann nicht aufgerufen werden, wenn Captchas in den Site-Einstellungen durch die Verwendung von Low Friction oder IP Whitelist unsichtbar gehalten werden. |
verified-callback | Der Benutzer wurde verifiziert. Ein verifizierter Token ist beim Rückruf immer verfügbar. |
verifyexpired-callback | Der letzte verifiedToken ist abgelaufen. |
error-callback | Es ist ein Fehler aufgetreten, beispielsweise ein ungültiger Site-Schlüssel oder eine unterbrochene Internetverbindung. |
Um Rückrufe zu aktivieren, verwenden Sie das folgende Muster und die folgenden Konfigurationsparameter.
<script>
function mt_jsloadedcb()
{
console.log("mt_jsloadedcb()");
}
function mt_renderedcb(state)
{
console.log("mt_renderedcb(state)");
console.log("state => "+JSON.stringify(state));
}
function mt_verifiedcb(state)
{
console.log("mt_verifiedcb(state)");
console.log("state => "+JSON.stringify(state));
}
function mt_verifyexpiredcb(state)
{
console.log("mt_verifyexpiredcb(state)");
console.log("state => "+JSON.stringify(state));
}
function mt_errorcb(state)
{
console.log("mt_errorcb(state)");
console.log("state => "+JSON.stringify(state));
}
</script>
<script>
var mtcaptchaConfig = {
"sitekey": "<YOUR SITEKEY>",
"jsloaded-callback": "mt_jsloadedcb",
"rendered-callback": "mt_renderedcb",
"verified-callback": "mt_verifiedcb",
"verifyexpired-callback": "mt_verifyexpiredcb",
"error-callback": "mt_errorcb"
};
...
</script>
```
The callback config params also support javascript function as value. eg:
```html
<script>
var mtcb = {};
mtcb.jsloaded = function(){
console.log("mtcb.jsloaded()");
}
</script>
<script>
var mtcaptchaConfig = {
"sitekey": "<YOUR SITEKEY>",
"jsloaded-callback": mtcb.jsloaded
};
...
</script>
Das Callback-Statusargument und die Felder
Alle Rückrufe, die ein „Status“-Argument enthalten, haben die folgenden Eigenschaften. zB
<script>
function mt_renderedcb(state)
{
console.log("state => "+JSON.stringify(state));
}
</script>
/*
output in console:
state =>
{
"element": <element>,
"domID":"mtcaptcha",
"verifiedToken":null,
"isVerified":false,
"isVisible": true,
"statusCode":2200,
"statusDesc":"Captcha rendered"
}
*/
The callback state argument fields explained
State Field | Description |
---|---|
element | Das MTCaptcha DIV-Anker-DOM-Element. |
domID | Die DOM-ID des MTCaptcha DIV-Anker-DOM-Elements. |
verifiedToken | Die Zeichenfolge VerifiedToken. 'null', wenn nicht verifiziert. |
isVerified | Boolescher Wert, der angibt, ob das Captcha aktuell verifiziert ist. Bei 'true' enthält das Feld 'verifiedToken' die Token-Zeichenfolge. |
isVisible | Boolescher Wert, der angibt, ob das Captcha aktuell sichtbar ist. Weitere Informationen zu den Einstellungen für unsichtbare Captchas finden Sie im Developers Guide - Invisible Captcha. |
statusCode | Der aktuelle Status des Captcha. |
statusDesc | Der aktuelle Status des Captcha in der Beschreibung. |