FluffySpoon.Automation.Web.Selenium 1.112.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
.NET Standard 2.0
dotnet add package FluffySpoon.Automation.Web.Selenium --version 1.112.0
NuGet\Install-Package FluffySpoon.Automation.Web.Selenium -Version 1.112.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FluffySpoon.Automation.Web.Selenium" Version="1.112.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FluffySpoon.Automation.Web.Selenium --version 1.112.0
#r "nuget: FluffySpoon.Automation.Web.Selenium, 1.112.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install FluffySpoon.Automation.Web.Selenium as a Cake Addin
#addin nuget:?package=FluffySpoon.Automation.Web.Selenium&version=1.112.0

// Install FluffySpoon.Automation.Web.Selenium as a Cake Tool
#tool nuget:?package=FluffySpoon.Automation.Web.Selenium&version=1.112.0

Yet another Selenium/Puppeteer framework

But done right this time. Contributions are welcome.


The following test searches for something in Google and asserts that the results are present in both Chrome, Edge and Firefox on Selenium, and Chromium on Puppeteer. All browsers execute their actions in parallel.

var serviceCollection = new ServiceCollection();

//use 3 different browsers via Selenium

//also use Chromium via Puppeteer

var serviceProvider = serviceCollection.BuildServiceProvider();

using (var automationEngine = serviceProvider.GetRequiredService<IWebAutomationEngine>())
	await automationEngine.InitializeAsync();

	await automationEngine
	await automationEngine
		.Enter("this is a very long test that works").In("input[type=text]:visible")
		.Wait(until => 

	var elements = await automationEngine
		.Wait(until => 
			until.Exists("#rso .g:visible"))
		.Count(10).Of("#rso .g:visible");

	Console.WriteLine("Test done!");


A selector determines how to select elements. Right now, only jQuery selectors are supported.


install-package FluffySpoon.Automation.Css


install-package FluffySpoon.Automation.JQuery

Automation frameworks

An automation framework decides how the automation is done. Can use either Selenium or Puppeteer currently.


install-package FluffySpoon.Automation.Selenium


install-package FluffySpoon.Automation.Puppeteer


Opening a URL

await automationEngine.Open("https://example.com");

Taking a screenshot

await automationEngine
	.SaveAs((engine, i) => 
		engine.UserAgentName + "_" + i + ".jpg");

Mouse operations

Single clicking

var elementsClicked = await automationEngine.Click.On("selector");

Double clicking

var elementsClicked = await automationEngine.DoubleClick.On("selector");

Right clicking

var elementsClicked = await automationEngine.RightClick.On("selector");

Hovering an element

var elementsHovered = await automationEngine.Hover.On("selector");

Dragging & dropping

var elementsDragged = await automationEngine.Drag.From("selector").To("selector");

Typing in elements

var elementsTypedIn = await automationEngine.Enter("some text").In("selector");

Finding elements

var elements = await automationEngine.Find("selector");

Focusing an element

Currently only supports a single element.

var elementsFocused = await automationEngine.Focus.On("selector");

Selecting from a select combo-box

Multiple selections

Selecting by texts
await automationEngine.Select.ByTexts("Bar", "Baz", ...).From("selector");
Selecting by indices
await automationEngine.Select.ByIndices(0, 2, ...).From("selector");
Selecting by values
await automationEngine.Select.ByValues("value1", "value2", ...).From("selector");
await automationEngine.Select.ByValues(1337, 1338, ...).From("selector");

Single selection

Selecting by text
await automationEngine.Select.ByText("Bar").From("selector");
Selecting by index
await automationEngine.Select.ByIndex(0).From("selector");
Selecting by value
await automationEngine.Select.ByValue("value").From("selector");
await automationEngine.Select.ByValue(1337).From("selector");


await automationEngine.Wait(until => until.???);

All methods that are available on the until object are the same as are available on the Expect object (see "Expectations" below).


Any expecation made that is not met, will throw an ExpectationNotMetException. If you want to wait until a specific expectation is met, see "Waiting" above instead.

Specific class on an element

await automationEngine.Expect.Class.Of("selector");

Amount of elements that exist

await automationEngine.Expect.Count(10).Of("selector");

At least one element exists

await automationEngine.Expect.Exists.Of("selector");

Text in element

await automationEngine.Expect.Text("my text").In("selector");

Value of element

await automationEngine.Expect.Value("value").Of("selector");


Open an issue if there's something missing. I want to make this library the best there is! Pull requests are also very welcome.

Performance issues

There is a known bug in .NET Core that will slow down Selenium, which has a workaround described.

If you see performance issues outside .NET Core or what you are seeing is unrelated, please open an issue.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.112.0 780 3/12/2022
1.104.0 874 4/19/2021
1.103.0 712 4/2/2021
1.102.0 565 3/23/2021
1.98.0 449 3/17/2021
1.96.0 325 3/16/2021
1.94.0 669 3/2/2021
1.92.0 505 2/24/2021
1.89.0 7,838 4/15/2020
1.88.0 9,936 3/21/2019
1.87.0 605 3/20/2019
1.84.0 591 3/20/2019
1.82.0 601 3/20/2019
1.81.0 593 3/20/2019
1.78.0 608 3/20/2019
1.72.0 577 3/20/2019
1.71.0 659 3/17/2019
1.70.0 612 3/17/2019
1.69.0 858 3/6/2019
1.68.0 652 3/3/2019
1.61.0 667 2/22/2019
1.60.0 614 2/22/2019
1.58.0 584 2/22/2019
1.57.0 741 2/20/2019
1.56.0 693 2/20/2019
1.52.0 990 2/6/2019
1.51.0 717 2/6/2019
1.50.0 674 2/5/2019
1.49.0 629 2/5/2019
1.48.0 705 2/2/2019
1.46.0 1,157 1/13/2019
1.0.46 1,388 11/11/2018
1.0.45 1,792 7/12/2018
1.0.43 4,601 2/10/2018
1.0.42 1,159 2/2/2018
1.0.41 878 2/1/2018
1.0.40 941 1/30/2018
1.0.37 939 1/29/2018
1.0.34 860 1/28/2018
1.0.33 904 1/28/2018
1.0.32 919 1/28/2018
1.0.29 939 1/28/2018
1.0.22 993 1/25/2018
1.0.21 1,000 1/22/2018
1.0.20 940 1/22/2018
1.0.19 899 1/22/2018
1.0.17 940 1/21/2018
1.0.13 964 1/18/2018
1.0.12 1,056 1/18/2018
1.0.11 933 1/17/2018