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