{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/JS_API/built_in_functions/bind/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"dfccb0dd-3395-587d-9103-9559d3d65b32","excerpt":"bind Функция предназначена для установки обработчиков.?> Обработчики — особые функции, которые вызываются на различных этапах обработки запроса или при…","html":"

bind

\n
\n

Функция bind предназначена для установки обработчиков.

\n

Обработчики — особые функции, которые вызываются на различных этапах обработки запроса или при возникновении внештатных ситуаций в диалоге.

\n

Принцип работы

\n

Рассмотрим общий принцип работы обработчиков.

\n
    \n
  1. Создается функция, которая как аргумент принимает объект $context — текущий контекст обработки запроса. В теле функции производятся любые действия, необходимые по сценарию.
    2. \n
  2. При установке функции в качестве обработчика при помощи функции bind указывается его тип. Тип определяет ситуацию, в которой обработчик будет вызван.
    3. \n
  3. Также при установке обработчик привязывается к определенному пути в иерархии стейтов сценария. По умолчанию это корневой путь /.
    4. \n
  4. Обработчик и вызов функции bind помещается либо в отдельный файл с расширением .js, который импортируется в сценарий при помощи тега require, либо в тело тега init.
    5. \n
\n

При нахождении контекста бота в стейте, путь к которому начинается так же, как путь, к которому привязана функция-обработчик, она будет вызываться во всех случаях, разрешенных его типом.

\n

Синтаксис

\n

Функция bind принимает 4 аргумента.

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
АргументТипОписаниеОбязательный
typeСтрокаТип обработчикаДа
handlerФункцияФункция-обработчикДа
pathСтрокаАбсолютный путь для привязки обработчикаНет
nameСтрокаИмя обработчикаНет
\n
\n

Рассмотрим пример вызова функции bind:

\n
bind(\n    \"postProcess\",\n    function($context) {\n        $context.session.lastState = $context.currentState;\n    },\n    \"/Start\",\n    \"Remember last state\"\n);
\n\n

При привязке к корневому пути обработчик будет вызван при нахождении в любом стейте сценария.

\n

Обработчики этапов обработки запроса

\n

Обработчики следующих типов вызываются в ходе общего цикла обработки запроса:

\n\n

preMatch

\n

Обработчик preMatch вызывается перед классификацией запроса. Ниже перечислены основные случаи его использования.

\n

Принудительное изменение текущего стейта

\n

В следующем примере при обработке запроса в стейте /Hello контекст будет переведен в стейт /Start. Это может быть полезно при переименовании стейтов для обратной совместимости версий сценария.

\n
bind(\n    \"preMatch\",\n    function($context) {\n        $context.temp.targetState = \"/Start\";\n    },\n    \"/Hello\"\n);
\n

Изменение текста запроса

\n

Обработчик из примера ниже добавляет к запросам от авторизованных клиентов суффикс, который позволит при помощи паттернов обработать их в стейтах, недоступных для клиентов без авторизации.

\n
bind(\"preMatch\", function($context) {\n    if ($context.client.hasActiveAuthorization) {\n        $context.request.query += \" (клиент авторизован)\";\n    }\n});
\n

Чтобы иметь возможность изменить текст запроса, задайте специальную настройку в конфигурационном файле chatbot.yaml:

\n
nlp:\n  modifyRequestInPreMatch: true
\n

selectNLUResult

\n

В одном сценарии возможно совместное использование нескольких типов правил активации. По умолчанию они срабатывают с заранее заданными приоритетами.

\n

Обработчик selectNLUResult вызывается после классификации запроса и позволяет переопределить механизм выбора нужного правила при одновременном срабатывании правил разных типов.

\n

Подробнее об обработчике selectNLUResult

\n

preProcess

\n

Обработчик preProcess вызывается после классификации запроса и определения целевого стейта, но перед выполнением действий, заданных в стейте. Например, он может быть использован для инициализации каких-либо данных или проверки предварительных условий для перехода в другие стейты.

\n

В следующем примере предполагается, что в $session хранится параметр громкости устройства. Если громкость не задана, для нее устанавливается значение по умолчанию.

\n
var DEFAULT_VOLUME = 40;\n\nbind(\"preProcess\", function($context) {\n    if (!$context.session.volume) {\n        $context.session.volume = DEFAULT_VOLUME;\n    }\n});
\n

postProcess

\n

Обработчик postProcess выполняется после завершения обработки запроса и может быть использован, например, для добавления в ответ дополнительных полей или записи статистических данных.

\n

В приведенном примере обработчик добавляет во все ответы бота в канале Telegram поле, которое указывает, что к ним применена разметка Markdown.

\n
bind(\"postProcess\", function($context) {\n    if ($context.response.channelType === \"telegram\") {\n        $context.response.replies = $context.response.replies.map(function(reply) {\n            if (reply.type === \"text\") {\n                reply.markup = \"markdown\";\n            }\n            return reply;\n        });\n    }\n});
\n

Из postProcess также возможно использовать метод $reactions.transition для перехода обратно в сценарий и принудительного продолжения обработки запроса.

\n

Обработчики ошибок

\n

Обработчики ошибок служат для обработки внештатных ситуаций в ходе работы бота:

\n\n

В теле обработчиков ошибок в поле $context.exception.message содержатся сообщения возникших ошибок.

\n

onScriptError

\n

Обработчик onScriptError вызывается при возникновении необработанного исключения в коде на JavaScript. Также его можно использовать для настройки поведения при генерации собственных исключений при помощи инструкции throw.

\n

Рассмотрим следующий пример использования обработчика для записи сообщения об ошибке в отчет по сессиям через метод $analytics.setSessionData.

\n
bind(\"onScriptError\", function($context) {\n    $analytics.setSessionData(\"Ошибка\", $context.exception.message);\n});
\n

После onScriptError может быть выполнен обработчик postProcess, а также переход в другой стейт при помощи $reactions.transition.

\n

onDialogError

\n

Обработчик onDialogError вызывается при возникновении ошибок сценария, не связанных с исключениями на JavaScript. Примеры таких ошибок:

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ОшибкаСообщение об ошибке
Для запроса клиента не определен целевой стейт.No target state was determined for query
Сделан переход в несуществующий стейт.State not found for path <path>
Бот попал в бесконечный цикл переходов по стейтам.Infinite loop was detected for state <state> in postProcess transition
\n
bind(\"onDialogError\", function($context) {\n    if ($context.exception.message\n            && $context.exception.message === \"No target state was determined for query\") {\n        $reactions.answer(\n            \"Для запроса «\" + $context.request.query + \"» не найден стейт!\"\n        );\n    }\n});
\n

После onDialogError может быть выполнен обработчик postProcess, а также переход в другой стейт при помощи $reactions.transition.

\n

onAnyError

\n

Обработчик onAnyError выполняется в нескольких случаях:

\n
    \n
  1. В коде сценария возникло исключение, для которого не предусмотрен обработчик onScriptError.
    2. \n
  2. В ходе диалога возникла ошибка, для которой не предусмотрен обработчик onDialogError.
    3. \n
  3. Возникла непредвиденная ошибка сервера, не связанная с логикой сценария.
    4. \n
\n
bind(\"onAnyError\", function($context) {\n    var answers = [\n        \"Что-то пошло не так.\",\n        \"Произошла ошибка. Пожалуйста, повторите запрос позже.\",\n        \"Все сломалось. Попробуйте еще раз.\"\n    ];\n    var randomAnswer = answers[$reactions.random(answers.length)];\n    $reactions.answer(randomAnswer);\n});
\n

После onAnyError обработчик postProcess не выполняется. Переход в другой стейт при помощи $reactions.transition невозможен.

","frontmatter":{"title":"","description":null},"headings":[{"value":"bind"}]}},"pageContext":{"slug":"/docs/ru/JS_API/built_in_functions/bind/","previous":{"fields":{"slug":"/docs/ru/JS_API/built_in_functions/capitalize/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/JS_API/built_in_functions/built_in_functions/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}