https://github.com/SimpleBrowserDotNet/SimpleBrowser

A flexible and intuitive web browser engine designed for automation tasks. Built on .NET Standard 2.1.
https://github.com/SimpleBrowserDotNet/SimpleBrowser

Last synced: 25 days ago
JSON representation

A flexible and intuitive web browser engine designed for automation tasks. Built on .NET Standard 2.1.

• Host: GitHub
• URL: https://github.com/SimpleBrowserDotNet/SimpleBrowser
• Owner: SimpleBrowserDotNet
• License: other
• Created: 2010-11-07T17:12:16.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2023-11-26T16:57:58.000Z (about 1 year ago)
• Last Synced: 2024-08-10T09:34:27.187Z (4 months ago)
• Language: C#
• Homepage:
• Size: 2.09 MB
• Stars: 360
• Watchers: 38
• Forks: 105
• Open Issues: 20
• Metadata Files:
  • Readme: readme.md
  • License: license.txt

Awesome Lists containing this project

• awesome-browser-automation - SimpleBrowser - Browser automation engine build on .NET. (Tools)

README

        
SimpleBrowser

=============

SimpleBrowser is a lightweight, yet highly capable browser automation engine designed for automation and testing scenarios.

It provides an intuitive API that makes it simple to quickly extract specific elements of a page using a variety of matching

techniques, and then interact with those elements with methods such as `Click()`, `SubmitForm()` and many more. SimpleBrowser

does not support JavaScript, but allows for manual manipulation of the user agent, referrer, request headers, form values and

other values before submission or navigation.

Requirements

------------

* .NET Standard 2.0 compatible runtime

Features

--------

* Multiple ways of locating and interacting with page elements. The browser session is completely scriptable.

* A highly permissive HTML parser that converts any HTML, no matter how badly formed, to a valid XDocument object

* Automatic cookie/session management

* Extensive logging support with attractive and comprehensive html log file output to make it easy to identify problems loading and automating browsing sessions

Example

-------

``` c#

class Program

{

	static void Main(string[] args)

	{

		var browser = new Browser();

		try

		{

			// log the browser request/response data to files so we can interrogate them in case of an issue with our scraping

			browser.RequestLogged += OnBrowserRequestLogged;

			browser.MessageLogged += new Action(OnBrowserMessageLogged);

			// we'll fake the user agent for websites that alter their content for unrecognised browsers

			browser.UserAgent = "Mozilla/5.0 (Windows; U; Windows NT 6.1; en-US) AppleWebKit/534.10 (KHTML, like Gecko) Chrome/8.0.552.224 Safari/534.10";

			// browse to GitHub

			browser.Navigate("http://github.com/");

			if(LastRequestFailed(browser)) return; // always check the last request in case the page failed to load

			// click the login link and click it

			browser.Log("First we need to log in, so browse to the login page, fill in the login details and submit the form.");

			var loginLink = browser.Find("a", FindBy.Text, "Login");

			if(!loginLink.Exists)

				browser.Log("Can't find the login link! Perhaps the site is down for maintenance?");

			else

			{

				loginLink.Click();

				if(LastRequestFailed(browser)) return;

				// fill in the form and click the login button - the fields are easy to locate because they have ID attributes

				browser.Find("login_field").Value = "[email protected]";

				browser.Find("password").Value = "yourpassword";

				browser.Find(ElementType.Button, "name", "commit").Click();

				if(LastRequestFailed(browser)) return;

				// see if the login succeeded - ContainsText() is very forgiving, so don't worry about whitespace, casing, html tags separating the text, etc.

				if(browser.ContainsText("Incorrect login or password"))

				{

					browser.Log("Login failed!", LogMessageType.Error);

				}

				else

				{

					// After logging in, we should check that the page contains elements that we recognise

					if(!browser.ContainsText("Your Repositories"))

						browser.Log("There wasn't the usual login failure message, but the text we normally expect isn't present on the page");

					else

					{

						browser.Log("Your News Feed:");

						// we can use simple jquery selectors, though advanced selectors are yet to be implemented

						foreach(var item in browser.Select("div.news .title"))

							browser.Log("* " + item.Value);

					}

				}

			}

		}

		catch(Exception ex)

		{

			browser.Log(ex.Message, LogMessageType.Error);

			browser.Log(ex.StackTrace, LogMessageType.StackTrace);

		}

		finally

		{

			var path = WriteFile("log-" + DateTime.UtcNow.Ticks + ".html", browser.RenderHtmlLogFile("SimpleBrowser Sample - Request Log"));

			Process.Start(path);

		}

	}

	static bool LastRequestFailed(Browser browser)

	{

		if(browser.LastWebException != null)

		{

			browser.Log("There was an error loading the page: " + browser.LastWebException.Message);

			return true;

		}

		return false;

	}

	static void OnBrowserMessageLogged(Browser browser, string log)

	{

		Console.WriteLine(log);

	}

	static void OnBrowserRequestLogged(Browser req, HttpRequestLog log)

	{

		Console.WriteLine(" -> " + log.Method + " request to " + log.Url);

		Console.WriteLine(" <- Response status code: " + log.ResponseCode);

	}

	static string WriteFile(string filename, string text)

	{

		var dir = new DirectoryInfo(Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "Logs"));

		if(!dir.Exists) dir.Create();

		var path = Path.Combine(dir.FullName, filename);

		File.WriteAllText(path, text);

		return path;

	}

}

```