Функции в BAS: как превратить блоки в переиспользуемую логику

Если модули — это коробки, которые идут вместе с BAS, то функции — это единицы, которые вы строите сами. Это слой, где рыхлая последовательность кликов и извлечений становится тем, что можно назвать, переиспользовать и о чём можно рассуждать, — разница между скриптом и программой.

Что такое функция на самом деле

Функция — это контейнер, состоящий из экшн-блоков. Так её аккуратнее всего разместить в иерархии BAS: модули состоят из функций, а функции состоят из экшн-блоков. Вы берёте блоки, выполняющие одну цельную задачу, и заворачиваете их в одну именованную единицу.

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

Зачем разбивать сценарий на функции

Качественно написанный скрипт автоматизации разбивается на составные части. Возьмите типичного бота регистрации — он естественно раскладывается на отдельные задачи:

• авторизация на сайте
• получение баланса
• регистрация почты
• и так далее

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

Параметры и возвращаемые значения

Функции в BAS ведут себя как функции в любом языке программирования. Они умеют:

• Принимать параметры — значения, которые вы передаёте при вызове функции. Внутри функции их читают действием Получить параметр функции, поэтому одна и та же логика работает с разными входными данными.
• Возвращать результат — отдавать значение вызывающей стороне и сигнализировать, успешно ли завершилась функция.

Именно это делает функцию переиспользуемой, а не одноразовой. Войти не должна быть зашита под один аккаунт; она должна принимать логин и пароль как параметры и возвращать успех или неудачу. Напишите один раз — вызывайте для каждого аккаунта.

Запуск функций в потоках

Выигрыш, который важен на масштабе: функцию можно вызывать в нескольких потоках одновременно. Это главный рычаг повышения пропускной способности сценария автоматизации — вместо обработки одного аккаунта, одного объявления или одного сообщения за раз вы гоните одну и ту же функцию параллельно в множестве потоков.

В связке с правильным режимом взаимодействия (настоящий браузер упирается в 100–200 потоков на машину; HTTP-клиент масштабируется куда выше) параллельные вызовы функций — это то, как проект на BAS переходит от «работает на моём списке из десяти» к «перемалывает десятки тысяч».

Вывод

Функции — это шарнир всей модели BAS. Под ними экшн-блоки делают буквальную работу. Над ними модули упаковывают функции для переиспользования между проектами. Посередине функции — это место, где структуру задаёте вы: называете задачи, параметризуете их, возвращаете явный успех или неудачу и запускаете их параллельно. Освойте эту привычку — разбивать, параметризовать, переиспользовать — и ваши боты перестанут быть хрупкими одноразовыми поделками и станут системами, которые можно поддерживать.