Zum Hauptinhalt springen

JavaScript-Rückrufe

Das MTCaptcha-Widget unterstützt die folgenden callbacks

CallbackDescription
jsloaded-callbackDie MTCaptcha JavaScript library wurde geladen.
rendered-callbackDas 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-callbackDer Benutzer wurde verifiziert. Ein verifizierter Token ist beim Rückruf immer verfügbar.
verifyexpired-callbackDer letzte verifiedToken ist abgelaufen.
error-callbackEs 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 FieldDescription
elementDas MTCaptcha DIV-Anker-DOM-Element.
domIDDie DOM-ID des MTCaptcha DIV-Anker-DOM-Elements.
verifiedTokenDie Zeichenfolge VerifiedToken. 'null', wenn nicht verifiziert.
isVerifiedBoolescher Wert, der angibt, ob das Captcha aktuell verifiziert ist. Bei 'true' enthält das Feld 'verifiedToken' die Token-Zeichenfolge.
isVisibleBoolescher 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.
statusCodeDer aktuelle Status des Captcha.
statusDescDer aktuelle Status des Captcha in der Beschreibung.