JarCasting
JSoup Hamcrest Matchers
jsoup-hamcrest brings the power of css matchers to your tests.
Maven
<dependencies>
<dependency>
<groupId>net.oneandone.jsoup</groupId>
<artifactId>jsoup-hamcrest</artifactId>
<version>1.0.0</version>
<scope>test</scope>
</dependency>
</dependencies>
You can check the latest version here.
Usage
jsoup-hamcrest uses a fluent api design to create your assertions, while still offering the comparability of Hamcrest matchers.
import static net.oneandone.jsoup.hamcrest.fluent.DocumentAssertions.anElement; // (1)
import static net.oneandone.jsoup.hamcrest.fluent.JsoupAssertions.html; // (1)
html(source) // (2)
.expect(anElement("#exampleInputEmail") // (3)
.hasAttribute("placeholder") // (4)
.hasAttribute("placeholder", "Email") // (5)
.hasAttribute("placeholder", equalTo("Email"))); // (6)
-
static import of factory methods for better readability (optional)
-
create an instance of
JsoupAssertionsusinghtmlfactory method -
create an expectation, you can create multiple expectations for a document by chaining
expector its aliasand.anElementcreates a matcher for a single element with the given css query. (There is alsoeachElementandelementsfor performing assertions on each element or on the collection of found elements respectively) -
hasAttributeasserts the existence of theplaceholderattribute on the element -
hasAttributeasserts that the value of theplaceholderattribute isEmail -
hasAttributeasserts that the value of theplaceholderattribute isEmailusing a hamcrest matcher, you could also usecontainsStringfor example.
For more examples take a look at the AllMatcherHappyTest or FluentExampleTest to see usage examples.
