Использование в тесте ScalaTest

Added in version 1.2.1.

Тесты прикладных решений пишутся на Scala и выполняются фреймворком ScalaTest, а не JUnit. Для них модуль gs-automation-app содержит трейт GsAutomationScalaTestSuite. Трейт подмешивается в класс тестов и делает то же, что окружение JUnit (см. Использование в тесте):

  • перед тестами класса запускает браузер, входит в приложение и ждёт главную форму;

  • после тестов класса выходит из приложения и закрывает браузер;

  • если тест или подготовка класса падают, снимает скриншот браузера и, если сервер показал диалог ошибки, дополняет ошибку стектрейсом сервера.

Подключение

Модуль собирается под Scala 2.13 и Scala 3. Версия Scala указывается суффиксом имени артефакта (gs-automation-app_2.13, gs-automation-app_3), поэтому в sbt зависимость подключается через %%, и sbt сам выбирает артефакт под версию Scala решения.

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, параметрами окружения (см. Параметры окружения).

Класс тестов

Трейт подмешивается в класс тестов любого стиля ScalaTest. В тестах доступны приложение application и клиент client.

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() последним, потому что после него приложение уже закрыто.

Своя подготовка класса тестов
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 с теми же параметрами, что у аннотаций. Параметры, которые не указаны, принимают значения по умолчанию, как в аннотации.

Вызов операции и 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.

Получение результата скрипта
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). Разные классы тестов выполняются параллельно, каждый в своём браузере.

  • Сервис тестовых данных недоступен (см. Тестовые данные). Собственные записи тест создаёт операцией прикладного кода (см. Параллельное выполнение тестов).

See also