.. _gsauto_ug_scalatest: Использование в тесте ScalaTest =============================== .. versionadded:: 1.2.1 Тесты прикладных решений пишутся на Scala и выполняются фреймворком ScalaTest, а не JUnit. Для них модуль ``gs-automation-app`` содержит трейт ``GsAutomationScalaTestSuite``. Трейт подмешивается в класс тестов и делает то же, что окружение JUnit (см. :ref:`gsauto_ug_junit`): - перед тестами класса запускает браузер, входит в приложение и ждёт главную форму; - после тестов класса выходит из приложения и закрывает браузер; - если тест или подготовка класса падают, снимает скриншот браузера и, если сервер показал диалог ошибки, дополняет ошибку стектрейсом сервера. Подключение ----------- Модуль собирается под Scala 2.13 и Scala 3. Версия Scala указывается суффиксом имени артефакта (``gs-automation-app_2.13``, ``gs-automation-app_3``), поэтому в sbt зависимость подключается через ``%%``, и sbt сам выбирает артефакт под версию Scala решения. .. code-block:: scala :caption: build.sbt libraryDependencies += "ru.bitec.gs-automation" %% "gs-automation-app" % "1.2.1" % Test ScalaTest модуль с собой не приносит, используется версия, которую уже подключило решение. Под Scala 2.13 трейт работает с ScalaTest 3.0 и 3.2, под Scala 3 - с ScalaTest 3.2. Параметры подключения к серверу приложений, браузер и пользователь задаются так же, как для JUnit, параметрами окружения (см. :ref:`gsauto_envprops`). Класс тестов ------------ Трейт подмешивается в класс тестов любого стиля ScalaTest. В тестах доступны приложение ``application`` и клиент ``client``. .. code-block:: scala :caption: MainMenuTest.scala import org.scalatest.funsuite.AnyFunSuite import ru.bitec.gs.automation.app.scalatest.GsAutomationScalaTestSuite class MainMenuTest extends AnyFunSuite with GsAutomationScalaTestSuite { test("пункт главного меню открывает форму редакторов") { application.mainForm().mainMenu().itemByCaption("gs-automation", "Редакторы на карточке").click() } } Если классу тестов нужна своя подготовка, он переопределяет ``beforeAll`` и сначала вызывает ``super.beforeAll()``, потому что приложение доступно только после него. Своё завершение класса переопределяет ``afterAll`` и вызывает ``super.afterAll()`` последним, потому что после него приложение уже закрыто. .. code-block:: scala :caption: Своя подготовка класса тестов override protected def beforeAll(): Unit = { super.beforeAll() application.mainForm().mainMenu().itemByCaption("gs-automation", "Редакторы на карточке").click() } Трейт уже подмешивает ``BeforeAndAfterEach``, поэтому подготовка и завершение каждого теста пишутся переопределением ``beforeEach`` и ``afterEach`` с ``override``, без отдельной примеси ``BeforeAndAfterEach``. Операции и jexl-скрипты ----------------------- Аннотации ``@Oper`` и ``@Jexl`` в ScalaTest не работают, потому что тест ScalaTest - не метод класса и аннотировать нечего. Вместо них трейт даёт методы ``executeOperation`` и ``executeScript`` с теми же параметрами, что у аннотаций. Параметры, которые не указаны, принимают значения по умолчанию, как в аннотации. .. code-block:: scala :caption: Вызов операции и jexl-скрипта test("операция заполняет запись") { executeOperation("createTestData", form = "gtk-ru.bitec.app.example.Example_Document#List") executeScript(script = "test1 = 1", id = "one") } Путь к файлу скрипта в параметре ``file`` берётся относительно рабочего каталога процесса, а не из ресурсов. Результат операции или скрипта методы не возвращают. Он приходит так же, как для аннотаций, в методы ``onOperationExecuted`` и ``onScriptExecuted``, которые класс тестов переопределяет, если ему нужен результат. Первым параметром в них передаётся имя теста, из которого выполнен вызов, в том числе из ``beforeEach`` и ``afterEach`` этого теста. До первого теста это ``beforeAll``, после тестов - ``afterAll``. Скрипты различаются по параметру ``id``. .. code-block:: scala :caption: Получение результата скрипта private var scriptResult: AnyRef = null override protected def onScriptExecuted(methodName: String, formName: String, selectionName: String, id: String, result: AnyRef): Unit = { if (id == "one") { scriptResult = result } } Результат приходит объектом, который вернул браузер. Простое значение jexl-скрипта приходит строкой, например скрипт ``test1 = 1`` возвращает ``"1"``. Операция без результата возвращает пустую строку. Ограничения ----------- - Тесты одного класса выполняются в одном браузере и одной сессии. Класс нельзя запускать с параллельным выполнением тестов внутри него (``ParallelTestExecution``). Разные классы тестов выполняются параллельно, каждый в своём браузере. - Сервис тестовых данных недоступен (см. :ref:`gsauto_ug_test_data`). Собственные записи тест создаёт операцией прикладного кода (см. :ref:`gsauto_ug_parallel_execution`). .. seealso:: - Руководство пользователя: :ref:`gsauto_ug_junit` - Руководство пользователя: :ref:`gsauto_ug_parallel_execution` - Спецификация: :ref:`gsauto_envprops`