Support global IgnoreParameters setting (#1701)

* Support global IgnoreParameters setting

Add VerifierSettings.IgnoreParameters API and global backing to ignore parameter names across all tests. FileNameBuilder now merges instance-level ignored parameters with VerifierSettings.GlobalIgnoredParameters and validates ignored names against method parameters. Reset logic clears the global ignored set in serialization settings. Update docs (parameterised-*, ignore-parameters.include) to document static IgnoreParameters usage and add StaticSettingsTests/IgnoreParametersTests.cs and its verified file to cover the behavior.

* Docs changes

---------

Co-authored-by: GitHub Action <action@github.com>

Author: SimonCropp

docs/mdsource/ignore-parameters.include.md

@@ -15,3 +15,18 @@ For the fluent case:
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=One.received.txt
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=Two.received.txt
  * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt
+
+
+### Static IgnoreParameters
+
+`VerifierSettings.IgnoreParameters()` can be used to globally ignore specific parameters (by name) for all tests. This is useful when a parameter is non-deterministic or irrelevant to the verified output across the entire test suite. It must be called before any test runs, typically in a `[ModuleInitializer]`.
+
+When passing an empty list, all parameters will be ignored. When passing specific parameter names, only those parameters will be excluded from the verified filename. Parameters that do not exist on a given test method are silently skipped.
+
+The received files still contain all parameter values.
+
+```cs
+[ModuleInitializer]
+public static void Init() =>
+    VerifierSettings.IgnoreParameters("arg");
+```

docs/parameterised-fixie.md

@@ -194,7 +194,23 @@ For the fluent case:
 
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=One.received.txt
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=Two.received.txt
- * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt<!-- endInclude -->
+ * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt
+
+
+### Static IgnoreParameters
+
+`VerifierSettings.IgnoreParameters()` can be used to globally ignore specific parameters (by name) for all tests. This is useful when a parameter is non-deterministic or irrelevant to the verified output across the entire test suite. It must be called before any test runs, typically in a `[ModuleInitializer]`.
+
+When passing an empty list, all parameters will be ignored. When passing specific parameter names, only those parameters will be excluded from the verified filename. Parameters that do not exist on a given test method are silently skipped.
+
+The received files still contain all parameter values.
+
+```cs
+[ModuleInitializer]
+public static void Init() =>
+    VerifierSettings.IgnoreParameters("arg");
+```
+<!-- endInclude -->
 
 
 ## IgnoreParametersForVerified with override parameters

docs/parameterised-mstest.md

@@ -100,7 +100,23 @@ For the fluent case:
 
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=One.received.txt
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=Two.received.txt
- * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt<!-- endInclude -->
+ * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt
+
+
+### Static IgnoreParameters
+
+`VerifierSettings.IgnoreParameters()` can be used to globally ignore specific parameters (by name) for all tests. This is useful when a parameter is non-deterministic or irrelevant to the verified output across the entire test suite. It must be called before any test runs, typically in a `[ModuleInitializer]`.
+
+When passing an empty list, all parameters will be ignored. When passing specific parameter names, only those parameters will be excluded from the verified filename. Parameters that do not exist on a given test method are silently skipped.
+
+The received files still contain all parameter values.
+
+```cs
+[ModuleInitializer]
+public static void Init() =>
+    VerifierSettings.IgnoreParameters("arg");
+```
+<!-- endInclude -->
 
 
 ### Instance

docs/parameterised-nunit.md

@@ -198,7 +198,23 @@ For the fluent case:
 
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=One.received.txt
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=Two.received.txt
- * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt<!-- endInclude -->
+ * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt
+
+
+### Static IgnoreParameters
+
+`VerifierSettings.IgnoreParameters()` can be used to globally ignore specific parameters (by name) for all tests. This is useful when a parameter is non-deterministic or irrelevant to the verified output across the entire test suite. It must be called before any test runs, typically in a `[ModuleInitializer]`.
+
+When passing an empty list, all parameters will be ignored. When passing specific parameter names, only those parameters will be excluded from the verified filename. Parameters that do not exist on a given test method are silently skipped.
+
+The received files still contain all parameter values.
+
+```cs
+[ModuleInitializer]
+public static void Init() =>
+    VerifierSettings.IgnoreParameters("arg");
+```
+<!-- endInclude -->
 
 
 ### Instance

docs/parameterised-tunit.md

@@ -143,7 +143,23 @@ For the fluent case:
 
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=One.received.txt
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=Two.received.txt
- * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt<!-- endInclude -->
+ * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt
+
+
+### Static IgnoreParameters
+
+`VerifierSettings.IgnoreParameters()` can be used to globally ignore specific parameters (by name) for all tests. This is useful when a parameter is non-deterministic or irrelevant to the verified output across the entire test suite. It must be called before any test runs, typically in a `[ModuleInitializer]`.
+
+When passing an empty list, all parameters will be ignored. When passing specific parameter names, only those parameters will be excluded from the verified filename. Parameters that do not exist on a given test method are silently skipped.
+
+The received files still contain all parameter values.
+
+```cs
+[ModuleInitializer]
+public static void Init() =>
+    VerifierSettings.IgnoreParameters("arg");
+```
+<!-- endInclude -->
 
 
 ### Instance

docs/parameterised-xunitv3.md

@@ -273,7 +273,23 @@ For the fluent case:
 
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=One.received.txt
  * NamerTests.IgnoreParametersForVerifiedFluent_arg=Two.received.txt
- * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt<!-- endInclude -->
+ * NamerTests.IgnoreParametersForVerifiedFluent.verified.txt
+
+
+### Static IgnoreParameters
+
+`VerifierSettings.IgnoreParameters()` can be used to globally ignore specific parameters (by name) for all tests. This is useful when a parameter is non-deterministic or irrelevant to the verified output across the entire test suite. It must be called before any test runs, typically in a `[ModuleInitializer]`.
+
+When passing an empty list, all parameters will be ignored. When passing specific parameter names, only those parameters will be excluded from the verified filename. Parameters that do not exist on a given test method are silently skipped.
+
+The received files still contain all parameter values.
+
+```cs
+[ModuleInitializer]
+public static void Init() =>
+    VerifierSettings.IgnoreParameters("arg");
+```
+<!-- endInclude -->
 
 
 ### Instance

src/Directory.Build.props

@@ -2,7 +2,7 @@
 <Project>
   <PropertyGroup>
     <NoWarn>CA1822;CS1591;CS0649;xUnit1026;xUnit1013;CS1573;VerifyTestsProjectDir;VerifySetParameters;PolyFillTargetsForNuget;xUnit1051;NU1608;NU1109</NoWarn>
-    <Version>31.13.5</Version>
+    <Version>31.14.0</Version>
     <ImplicitUsings>enable</ImplicitUsings>
     <LangVersion>preview</LangVersion>
     <AssemblyVersion>1.0.0</AssemblyVersion>

src/StaticSettingsTests/IgnoreParametersTests.IgnoreParameters.verified.txt

@@ -0,0 +1 @@
+value

src/StaticSettingsTests/IgnoreParametersTests.cs

@@ -0,0 +1,13 @@
+public class IgnoreParametersTests :
+    BaseTest
+{
+    public IgnoreParametersTests() =>
+        VerifierSettings.IgnoreParameters("arg");
+
+    [Theory]
+    [InlineData("One")]
+    [InlineData("Two")]
+    public Task IgnoreParameters(string arg) =>
+        Verify("value")
+            .UseParameters(arg);
+}

src/Verify/Naming/FileNameBuilder.cs

@@ -47,10 +47,24 @@ public static (Action<StringBuilder>?, Action<StringBuilder>?) GetParameterText(
             .Zip(settingsParameters, (name, value) => new KeyValuePair<string, object?>(name, value))
             .ToArray();
 
-        var ignored = settings.ignoredParameters;
-        if (ignored?.All(methodParameters.Contains) == false)
+        var instanceIgnored = settings.ignoredParameters;
+        if (instanceIgnored?.All(methodParameters.Contains) == false)
         {
-            throw new($"Some of the ignored parameter names ({string.Join(", ", ignored)}) do not exist in the test method parameters ({string.Join(", ", methodParameters)}).");
+            throw new($"Some of the ignored parameter names ({string.Join(", ", instanceIgnored)}) do not exist in the test method parameters ({string.Join(", ", methodParameters)}).");
+        }
+
+        var ignored = instanceIgnored;
+        var globalIgnored = VerifierSettings.GlobalIgnoredParameters;
+        if (globalIgnored is not null)
+        {
+            if (ignored is not null)
+            {
+                ignored = [..ignored, ..globalIgnored];
+            }
+            else
+            {
+                ignored = globalIgnored;
+            }
         }
 
         var verifiedValues = GetVerifiedValues(ignored, allValues);