Skip to main content

Extensions

As TUnit is built on top of Microsoft.Testing.Platform, it can tap into generic testing extension packages.

Built-In Extensions​

The following extensions are automatically included when you install the TUnit meta package:

  • Code Coverage - via Microsoft.Testing.Extensions.CodeCoverage
  • TRX Test Reports - via Microsoft.Testing.Extensions.TrxReport
  • Telemetry - via Microsoft.Testing.Extensions.Telemetry
Opting Out of Built-In Extensions

If you don't want these extensions, you can reference TUnit.Engine and TUnit.Assertions packages separately instead of the TUnit meta package.

<!-- Instead of the TUnit meta package -->
<PackageReference Include="TUnit.Engine" Version="x.x.x" />
<PackageReference Include="TUnit.Assertions" Version="x.x.x" />

Code Coverage​

Code coverage is provided via Microsoft.Testing.Extensions.CodeCoverage, included automatically with the TUnit package.

See the Code Coverage page for usage, configuration, and CI/CD integration.

TRX Test Reports​

TRX reports are provided via the Microsoft.Testing.Extensions.TrxReport NuGet package.

Included automatically with the TUnit package - No manual installation needed.

Usage​

Run your tests with the --report-trx flag:

# Generate TRX report
dotnet run --configuration Release --report-trx

# Specify output location
dotnet run --configuration Release --results-directory ./reports --report-trx --report-trx-filename testresults.trx

More Resources:

Telemetry​

Telemetry is provided via the Microsoft.Testing.Extensions.Telemetry NuGet package.

Included automatically with the TUnit package

This extension enables Microsoft to collect anonymous usage metrics to help improve the testing platform. No personal data or source code is collected.

Opting Out​

You can disable telemetry by setting an environment variable:

# Linux/macOS
export TESTINGPLATFORM_TELEMETRY_OPTOUT=1

# Windows
set TESTINGPLATFORM_TELEMETRY_OPTOUT=1

Alternatively, you can use DOTNET_CLI_TELEMETRY_OPTOUT=1 which also disables .NET SDK telemetry.

More Resources:

Optional Extensions​

These extensions are not included with the TUnit package and must be installed manually if needed.

Crash Dump​

Crash dump is an extension to help diagnose unexplained crashes, provided via the Microsoft.Testing.Extensions.CrashDump NuGet package.

More information can be found here

Hang Dump​

Hang dump is an extension to help diagnose unexplained hanging in your test suite, provided via the Microsoft.Testing.Extensions.HangDump NuGet package.

More information can be found here