Расширения тестовых отчетов

В этой статье перечислены и описаны все расширения Microsoft.Testing.Platform, связанные с возможностями тестового отчета.

Тестовый отчет — это файл, содержащий сведения о выполнении и результатах тестов.

Тестовые отчеты Visual Studio

Файл результатов теста Visual Studio (или TRX) — это формат по умолчанию для публикации результатов теста. Это расширение поставляется в составе пакета Microsoft.Testing.Extensions.TrxReport.

Доступные варианты:

Выбор	Описание
--report-trx	Создает отчет TRX.
--report-trx-filename	Имя созданного отчета TRX. Имя по умолчанию соответствует следующему формату <UserName>_<MachineName>_<yyyy-MM-dd HH:mm:ss>.trx.

Отчет сохраняется в папке по умолчанию TestResults, которую можно указать с помощью аргумента командной строки --results-directory.

Отчеты Azure DevOps

Плагин отчетов Azure DevOps улучшает выполнение тестов для разработчиков, которые размещают свой код на GitHub, но используют агентов сборки Azure DevOps для сборки. Он добавляет подробную информацию о неисправностях для их отображения непосредственно в GitHub PR.

Расширение поставляется в пакете Microsoft.Testing.Extensions.AzureDevOpsReport .

Доступные варианты:

Выбор	Описание
--report-azdo	Активируйте вывод ошибок и предупреждений в CI-сборках.
--report-azdo-severity	Степень серьёзности для сообщаемого события. Параметры: error (по умолчанию) и warning.

Расширение автоматически обнаруживает, что оно выполняется в среде непрерывной интеграции (CI), проверяя TF_BUILD переменную среды.

Определение строки для отчета

Чтобы выделить правильную строку в коде, в которой произошел сбой, плагин отчета AzureDevOps ищет в стеке ошибок файл, находящийся в текущем репозитории.

Чтобы определить это, выполните указанные ниже действия.

• находит корневой каталог репозитория, это делается путем поиска .git в каталоге, ближайшем к расположению, откуда запущено тестовое приложение (как определено AppContext.BaseDirectory).
• находит первую строку в трассировке стека с расположением файла и строкой (библиотека должна иметь отладочные символы).
• исключает все файлы, которые заканчиваются на Assert.cs, для предотвращения отображения сведений о реализации утверждений или оболочках.
• исключает все файлы, которые не существуют на диске (обычно это строки из внешних библиотек, которые отправляют символы отладки, например MSTest).

(Это внутренние сведения, которые служат для отладки поведения и могут измениться в будущем.)