Mocha

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

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

CLI

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

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

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

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

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

    "use strict";
    
    module.exports = {
      reporter: 'mocha-junit-reporter',
      reporterOptions: [
        "mochaFile=results/test-results.xml",
        "jenkinsMode=1",
        "testCaseSwitchClassnameAndName=1",
        "outputs=1"
      ]
    }
    
  2. Для генерации отчета воспользуйтесь командой:

    $ npx mocha
    

    После выполнения тестов отчет будет автоматически сгенерирован в директории reports.

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

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

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

    $ pip install testit-cli
    $ testit --help
    
    usage: testit [options]
    [...]
    
  2. Добавьте переменную окружения 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 "Mocha test run" \
      --results results/test-results.xml
    

    Пример выполнения команды
    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.

Адаптер

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

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

Список метаданных, передаваемых адаптером для Mocha
  • this.workItemsIds — идентификатор (ID) рабочего элемента, позволяет привязывать автотесты к ручным тестам в Test IT. Получает массив ID ручных тестов.
  • this.displayName — имя автотеста, используемое в Test IT
  • this.externalId — уникальный ID автотеста в Test IT
  • this.title — имя автотеста, указанное в его карточке. Если имя не указано, используется имя displayName.
  • this.description — описание автотеста, указанное в его карточке
  • this.labels — теги, указанные в карточке автотеста
  • this.links — ссылки, указанные в карточке автотеста
  • this.nameSpace — расположение автотеста в секции Test IT (по умолчанию используется имя директории автотеста)
  • this.className — субдиректория автотеста в секции Test IT (по умолчанию используется имя файла автотеста)
  • this.addLinks — ссылки на результаты автотестов
  • this.addAttachments` — вложения, прикрепляемые к результатам автотестов
  • this.addMessage — сообщения о результатах автотестов
  • this.addSteps — информация о шаге автотеста

Public API

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

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

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

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

Обновлено: