Jest

Test IT позволяет загружать результаты автоматизированных тестов из тестового фреймворка Jest. Существуют следующие способы интеграции:

CLI
Адаптер
Public API

Смотрите также: Дополнительные ресурсы.

CLI

Test IT поддерживает загрузку тестов и результатов их выполнения в формате JUnit XML. Для этого необходимо:

Запустить тесты и сгенерировать отчет JUnit XML
Загрузить результаты тестов в Test IT

Запуск тестов и генерация отчета JUnit XML

Вы можете запускать тесты через командную строку или как часть вашей CI/CD системы. Jest поддерживает генерацию JUnit XML отчета с помощью сторонних пакетов. Воспользуйтесь одним из популярных пакетов jest-junit.

Для подключения пакета добавьте его в jest.config.js:

module.exports = {
  reporters: [
    "default",
    ["jest-junit", {
      outputFile: "results/test-results.xml",
      ancestorSeparator: " > ",
    }]
  ],
};

Для генерации отчета воспользуйтесь командой:
```
$ jest
```
После выполнения тестов отчет будет автоматически сгенерирован в директории results.

Загрузка результатов тестов в Test IT

Загрузка осуществляется при помощи Test IT CLI. Утилита распространяется как пакет для Python и устанавливается в системе.

Для установки выполните команду:

$ pip install testit-cli
$ testit --help

usage: testit [options]
[...]

Добавьте переменную окружения TMS_TOKEN и выполните команду:

$ export TMS_TOKEN=<YOUR_TOKEN>
$ testit results import \
  --url <YOUR_INSTANCE_URL> \
  --project-id 5236eb3f-7c05-46f9-a609-dc0278896464 \
  --configuration-id 15dbb164-c1aa-4cbf-830c-8c01ae14f4fb \
  --testrun-name "Jest test run" \
  --results results/test-results.xml

<YOUR_TOKEN> — приватный токен, сгенерированный в вашем профиле Test IT
<YOUR_INSTANCE_URL> — адрес вашей системы Test IT, например https://tms.testit.software/

Пример выполнения команды

Collecting log files ...
Found 3 result file with a total of 7 tests
Created new testrun (ID: 18725f28-f054-40d6-b30e-b05cf36deaf9)
Sending test results to Test IT ...
Uploading: 100%|█████████████████████████████████████████████| 7/7 [00:01<00:00,  3.98it/s]
Successfully sent test results
Completed testrun (ID: 18725f28-f054-40d6-b30e-b05cf36deaf9)

Результаты загружены в систему Test IT.

Адаптер

Адаптер предоставляет гибкие возможности интеграции и позволяет загружать не только базовую информацию об автотестах, но и другие метаданные (шаги, вложения, ссылки и т.д.).

Для подключения адаптера воспользуйтесь инструкцией в GitHub.

Список метаданных, передаваемых адаптером для Jest

testit.workItemIds — идентификатор (ID) рабочего элемента, позволяет привязывать автотесты к ручным тестам в Test IT. Получает массив ID ручных тестов.
testit.displayName — имя автотеста, используемое в Test IT
testit.externalId — уникальный ID автотеста в Test IT
testit.title — имя автотеста, указанное в его карточке. Если имя не указано, используется имя displayName.
testit.description — описание автотеста, указанное в его карточке
testit.labels — теги, указанные в карточке автотеста
testit.link — ссылки, указанные в карточке автотеста
testit.namespace — расположение автотеста в секции Test IT (по умолчанию используется имя директории автотеста)
testit.classname — субдиректория автотеста в секции Test IT (по умолчанию используется имя файла автотеста)
testit.addLinks — ссылки на результаты автотестов
testit.addAttachments — вложения, прикрепляемые к результатам автотестов
testit.addMessage — сообщения о результатах автотестов
testit.step — шаг автотеста

Public API

Вы можете загружать тесты и результаты их выполнения с помощью нашего публичного API. Существует два способа загрузки:

Самостоятельно взаимодействовать с API
Использовать готовый API-клиент

Дополнительные ресурсы

Чтобы узнать больше о возможностях интеграции Test IT с другими системами, прочтите наши статьи: