Microsoft.Testing.Extensions.CrashDump
This package extends Microsoft Testing Platform to provide a crash dump functionality. Microsoft Testing is a set of platform, framework and protocol intended to make it possible to run any test on any target or device.
Install
| Product | Versions |
|---|---|
| .NET | |
| .NET Standard |
README
Microsoft.Testing.Extensions.CrashDump
Microsoft.Testing.Extensions.CrashDump is an extension for Microsoft.Testing.Platform that captures a crash dump or crash report for the test host process when an unhandled exception or crash occurs.
Microsoft.Testing.Platform is open source. You can find Microsoft.Testing.Extensions.CrashDump code in the microsoft/testfx GitHub repository.
Install the package
dotnet add package Microsoft.Testing.Extensions.CrashDump
About
This package extends Microsoft.Testing.Platform with:
- Crash dump collection: automatically captures a memory dump when the test process crashes
- Crash report collection: optionally emits a lightweight JSON crash report to help diagnose crashes without uploading a full dump (Linux/macOS only — see dotnet/runtime#80191; requires .NET 7+ when used alone or .NET 6+ when combined with
--crashdump) - Post-mortem debugging: collected dumps can be analyzed with tools like Visual Studio, WinDbg, or
dotnet-dump - Cross-platform: crash dumps are supported on Windows, Linux, and macOS (dumps collected on macOS can only be analyzed on macOS). Crash reports are currently only supported on Linux and macOS.
- Runtime behavior: supported for .NET 6+; on .NET Framework this extension is ignored
Usage
Enable crash dump collection via the --crashdump command line option.
Add --crash-report (Linux/macOS only; requires .NET 7+ when used alone or .NET 6+ with --crashdump) to generate a JSON crash report; combine --crashdump --crash-report to produce both a dump and a report.
Related packages
- Microsoft.Testing.Extensions.HangDump: captures dumps when the test process hangs
Documentation
For this extension, see https://learn.microsoft.com/dotnet/core/testing/microsoft-testing-platform-crash-hang-dumps#crash-dump.
For comprehensive documentation, see https://aka.ms/testingplatform.
Feedback & contributing
Microsoft.Testing.Platform is an open source project. Provide feedback or report issues in the microsoft/testfx GitHub repository.
Changes from Previous Version
Adoption Assessment
A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.
Related Guides & Workflows
Learn how to evaluate, integrate, or audit this package in your .NET project.