AngleSharp 1.0.2-alpha-255

This is a prerelease version of AngleSharp.
There is a newer version of this package available.
See the version list below for details.
dotnet add package AngleSharp --version 1.0.2-alpha-255
NuGet\Install-Package AngleSharp -Version 1.0.2-alpha-255
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="AngleSharp" Version="1.0.2-alpha-255" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add AngleSharp --version 1.0.2-alpha-255
#r "nuget: AngleSharp, 1.0.2-alpha-255"
#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 AngleSharp as a Cake Addin
#addin nuget:?package=AngleSharp&version=1.0.2-alpha-255&prerelease

// Install AngleSharp as a Cake Tool
#tool nuget:?package=AngleSharp&version=1.0.2-alpha-255&prerelease

logo

AngleSharp

CI GitHub Tag NuGet Count Issues Open Gitter Chat StackOverflow Questions CLA Assistant

AngleSharp is a .NET library that gives you the ability to parse angle bracket based hyper-texts like HTML, SVG, and MathML. XML without validation is also supported by the library. An important aspect of AngleSharp is that CSS can also be parsed. The included parser is built upon the official W3C specification. This produces a perfectly portable HTML5 DOM representation of the given source code and ensures compatibility with results in evergreen browsers. Also standard DOM features such as querySelector or querySelectorAll work for tree traversal.

⚡:zap: Migrating from AngleSharp 0.9 to AngleSharp 0.10 or later (incl. 1.0)? Look at our migration documentation. ⚡:zap:

Key Features

  • Portable (using .NET Standard 2.0)
  • Standards conform (works exactly as evergreen browsers)
  • Great performance (outperforms similar parsers in most scenarios)
  • Extensible (extend with your own services)
  • Useful abstractions (type helpers, jQuery like construction)
  • Fully functional DOM (all the lists, iterators, and events you know)
  • Form submission (easily log in everywhere)
  • Navigation (a BrowsingContext is like a browser tab - control it from .NET!).
  • LINQ enhanced (use LINQ with DOM elements, naturally without wrappers)

The advantage over similar libraries like HtmlAgilityPack is that the exposed DOM is using the official W3C specified API, i.e., that even things like querySelectorAll are available in AngleSharp. Also the parser uses the HTML 5.1 specification, which defines error handling and element correction. The AngleSharp library focuses on standards compliance, interactivity, and extensibility. It is therefore giving web developers working with C# all possibilities as they know from using the DOM in any modern browser.

The performance of AngleSharp is quite close to the performance of browsers. Even very large pages can be processed within milliseconds. AngleSharp tries to minimize memory allocations and reuses elements internally to avoid unnecessary object creation.

Simple Demo

The simple example will use the website of Wikipedia for data retrieval.

var config = Configuration.Default.WithDefaultLoader();
var address = "https://en.wikipedia.org/wiki/List_of_The_Big_Bang_Theory_episodes";
var context = BrowsingContext.New(config);
var document = await context.OpenAsync(address);
var cellSelector = "tr.vevent td:nth-child(3)";
var cells = document.QuerySelectorAll(cellSelector);
var titles = cells.Select(m => m.TextContent);

Or the same with explicit types:

IConfiguration config = Configuration.Default.WithDefaultLoader();
string address = "https://en.wikipedia.org/wiki/List_of_The_Big_Bang_Theory_episodes";
IBrowsingContext context = BrowsingContext.New(config);
IDocument document = await context.OpenAsync(address);
string cellSelector = "tr.vevent td:nth-child(3)";
IHtmlCollection<IElement> cells = document.QuerySelectorAll(cellSelector);
IEnumerable<string> titles = cells.Select(m => m.TextContent);

In the example we see:

  • How to setup the configuration for supporting document loading
  • Asynchronously get the document in a new context using the configuration
  • Performing a query to get all cells with the content of interest
  • The whole DOM supports LINQ queries

Every collection in AngleSharp supports LINQ statements. AngleSharp also provides many useful extension methods for element collections that cannot be found in the official DOM.

Supported Platforms

AngleSharp has been created as a .NET Standard 2.0 compatible library. This includes, but is not limited to:

  • .NET Core (2.0 and later)
  • .NET Framework (4.6.1 and later)
  • Xamarin.Android (7.0 and 8.0)
  • Xamarin.iOS (10.0 and 10.14)
  • Xamarin.Mac (3.0 and 3.8)
  • Mono (4.6 and 5.4)
  • UWP (10.0 and 10.0.16299)
  • Unity (2018.1)

Documentation

The documentation of AngleSharp is located in the docs folder. More examples, best-practices, and general information can be found there. The documentation also contains a list of frequently asked questions.

More information is also available by following some of the hyper references mentioned in the Wiki. In-depth articles will be published on the CodeProject, with links being placed in the Wiki at GitHub.

Use-Cases

  • Parsing HTML (incl. fragments)
  • Parsing CSS (incl. selectors, declarations, ...)
  • Constructing HTML (e.g., view-engine)
  • Minifying CSS, HTML, ...
  • Querying document elements
  • Crawling information
  • Gathering statistics
  • Web automation
  • Tools with HTML / CSS / ... support
  • Connection to page analytics
  • HTML / DOM unit tests
  • Automated JavaScript interaction
  • Testing other concepts, e.g., script engines
  • ...

Vision

The project aims to bring a solid implementation of the W3C DOM for HTML, SVG, MathML, and CSS to the CLR - all written in C#. The idea is that you can basically do everything with the DOM in C# that you can do in JavaScript (plus, of course, more).

Most parts of the DOM are included, even though some may still miss their (fully specified / correct) implementation. The goal for v1.0 is to have all practically relevant parts implemented according to the official W3C specification (with useful extensions by the WHATWG).

The API is close to the DOM4 specification, however, the naming has been adjusted to apply with .NET conventions. Nevertheless, to make AngleSharp really useful for, e.g., a JavaScript engine, attributes have been placed on the corresponding interfaces (and methods, properties, ...) to indicate the status of the field in the official specification. This allows automatic generation of DOM objects with the official API.

This is a long-term project which will eventually result in a state of the art parser for the most important angle bracket based hyper-texts.

Our hope is to build a community around web parsing and libraries from this project. So far we had great contributions, but that goal was not fully achieved. Want to help? Get in touch with us!

Participating in the Project

If you know some feature that AngleSharp is currently missing, and you are willing to implement the feature, then your contribution is more than welcome! Also if you have a really cool idea - do not be shy, we'd like to hear it.

If you have an idea how to improve the API (or what is missing) then posts / messages are also welcome. For instance there have been ongoing discussions about some styles that have been used by AngleSharp (e.g., HTMLDocument or HtmlDocument) in the past. In the end AngleSharp stopped using HTMLDocument (at least visible outside of the library). Now AngleSharp uses names like IDocument, IHtmlElement and so on. This change would not have been possible without such fruitful discussions.

The project is always searching for additional contributors. Even if you do not have any code to contribute, but rather an idea for improvement, a bug report or a mistake in the documentation. These are the contributions that keep this project active.

Live discussions can take place in our Gitter chat, which supports using GitHub accounts.

More information is found in the contribution guidelines. All contributors can be found in the CONTRIBUTORS file.

This project has also adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community.

For more information see the .NET Foundation Code of Conduct.

Funding / Support

If you use AngleSharp frequently, but you do not have the time to support the project by active participation you may still be interested to ensure that the AngleSharp projects keeps the lights on.

Therefore we created a backing model via Bountysource. Any donation is welcome and much appreciated. We will mostly spend the money on dedicated development time to improve AngleSharp where it needs to be improved, plus invest in the web utility eco-system in .NET (e.g., in JavaScript engines, other parsers, or a renderer for AngleSharp to mention some outstanding projects).

Visit Bountysource for more details.

Development

AngleSharp is written in the most recent version of C# and thus requires Roslyn as a compiler. Using an IDE like Visual Studio 2019+ is recommended on Windows. Alternatively, VSCode (with OmniSharp or another suitable Language Server Protocol implementation) should be the tool of choice on other platforms.

The code tries to be as clean as possible. Notably the following rules are used:

  • Use braces for any conditional / loop body
  • Use the -Async suffixed methods when available
  • Use VIP ("Var If Possible") style (in C++ called AAA: Almost Always Auto) to place types on the right

More important, however, is the proper usage of tests. Any new feature should come with a set of tests to cover the functionality and prevent regression.

Changelog

A very detailed changelog exists. If you are just interested in major releases then have a look at the GitHub releases.

.NET Foundation

This project is supported by the .NET Foundation.

License

The MIT License (MIT)

Copyright (c) 2013 - 2023 AngleSharp

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  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 is compatible.  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-browser 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 is compatible.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 is compatible.  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)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (369)

Showing the top 5 NuGet packages that depend on AngleSharp:

Package Downloads
AngleSharp.Css

Extends the CSSOM from the core AngleSharp library.

HtmlSanitizer

Cleans HTML from constructs that can be used for cross-site scripting (XSS)

PreMailer.Net

PreMailer.Net is a C# utility for moving CSS to inline style attributes, to gain maximum E-mail client compatibility.

WebDriverManager

Automatic Selenium WebDriver binaries management for .Net

Omnia.Fx

Package Description

GitHub repositories (107)

Showing the top 5 popular GitHub repositories that depend on AngleSharp:

Repository Stars
bitwarden/server
The core infrastructure backend (API, database, Docker, etc).
dotnet/AspNetCore.Docs
Documentation for ASP.NET Core
aspnetboilerplate/aspnetboilerplate
ASP.NET Boilerplate - Web Application Framework
Jackett/Jackett
API Support for your favorite torrent trackers
spectreconsole/spectre.console
A .NET library that makes it easier to create beautiful console applications.
Version Downloads Last updated
1.2.0-beta.410 238 3/20/2024
1.2.0-beta.408 104 3/18/2024
1.1.2 45,882 3/7/2024
1.1.2-beta.407 44 3/18/2024
1.1.2-beta.395 55 3/7/2024
1.1.1 25,932 3/1/2024
1.1.1-beta.392 69 2/29/2024
1.1.1-beta.390 63 2/29/2024
1.1.1-beta.389 58 2/29/2024
1.1.1-beta.388 87 2/29/2024
1.1.1-beta.387 185 2/27/2024
1.1.1-beta.386 93 2/25/2024
1.1.1-beta.385 59 2/25/2024
1.1.0 219,013 1/18/2024
1.1.0-beta.384 61 2/23/2024
1.1.0-alpha-379 1,150 1/17/2024
1.1.0-alpha-378 1,114 1/16/2024
1.1.0-alpha-377 1,103 1/16/2024
1.1.0-alpha-376 1,261 1/14/2024
1.1.0-alpha-375 1,221 1/11/2024
1.1.0-alpha-374 1,159 1/11/2024
1.0.7 773,650 11/17/2023
1.0.7-alpha-342 1,520 11/16/2023
1.0.6 45,507 11/11/2023
1.0.6-alpha-341 1,496 11/16/2023
1.0.6-alpha-339 1,502 11/16/2023
1.0.6-alpha-331 1,587 11/11/2023
1.0.6-alpha-330 1,730 11/9/2023
1.0.6-alpha-328 1,574 11/9/2023
1.0.6-alpha-325 4,969 10/17/2023
1.0.6-alpha-321 2,923 10/3/2023
1.0.5 222,951 10/3/2023
1.0.5-alpha-317 1,791 10/3/2023
1.0.4 2,153,164 6/24/2023
1.0.4-alpha-316 1,751 9/25/2023
1.0.4-alpha-314 2,132 8/22/2023
1.0.4-alpha-311 2,125 8/20/2023
1.0.4-alpha-307 1,948 8/20/2023
1.0.4-alpha-301 2,274 7/12/2023
1.0.4-alpha-300 2,470 7/12/2023
1.0.4-alpha-298 2,365 7/12/2023
1.0.4-alpha-290 2,338 6/24/2023
1.0.4-alpha-289 2,451 6/23/2023
1.0.3 130,538 6/8/2023
1.0.3-alpha-287 2,449 6/7/2023
1.0.2 140,384 6/4/2023
1.0.2-alpha-284 2,348 6/4/2023
1.0.2-alpha-283 2,319 6/4/2023
1.0.2-alpha-282 2,440 6/4/2023
1.0.2-alpha-281 5,347 4/28/2023
1.0.2-alpha-278 15,026 2/22/2023
1.0.2-alpha-277 2,342 2/22/2023
1.0.2-alpha-276 2,472 2/22/2023
1.0.2-alpha-275 2,360 2/22/2023
1.0.2-alpha-274 2,303 2/22/2023
1.0.2-alpha-273 2,371 2/22/2023
1.0.2-alpha-261 3,071 2/21/2023
1.0.2-alpha-258 2,393 2/21/2023
1.0.2-alpha-257 2,401 2/21/2023
1.0.2-alpha-255 2,322 2/21/2023
1.0.2-alpha-251 2,378 2/21/2023
1.0.2-alpha-250 2,382 2/21/2023
1.0.2-alpha-249 2,398 2/21/2023
1.0.1 1,288,755 1/16/2023
1.0.1-alpha-248 2,312 2/21/2023
1.0.1-alpha-243 2,425 2/21/2023
1.0.1-alpha-242 2,268 2/21/2023
1.0.1-alpha-241 2,440 2/21/2023
1.0.1-alpha-235 2,294 1/16/2023
1.0.0 43,564 1/10/2023
1.0.0-ci-228 2,773 1/9/2023
1.0.0-alpha-231 2,414 1/9/2023
1.0.0-alpha-229 2,357 1/9/2023
0.17.1 17,259,016 6/2/2022
0.17.1-alpha-179 2,400 6/2/2022
0.17.1-alpha-178 2,327 6/2/2022
0.17.0 844,562 5/31/2022
0.17.0-alpha-177 2,333 6/2/2022
0.17.0-alpha-174 2,347 5/31/2022
0.17.0-alpha-173 2,300 5/31/2022
0.17.0-alpha-172 2,311 5/31/2022
0.17.0-alpha-171 2,321 5/31/2022
0.17.0-alpha-170 2,323 5/30/2022
0.17.0-alpha-169 2,346 5/30/2022
0.16.1 12,749,039 10/7/2021
0.16.1-alpha-99 2,577 6/16/2021
0.16.1-alpha-96 2,693 6/15/2021
0.16.1-alpha-91 2,554 6/14/2021
0.16.1-alpha-168 2,344 5/30/2022
0.16.1-alpha-167 2,300 5/30/2022
0.16.1-alpha-155 2,401 12/7/2021
0.16.1-alpha-153 2,350 12/6/2021
0.16.1-alpha-152 2,470 12/6/2021
0.16.1-alpha-148 2,966 12/1/2021
0.16.1-alpha-145 5,318 11/25/2021
0.16.1-alpha-144 5,068 11/25/2021
0.16.1-alpha-133 5,231 11/24/2021
0.16.1-alpha-127 2,427 11/8/2021
0.16.1-alpha-125 2,431 10/22/2021
0.16.1-alpha-120 2,430 10/6/2021
0.16.1-alpha-114 2,414 8/29/2021
0.16.1-alpha-112 2,446 8/3/2021
0.16.1-alpha-110 2,449 7/19/2021
0.16.1-alpha-108 2,433 6/22/2021
0.16.1-alpha-106 2,497 6/18/2021
0.16.1-alpha-104 2,561 6/18/2021
0.16.0 4,100,413 6/12/2021
0.16.0-alpha-86 2,443 6/12/2021
0.16.0-alpha-85 2,444 6/12/2021
0.16.0-alpha-84 2,486 6/12/2021
0.16.0-alpha-80 2,520 6/10/2021
0.16.0-alpha-79 2,464 6/10/2021
0.16.0-alpha-78 2,438 6/9/2021
0.16.0-alpha-77 2,504 6/9/2021
0.16.0-alpha-76 2,582 6/9/2021
0.16.0-alpha-75 2,353 6/9/2021
0.16.0-alpha-72 2,433 6/8/2021
0.15.0 3,721,828 4/22/2021
0.15.0-alpha-14 2,422 4/22/2021
0.14.0 21,848,337 3/31/2020
0.14.0-alpha-818 3,103 4/5/2020
0.14.0-alpha-817 3,081 4/1/2020
0.14.0-alpha-813 3,152 3/30/2020
0.14.0-alpha-811 3,664 3/26/2020
0.14.0-alpha-809 3,291 3/24/2020
0.14.0-alpha-805 3,957 3/17/2020
0.14.0-alpha-803 3,135 3/17/2020
0.14.0-alpha-802 3,391 3/16/2020
0.14.0-alpha-801 3,773 3/16/2020
0.14.0-alpha-798 5,311 3/12/2020
0.14.0-alpha-796 3,225 3/10/2020
0.14.0-alpha-794 4,278 3/1/2020
0.14.0-alpha-793 3,140 2/29/2020
0.14.0-alpha-790 3,041 2/28/2020
0.14.0-alpha-789 24,382 1/29/2020
0.14.0-alpha-788 10,779 12/8/2019
0.14.0-alpha-787 6,916 10/31/2019
0.14.0-alpha-784 37,023 9/26/2019
0.14.0-alpha-783 3,312 9/24/2019
0.13.0 3,340,556 9/6/2019
0.13.0-alpha-782 3,429 9/20/2019
0.13.0-alpha-775 3,189 9/19/2019
0.13.0-alpha-771 3,648 9/4/2019
0.13.0-alpha-768 4,925 8/26/2019
0.13.0-alpha-766 3,306 8/23/2019
0.13.0-alpha-764 6,087 7/23/2019
0.13.0-alpha-763 5,504 7/8/2019
0.13.0-alpha-760 5,373 6/27/2019
0.13.0-alpha-758 3,925 6/25/2019
0.13.0-alpha-756 5,965 6/10/2019
0.13.0-alpha-754 3,816 6/10/2019
0.13.0-alpha-748 6,010 6/1/2019
0.13.0-alpha-745 3,925 5/31/2019
0.13.0-alpha-744 3,794 5/30/2019
0.13.0-alpha-743 3,955 5/28/2019
0.13.0-alpha-742 4,084 5/23/2019
0.13.0-alpha-739 3,857 5/22/2019
0.13.0-alpha-737 3,748 5/21/2019
0.13.0-alpha-735 4,462 5/19/2019
0.13.0-alpha-734 3,791 5/18/2019
0.13.0-alpha-733 4,010 5/16/2019
0.12.1 2,734,116 5/14/2019
0.12.0 37,662 5/3/2019
0.11.0 465,574 2/12/2019
0.10.1 180,559 1/7/2019
0.10.0 39,186 1/5/2019
0.9.11 5,848,819 11/22/2018
0.9.10 2,042,566 7/15/2018
0.9.9.2 2,037,672 3/12/2018
0.9.9.1 1,070,252 1/3/2018
0.9.9 8,850,901 10/7/2016
0.9.8.1 920,715 9/10/2016
0.9.8 39,328 9/3/2016
0.9.7 268,502 7/17/2016
0.9.6 493,879 5/5/2016
0.9.5 488,368 3/16/2016
0.9.4 384,701 12/30/2015
0.9.3 80,384 10/8/2015
0.9.2 13,285 9/24/2015
0.9.1 12,850 9/9/2015
0.9.0 14,064 8/26/2015
0.8.9 32,940 7/29/2015
0.8.8 14,400 7/22/2015
0.8.7.1 9,219 7/15/2015
0.8.7 5,777 7/15/2015
0.8.6 8,805 7/8/2015
0.8.5 17,431 6/16/2015
0.8.4.1 10,976 6/4/2015
0.8.4 5,372 6/3/2015
0.8.3 23,080 4/21/2015
0.8.2 8,367 4/15/2015
0.8.1 30,936 2/10/2015
0.8.0 7,704 2/2/2015
0.7.0 33,714 11/8/2014
0.6.1 49,596 8/21/2014
0.6.0 22,990 7/27/2014
0.5.1 36,507 5/27/2014
0.5.0 26,393 4/21/2014
0.4.0 21,645 11/21/2013
0.3.7 9,691 9/11/2013
0.3.6 6,653 9/3/2013
0.3.5 5,933 8/29/2013
0.3.4 5,265 8/26/2013
0.3.3 5,237 8/21/2013
0.3.2 5,196 8/18/2013
0.3.1 5,415 8/14/2013
0.3.0 5,203 7/18/2013
0.2.9 6,560 7/10/2013
0.2.8 6,320 7/3/2013
0.2.7 6,239 6/26/2013
0.2.6 6,059 6/19/2013
0.2.5 5,955 6/18/2013
0.2.4 5,937 6/16/2013
0.2.3 5,835 6/12/2013
0.2.2 5,817 6/9/2013
0.2.1 5,849 6/9/2013
0.2.0 14,392 6/5/2013