APIs de JavaScript
APIs de JavaScript de MTCaptcha
Se creará un objeto window.mtcaptcha una vez que la biblioteca JavaScript de MTCaptcha se haya cargado. Este objeto mtcaptcha admite las siguientes APIs:
| API | Descripción |
|---|---|
| enableTestMode() | Activa el modo de prueba automatizado con la TestKey. Para más detalles, consulta la Guía para Desarrolladores - Pruebas Automatizadas. |
| getConfiguration() | Devuelve una "copia" del objeto de configuración del captcha. Se utiliza principalmente para depurar configuraciones. Cualquier cambio al objeto devuelto será ignorado. |
| getStatus() | Devuelve el estado actual del captcha. Para más detalles sobre el objeto de estado, consulta la Guía para Desarrolladores - Callbacks JS - Argumento de Estado. |
| getVerifiedToken() | Devuelve la cadena verifiedToken actual, o null si no ha sido verificado. |
| renderUI() | Llamada explícita para renderizar el captcha, cuando se inicializa con la configuración render='explicit'. Consulta la Guía para Desarrolladores - Renderizado Explícito para un método seguro y asincrónico de renderizar el widget. |
| resetUI() | Restablece el widget y todo su estado. |
| remove() | Elimina completamente el widget del captcha del DOM. El captcha puede reinstanciarse llamando a renderUI(). Este método es útil para aplicaciones web de una sola página. |
| showMandatory() | Muestra el mensaje y el estilo que indican que el captcha es obligatorio. Está destinado a usarse con validación personalizada de formularios. Consulta la Guía para Desarrolladores - Validación Automática de Formularios para que el captcha verifique y exija su resolución automáticamente al enviar el formulario. |