This project allows for Xunit tests that can determine during execution that they should report a "skipped" result. This can be useful when a precondition is not satisfied, or the test is over functionality that does not exist on the platform being tested.
This package targets Xunit v2. Xunit v3 has skipping built-in. See our Xunit v3 migration doc.
This project is available as a NuGet package
Learn more at our documentation site.
Below is a sampling of uses.
Skip based on a runtime check:
[SkippableFact]
public void SomeMoodyTest()
{
Skip.IfNot(InTheMood);
}Skip based on a thrown exception:
[SkippableFact(typeof(NotSupportedException))]
public void TestFunctionalityWhichIsNotSupportedOnSomePlatforms()
{
// Test functionality. If it throws any of the exceptions listed in the attribute,
// a skip result is reported instead of a failure.
}Skip based on SupportedOSPlatformAttribute:
[SkippableFact, SupportedOSPlatform("Windows")]
public void TestCngKey()
{
var key = CngKey.Create(CngAlgorithm.Rsa);
Assert.NotNull(key);
}