Введите логин и пароль:
``` {% endcut %} ## Расширенный метод подключения {#extended-method} В расширенном методе JS-скрипт, который выполняет загрузку виджета на странице пользователя, добавляется на страницу по ссылке: ```html ``` В параметре `onload` передается функция, которая содержит параметры отрисовки виджета. В данном примере это функция `onloadFunction`. После загрузки JS-скрипта появляется доступ к объекту `window.smartCaptcha` с методами для работы с виджетом. {% cut "Пример кода onloadFunction" %} ```html ``` {% endcut %} ## Методы window.smartCaptcha {#methods} ### Метод render {#render} Метод `render` служит для отрисовки виджета. ```ts ( container: HTMLElement | string, params: { sitekey: string; callback?: (token: string) => void; hl?: 'ru' | 'en' | 'be' | 'kk' | 'tt' | 'uk' | 'uz' | 'tr'; test?: boolean; webview?: boolean; invisible?: boolean; shieldPosition?: `top-left` | `center-left` | `bottom-left` | `top-right` | `center-right` | `bottom-right`; hideShield?: boolean; } ) => WidgetId; ``` Где: * `container` — контейнер для виджета. Можно передать DOM-элемент или идентификатор контейнера. * `params` — объект с параметрами для капчи: * `sitekey` — [ключ клиентской части](keys.md). * `callback` — функция-обработчик. * `hl` — язык виджета. * `test` — включение работы капчи в режиме тестирования. Пользователь всегда будет получать задание. Используйте это свойство только для отладки и тестирования. * `webview` — запуск капчи в **WebView**. Используется для повышения точности оценки пользователей при добавлении капчи в мобильные приложения с помощью **WebView**. * `invisible` — [невидимая капча](invisible-captcha.md). * `shieldPosition` — расположение [блока](invisible-captcha.md#data-processing-notice) с уведомлением об обработке данных. * `hideShield` — скрыть [блок](invisible-captcha.md#data-processing-notice) с уведомлением об обработке данных. {% note warning %} Вы обязаны уведомлять пользователей о том, что их данные обрабатывает SmartCaptcha. Если вы скрываете [блок с уведомлением](invisible-captcha.md#data-processing-notice), сообщите пользователям иным способом о том, что SmartCaptcha обрабатывает их данные. {% endnote %} Метод возвращает `widgetId` — уникальный идентификатор виджета. ### Метод getResponse {#getresponse} Метод `getResponse` возвращает текущее значение токена пользователя. ```ts (widgetId: WidgetId | undefined) => string; ``` Аргумент `widgetId` — уникальный идентификатор виджета. Если аргумент не передан, будет возвращен результат первого отрисованного виджета. ### Метод execute {#execute} Метод `execute` запускает проверку пользователя. Используется чтобы начать проверку невидимой капчи при каком-то событии, например, при нажатии на кнопку отправки формы аутентификации. ```ts (widgetId: WidgetId | undefined) => void; ``` Аргумент `widgetId` — уникальный идентификатор виджета. Если аргумент не передан, проверка будет запущена на первом отрисованном виджете. ### Метод reset {#reset} Метод `reset` сбрасывает состояние виджета до начального. ```ts (widgetId: WidgetId | undefined) => void; ``` Аргумент `widgetId` — уникальный идентификатор виджета. Если аргумент не передан, к начальному состоянию будет возвращен первый отрисованный виджет. ### Метод destroy {#destroy} Метод `destroy` удаляет виджет и созданные им обработчики. ```ts (widgetId: WidgetId | undefined) => void; ``` Аргумент — `widgetId`, уникальный идентификатор виджета. Если аргумент не передан, будет удален первый отрисованный виджет. ### Метод subscribe {#subscribe} Метод `subscribe` позволяет подписывать обработчики на определенные события виджета. Например, можно следить за открытием и закрытием всплывающего окна с заданием. Это может быть полезно для показа клавиатуры на мобильных устройствах. ```ts (widgetId: widgetId, event: SubscribeEvent, callback: Function) => UnsubscribeFunction; ``` Где: * `widgetId` — уникальный идентификатор виджета. * `event` — событие: ```ts type SubscribeEvent = | 'challenge-visible' | 'challenge-hidden' | 'network-error' | 'javascript-error' | 'success' | 'token-expired'; ``` Описание событий: | Событие | Когда происходит | Сигнатура обработчика | | ------------------- | ---------------------------------------------| ------------------------- | | `challenge-visible` | Открытие всплывающего окна с заданием | `() => void` | | `challenge-hidden` | Закрытие всплывающего окна с заданием | `() => void` | | `network-error` | Возникла сетевая ошибка | `() => void` | | `javascript-error` | Возникла критическая ошибка JS | `(error: { filename: string, message: string,`