# 
Version 4.4.0 / July 28, 2024
:heart: [Sponsor](https://github.com/sponsors/rbri)
[](https://maven-badges.herokuapp.com/maven-central/org.htmlunit/htmlunit)
[](https://securityscorecards.dev/viewer/?uri=github.com/HtmlUnit/htmlunit)
### Homepage
[htmlunit.org][4]
[HtmlUnit@mastodon][13] | [HtmlUnit@Twitter][3]
[HtmlUnit Kanban Board][6]
> **Check out HtmlUnit [satellite projects](https://github.com/orgs/HtmlUnit/repositories)**,
such as:
> * [HtmlUnit on android](https://github.com/HtmlUnit/htmlunit-android)
> * [HtmlUnit for .Net](https://github.com/HtmlUnit/NHtmlUnit)
> * or [our Rhino fork](https://github.com/HtmlUnit/htmlunit-rhino-fork) (the JS engine)
>
> Note as well that you can use HtmlUnit with [Selenium](https://www.selenium.dev/) via
> their [htmlunit-driver](https://github.com/SeleniumHQ/htmlunit-driver)!
## Sponsoring
Constantly updating and maintaining the HtmlUnit code base already takes a lot of time.
I would like to make 2 major extensions in the next few months
* [Add HTTP/2 support](https://github.com/HtmlUnit/htmlunit/issues/370)
* [Replace the Rhino based JavaScript engine](https://github.com/HtmlUnit/htmlunit/issues/755)
For doing this I need your [sponsoring](https://github.com/sponsors/rbri).
## Get it!
* [Download from GitHub][12]
* [Download from Sourceforge][1]
* [Release History](https://www.htmlunit.org/changes-report.html)
### Maven
Add to your `pom.xml`:
```xml
org.htmlunit
htmlunit
4.4.0
```
### Gradle
Add to your `build.gradle`:
```groovy
implementation group: 'org.htmlunit', name: 'htmlunit', version: '4.4.0'
```
## Vulnerabilities
[List of Vulnerabilities](https://github.com/HtmlUnit/htmlunit/blob/master/CVE.md)
[Security Policy](https://github.com/HtmlUnit/htmlunit/blob/master/SECURITY.md)
## Overview
HtmlUnit is a "GUI-less browser for Java programs". It models HTML documents and provides an API that allows you to invoke pages, fill out forms, click links, etc... just like you do in your "normal" browser.
It has fairly good JavaScript support (which is constantly improving) and is able to work even with quite complex AJAX libraries, simulating Chrome, Firefox or Internet Explorer depending on the configuration used.
HtmlUnit is typically used for testing purposes or to retrieve information from web sites.
## Features
* Support for the HTTP and HTTPS protocols
* Support for cookies
* Ability to specify whether failing responses from the server should throw exceptions or should be returned as pages of the appropriate type (based on content type)
* Support for submit methods POST and GET (as well as HEAD, DELETE, ...)
* Ability to customize the request headers being sent to the server
* Support for HTML responses
* Wrapper for HTML pages that provides easy access to all information contained inside them
* Support for submitting forms
* Support for clicking links
* Support for walking the DOM model of the HTML document
* Proxy server support
* Support for basic and NTLM authentication
* Excellent JavaScript support
## Getting Started
You can start here:
* [Getting Started][7]
* [The Java Web Scraping Handbook][8] A nice tutorial about webscraping with a lot of background information and details about HtmlUnit.
* [Web Scraping][9] Examples how to implement web scraping using HtmlUnit, Selenium or jaunt and compares them.
* [The Complete Guide to Web Scraping with Java][10] A small straightforward guide to web scraping with Java.
* [How to test Jakarta Faces with HTMLUnit and Arquillian][11]
## Contributing
Pull Requests and all other Community Contributions are essential for open source software.
Every contribution - from bug reports to feature requests, typos to full new features - are greatly appreciated.
## Last CI build
The latest builds are available from our
[Jenkins CI build server][2]
[](https://jenkins.wetator.org/job/HtmlUnit%20-%20Headless/)
Read on if you want to try the latest bleeding-edge snapshot.
### Maven
Add the snapshot repository and dependency to your `pom.xml`:
```xml
OSS Sonatype snapshots
https://s01.oss.sonatype.org/content/repositories/snapshots/
true
always
false
org.htmlunit
htmlunit
4.5.0-SNAPSHOT
```
### Gradle
Add the snapshot repository and dependency to your `build.gradle`:
```groovy
repositories {
maven { url "https://s01.oss.sonatype.org/content/repositories/snapshots" }
// ...
}
// ...
dependencies {
implementation group: 'org.htmlunit', name: 'htmlunit', version: '4.4.0-SNAPSHOT'
// ...
}
```
## License
This project is licensed under the Apache 2.0 License
## Development
### useful mvn command lines
setup as or refresh the eclipse project
```
mvn eclipse:eclipse -DdownloadSources=true
```
run the whole core test suite (no huge tests, no libary tests)
```
mvn test -U -P without-library-and-huge-tests -Dgpg.skip -Djava.awt.headless=true
```
check dependencies for known security problems
```
mvn dependency-check:check
```
### Contributing
I welcome contributions, especially in the form of pull requests.
Please try to keep your pull requests small (don't bundle unrelated changes) and try to include test cases.
## Some insights
[HtmlUnit at openhub][5]
### Stargazers
[](https://starchart.cc/HtmlUnit/htmlunit)
[1]: https://sourceforge.net/projects/htmlunit/files/htmlunit/4.1.0/ "HtmlUnit on sourceforge"
[2]: https://jenkins.wetator.org/view/HtmlUnit/ "HtmlUnit CI"
[3]: https://twitter.com/HtmlUnit "https://twitter.com/HtmlUnit"
[4]: https://www.htmlunit.org "https://www.htmlunit.org"
[5]: https://www.openhub.net/p/HtmlUnit "https://www.openhub.net/p/HtmlUnit"
[6]: https://github.com/HtmlUnit/htmlunit/projects/1 "https://github.com/HtmlUnit/htmlunit/projects/1"
[7]: https://www.htmlunit.org/gettingStarted.html
[8]: https://www.scrapingbee.com/java-webscraping-book/
[9]: https://www.innoq.com/en/blog/webscraping/
[10]: https://www.webscrapingapi.com/java-web-scraping/
[11]: http://www.mastertheboss.com/java-ee/jsf/how-to-test-jakarta-faces-with-htmlunit-and-arquillian
[12]: https://github.com/HtmlUnit/htmlunit/releases
[13]: https://fosstodon.org/@HtmlUnit