Language
Edit

MSTEST0084: Platform compatibility attributes should be consistent with '[OSCondition]'

Property Value
Rule ID MSTEST0084
Title Platform compatibility attributes should be consistent with [OSCondition]
Category Usage
Fix is breaking or non-breaking Non-breaking
Enabled by default Yes
Default severity Info
Introduced in version 4.5.0 (preview)
Is there a code fix Yes, for C# only

Cause

An MSTest class or method uses SupportedOSPlatformAttribute or UnsupportedOSPlatformAttribute, but its MSTest OSConditionAttribute doesn't express a compatible operating-system condition.

Rule description

Platform compatibility attributes inform compile-time analysis, but they don't control whether MSTest runs a test. Without a compatible [OSCondition], a test can execute on an unsupported operating system and fail before it reaches the behavior that it intends to verify.

[TestMethod]
[SupportedOSPlatform("windows")]
public void UsesWindowsApi() { } // Violation

The rule compares operating-system families. [OSCondition] doesn't represent platform version constraints, so the analyzer doesn't report scenarios whose version constraints can't be represented safely.

How to fix violations

Keep the platform compatibility attribute for API analysis, and add or update [OSCondition] so MSTest skips the test on unsupported operating-system families.

[TestMethod]
[SupportedOSPlatform("windows")]
[OSCondition(OperatingSystems.Windows)]
public void UsesWindowsApi() { }

A C# code fix adds or updates [OSCondition]. Visual Basic reports the diagnostic but doesn't provide an automatic fix.

When to suppress warnings

Suppress the rule when another mechanism guarantees that the test can't run on an incompatible operating system and adding [OSCondition] would duplicate that policy.

Suppress a warning

#pragma warning disable MSTEST0084
// The code that's violating the rule is on this line.
#pragma warning restore MSTEST0084

To disable the rule for a file, folder, or project, set its severity to none in the configuration file.

[*.{cs,vb}]
dotnet_diagnostic.MSTEST0084.severity = none

For more information, see How to suppress code analysis warnings.

See also

  • Last updated on