4.0.0

Changelog

Added

• Add methods to AppVersionDetector:

  public static Task<string?> GetThroughMacOSApplicationCliAsync(string applicationName, CancellationToken cancellationToken = default);
  
  public static Task<string?> GetThroughCliAsync(string fileNameOrCommand, string arguments, CancellationToken cancellationToken = default);

• Add methods to BrowserDetector:

  public static Task<string?> GetFirstInstalledBrowserNameAsync(IEnumerable<string> browserNames, CancellationToken cancellationToken = default);
  
  public static Task<bool> IsBrowserInstalledAsync(string browserName, CancellationToken cancellationToken = default);
  
  public static Task<string?> GetInstalledBrowserVersionAsync(string browserName, CancellationToken cancellationToken = default);

• Add method to DriverSetupConfigurationBuilder:

  public Task<DriverSetupResult> SetUpAsync(CancellationToken cancellationToken = default);

Changed

• Upgrade Atata.Cli package reference to v4.0.0.
• Change package target frameworks from .NET Standard 2.0 to .NET 8.0 and .NET Framework 4.6.2.
• Enable nullable reference types.
• Change default value of DriverSetupOptions.CheckCertificateRevocationList property from true to false.
• Add CancellationToken cancellationToken = default parameter to the following methods of DriverSetup:
  • AutoSetUpAsync
  • AutoSetUpSafelyAsync
  • SetUpPendingConfigurationsAsync
• In IGetsInstalledBrowserVersion replace method:

  string? GetInstalledBrowserVersion();

  with:

  Task<string?> GetInstalledBrowserVersionAsync(CancellationToken cancellationToken = default);

• In IGetsDriverLatestVersion replace method:

  string GetDriverLatestVersion();

  with:

  Task<string> GetDriverLatestVersionAsync(CancellationToken cancellationToken = default);

• In IGetsDriverClosestVersion replace method:

  bool TryGetDriverClosestVersion(
      string version,
      TargetOSPlatform platform,
      [NotNullWhen(true)] out string? closestVersion);

  with:

  Task<string> GetDriverClosestVersionAsync(
      string version,
      TargetOSPlatform platform,
      CancellationToken cancellationToken = default);

• In IGetsDriverVersionCorrespondingToBrowserVersion replace method:

  string GetDriverVersionCorrespondingToBrowserVersion(
      string browserVersion,
      TargetOSPlatform platform);

  with:

  Task<string> GetDriverVersionCorrespondingToBrowserVersionAsync(
      string browserVersion,
      TargetOSPlatform platform,
      CancellationToken cancellationToken = default);

• In TargetOSFamily enum rename Mac to MacOS.
• In OSInfo rename IsOSX property to IsMacOS.

Deprecated

• In DriverSetupOptionsBuilder<TBuilder, TContext> deprecate WithMutex method in favor of the new WithInterProcessSynchronization.
• In DriverSetupOptions deprecate UseMutex property in favor of the new UseInterProcessSynchronization.

Removed

• In DriverSetup remove AutoSetUpAsync(params string[] browserNames) method in favor of the new AutoSetUpAsync(IEnumerable<string> browserNames, CancellationToken cancellationToken = default).
• In AppVersionDetector remove GetThroughCli method in favor of the new GetThroughCliAsync.
• In AppVersionDetector remove GetThroughOSXApplicationCli method in favor of the new GetThroughMacOSApplicationCliAsync.
• In HttpRequestExecutor constructor remove proxy and checkCertificateRevocationList parameters in favor of using single httpClientHandlerConfigurationAction parameter for HttpClientHandler configuration.

Links

• Atata.WebDriverSetup 4.0.0 on NuGet
• Full Changelog: v3.10.0...v4.0.0