https://github.com/1and1/jsoup-hamcrest
JSoup Hamcrest Matchers brings the power of css matchers to your tests.
https://github.com/1and1/jsoup-hamcrest
acceptance-testing css-selector hamcrest-matchers integration-testing jsoup junit4 junit5 spock-framework testing unit-testing
Last synced: 5 days ago
JSON representation
JSoup Hamcrest Matchers brings the power of css matchers to your tests.
- Host: GitHub
- URL: https://github.com/1and1/jsoup-hamcrest
- Owner: 1and1
- License: apache-2.0
- Created: 2019-12-18T10:21:31.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-18T17:07:35.000Z (over 5 years ago)
- Last Synced: 2025-04-27T11:46:15.511Z (about 2 months ago)
- Topics: acceptance-testing, css-selector, hamcrest-matchers, integration-testing, jsoup, junit4, junit5, spock-framework, testing, unit-testing
- Language: Java
- Size: 25.4 KB
- Stars: 4
- Watchers: 19
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.adoc
- License: License.txt
Awesome Lists containing this project
README
[.float-group]
--
image::https://img.shields.io/maven-central/v/net.oneandone.jsoup/jsoup-hamcrest[link=https://search.maven.org/artifact/net.oneandone.jsoup/jsoup-hamcrest,float=left]
image::https://img.shields.io/github/license/1and1/jsoup-hamcrest[link=License.txt,float=left]
image::https://img.shields.io/travis/1and1/jsoup-hamcrest[link=https://travis-ci.com/1and1/jsoup-hamcrest/branches,float=left]
--
== JSoup Hamcrest Matchers
jsoup-hamcrest brings the power of css matchers to your tests.
=== Maven
[source,xml]
----
net.oneandone.jsoup
jsoup-hamcrest
1.0.0
test
----
You can check the latest version https://search.maven.org/artifact/net.oneandone.jsoup/jsoup-hamcrest[here].
=== Usage
jsoup-hamcrest uses a fluent api design to create your assertions, while still offering the comparability of Hamcrest matchers.
[source,java]
----
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>
----
<1> static import of factory methods for better readability (optional)
<2> create an instance of `JsoupAssertions` using `html` factory method
<3> create an expectation, you can create multiple expectations for a document by chaining `expect` or its alias `and`.
`anElement` creates a matcher for a single element with the given css query.
(There is also `eachElement` and `elements` for performing assertions on each element or on the collection of found elements respectively)
<4> `hasAttribute` asserts the existence of the `placeholder` attribute on the element
<5> `hasAttribute` asserts that the value of the `placeholder` attribute is `Email`
<6> `hasAttribute` asserts that the value of the `placeholder` attribute is `Email` using a hamcrest matcher, you could also use `containsString` for example.
For more examples take a look at the https://github.com/1and1/jsoup-hamcrest/blob/master/src/test/java/net/oneandone/jsoup/hamcrest/AllMatcherHappyTest.java[AllMatcherHappyTest]
or https://github.com/1and1/jsoup-hamcrest/blob/master/src/test/java/net/oneandone/jsoup/hamcrest/FluentExampleTest.java[FluentExampleTest] to see usage examples.