compile(group: 'com.aspose', name: 'aspose-html', version: '24.2', classifier: 'jdk17')
<dependency org="com.aspose" name="aspose-html" rev="24.2">
 <artifact name="aspose-html" m:classifier="jdk17" ext="jar"/>
libraryDependencies += "com.aspose" % "aspose-html" % "24.2"

HTML File Manipulation Java API


Product Page | Docs | Demos | API Reference | Examples | Blog | Search | Free Support | Temporary License

The Java HTML API assists developers to write, read, modify, navigate and convert (X)HTML documents from within Java applications.

Aspose.HTML for Java API works as a headless browser that allows you to create or open existing HTML documents from various sources in order to perform manipulation operations such as remove and replace HTML nodes, save HTML documents, extract CSS from HTML, configure a document sandbox and more. You may navigate HTML documents by using various methods, such as, element traversal, document traversal, XPath queries, and CSS selector queries as well as manipulate HTML DOM via JavaScript, convert HTML file to images or fixed layout formats, and convert XHTML and EPUB files to other file formats.

HTML Processing Features

  • Written completely in Java and works with JRE.
  • Supports both the 32-bit & 64-bit OS support.
  • Create or open an existing HTML document from different sources.
  • Ability to manipulate (create, edit, remove, replace) HTML nodes via API.
  • Extract CSS styles for specific HTML node.
  • Configure a document sandbox that affects the processing of HTML documents.
  • Supports navigation through HTML document in various ways (Element Traversal, Document Traversal, XPath queries, CSS Selector queries).
  • Manipulate HTML DOM via JavaScript.
  • Convert web documents to various supported file formats.
  • Extract text from pages.
  • Search text from pages.
  • Add text in HTML file.
  • Create, edit, remove and replace HTML nodes
  • Extracting CSS styles for particular HTML node
  • Convert HTML documents into various supported image formats: JPEG, PNG, BMP, TIFF
  • Convert HTML documents to PDF format
  • Convert HTML documents to XPS format.
  • Download HTML Website Documents

Read & Write Web Formats

Other: SVG*, MD**

Save HTML As

Fixed Layout: PDF, XPS

Read Formats

Images: EPUB

Supported Environments

  • Microsoft Windows: Windows Desktop & Server (x86, x64)
  • macOS: Mac OS X
  • Linux: Ubuntu, OpenSUSE, CentOS, and others
  • Java Versions: J2SE 6.0 (1.6),J2SE 7.0 (1.7),J2SE 8.0 (1.8)

Get Started

Aspose.HTML Java APIs are hosted at the Aspose Repository. You can easily use Aspose.HTML for Java API directly in your Maven projects with simple configurations. For the detailed instructions please visit Installing Aspose.HTML for Java from Aspose Repository documentation page.

Load HTML from a Remote Location

HTMLDocument document = HTMLDocument(new Url("template.html"));
// read children nodes and get length information
if (document.getBody().getChildNodes().getLength() == 0)
    System.out.println("No ChildNodes found...");
// print Document URI to console. As per information above, it has to be https://www.w3.org/TR/html5/
System.out.println("Print Document URI = " + document.getDocumentURI());
// print domain name for remote HTML
System.out.println("Domain Name = " + document.getDomain());

How to use the Examples?

Clone or Download the ZIP and extract the contents to your local hard drive. This project uses Maven/Gradle build system and can be opened in any modern IDE like IntelliJ IDEA, Eclipse or NetBeans. For more details, visit our Documentation website.

Step one

For maven

mvn compile test

For gradle

gradle build

Execute all tests


mvn -Dtest="com.aspose.html.examples.**" test


./gradlew test --tests "com.aspose.html.examples.*"

Execute single test


mvn -Dtest=Examples_Java_AdvancedUsage_DOMMutationObserver_ObserveHowNodesAreAdded test


./gradlew test --tests "com.aspose.html.examples.Examples_Java_AdvancedUsage_DOMMutationObserver_ObserveHowNodesAreAdded"

Execute asynchronously test in Thread


mvn org.codehaus.mojo:exec-maven-plugin:3.0.0:java -Dexec.mainClass="com.aspose.html.examples.SimpleWait" -Dexec.classpathScope="test" -Dexec.cleanupDaemonThreads=false


./gradlew SimpleWait

Product Page | Docs | Demos | API Reference | Examples | Blog | Search | Free Support | Temporary License

VersionRelease Date
24.2February 15, 2024
24.1January 24, 2024
23.12December 30, 2023
23.11November 30, 2023
23.10October 30, 2023
23.8August 3, 2023
23.5.1May 15, 2023
23.5May 3, 2023
23.4April 26, 2023
23.1January 16, 2023
22.9September 20, 2022
22.8August 30, 2022
22.7July 20, 2022
21.12January 16, 2022
21.6July 1, 2021
21.5May 31, 2021
21.4May 2, 2021
21.3April 1, 2021
20.12December 27, 2020
20.9.1October 6, 2020
20.8August 30, 2020
20.6June 26, 2020
19.9September 25, 2019
19.8August 27, 2019
19.7July 29, 2019
19.6June 5, 2019
19.5May 16, 2019
19.4April 21, 2019
19.3March 28, 2019
18.11.1November 21, 2018
18.11November 20, 2018
18.10.2October 30, 2018
18.10.1October 26, 2018
18.10October 19, 2018
18.8August 15, 2018
18.6July 23, 2018
18.5.1June 19, 2018
18.5June 1, 2018
17.12February 7, 2018
17.11.1December 19, 2017
17.11November 29, 2017
17.10November 1, 2017
17.9September 29, 2017
17.8August 29, 2017