JavaScript-APIs

MTCaptcha JavaScript APIs

Sobald die MTCaptcha-JavaScript-Bibliothek geladen ist, wird ein window.mtcaptcha-Objekt erstellt. Dieses mtcaptcha-Objekt unterstützt die folgenden APIs.

API	Description
enableTestMode()	Aktivieren Sie den automatisierten Testmodus mit dem TestKey. Weitere Informationen finden Sie im Entwicklerhandbuch - Automatisiertes Testen.
getConfiguration()	Gibt eine Kopie des Konfigurationsobjekts für das Captcha zurück. Dies wird hauptsächlich zum Debuggen von Konfigurationseinstellungen verwendet. Änderungen am zurückgegebenen Konfigurationsobjekt werden ignoriert.
getStatus()	Gibt den aktuellen Status des Captchas zurück. Weitere Details zum Statusobjekt finden Sie im Entwicklerhandbuch - JS-Rückrufe - Statusargument.
getVerifiedToken()	Gibt die aktuelle Zeichenfolge verifiedToken zurück, null, wenn nicht verifiziert.
renderUI()	Explizites Rendern des Captchas, wenn mit der Konfiguration render='explicit' initialisiert. Siehe Entwicklerhandbuch - Explizites Rendern für eine sichere asynchrone Methode zum expliziten Rendern des Widgets.
resetUI()	Setzt das Widget und seinen gesamten Status zurück.
remove()	Entfernt das Captcha-Widget vollständig aus dem DOM. Das Captcha kann durch den Aufruf von renderUI() erneut instanziiert werden. Diese Methode ist für einseitige Webanwendungen nützlich.
showMandatory()	Zeigt die Meldung und das Styling an, um zu kennzeichnen, dass das Captcha obligatorisch ist. Dies ist für die Verwendung mit benutzerdefinierter Formularvalidierung vorgesehen. Siehe Entwicklerhandbuch - Auto Form Validate, um das Captcha automatisch zu prüfen und die Vervollständigung beim Absenden des Formulars zu erzwingen.