tests/Files.InteractionTests/Helper/AxeHelper.cs - main - githubmirror/Files

tests/Files.InteractionTests/Helper/AxeHelper.cs
77 строк3 KB
yair100
Feature: Improved context menu performance (#18803)
10 авг 2026, 00:06
10 авг 2026, 00:06a47ab17
// Copyright (c) Files Community
// Licensed under the MIT License.

using Axe.Windows.Automation;
using Axe.Windows.Core.Enums;
using System;
using System.Diagnostics;
using System.Linq;
using System.Text;
using System.Threading;

namespace Files.InteractionTests.Helper
{
	public sealed class AxeHelper
	{
		public static IScanner AccessibilityScanner;

		internal static void InitializeAxe()
		{
			var processes = Process.GetProcessesByName("Files");
			Assert.IsTrue(processes.Length > 0);

			var config = Config.Builder.ForProcessId(processes[0].Id).Build();

			AccessibilityScanner = ScannerFactory.CreateScanner(config);
		}

		public static void AssertNoAccessibilityErrors()
		{
			ScanResult[] Scan() => AccessibilityScanner.Scan(null).WindowScanOutputs.SelectMany(output => output.Errors).Where(error =>
				error.Rule.ID != RuleId.BoundingRectangleNotNull &&
				!error.Rule.Description.Contains("BoundingRectangle must not obscure its container element.", StringComparison.Ordinal)).ToArray();

			var errors = Scan();

			// A too-small element may be the sidebar scroll arrow mid-animation; let it settle and rescan so only a
			// persistently undersized (or focusable) element fails, instead of suppressing every small element.
			if (errors.Any(error => error.Rule.ID == RuleId.BoundingRectangleSizeReasonable))
			{
				Thread.Sleep(300);
				errors = Scan();
			}

			if (errors.Length != 0)
			{
				StringBuilder sb = new();
				sb.AppendLine();
				sb.AppendLine("============================================================");
				sb.AppendJoin(Environment.NewLine, errors.Select(BuildAssertMessage));
				sb.AppendLine();
				sb.AppendLine("============================================================");

				Assert.Fail(sb.ToString());
			}
		}

		private static string BuildAssertMessage(ScanResult result)
		{
			// e.g., "Element Button(50000) violated rule 'The Name property of a focusable element must not be null.'."
			return $"Element {result.Element.Properties["ControlType"]} at ({ParseBoundingRectangle(result.Element.Properties["BoundingRectangle"])}) violated rule \"{result.Rule.Description}\".";
		}

		private static string ParseBoundingRectangle(string boundingRectangle)
		{
			// e.g., "[l=1617,t=120,r=1663,b=152]" to "x=1617,y=120,w=46,h=32"
			var output = new ushort[4];
			var parts = boundingRectangle.Trim('[').Trim(']').Split(',');
			for (int index = 0; index < 4; index++)
			{
				if (ushort.TryParse(parts[index][2..], out var res))
					output[index] = res;
			}

			return $"x={output[0]},y={output[1]},w={output[2] - output[0]},h={output[3] - output[1]}";
		}
	}
}