IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.

« Randomized testing Glossary of terms »

› › ›

Assertions

edit

Assertions

edit

As many Elasticsearch tests are checking for a similar output, like the amount of hits or the first hit or special highlighting, a couple of predefined assertions have been created. Those have been put into the ElasticsearchAssertions class. There is also a specific geo assertions in ElasticsearchGeoAssertions.

`assertHitCount()`	Checks hit count of a search or count request
`assertAcked()`	Ensure the a request has been acknowledged by the master
`assertSearchHits()`	Asserts a search response contains specific ids
`assertMatchCount()`	Asserts a matching count from a percolation response
`assertFirstHit()`	Asserts the first hit hits the specified matcher
`assertSecondHit()`	Asserts the second hit hits the specified matcher
`assertThirdHit()`	Asserts the third hit hits the specified matcher
`assertSearchHit()`	Assert a certain element in a search response hits the specified matcher
`assertNoFailures()`	Asserts that no shard failures have occurred in the response
`assertFailures()`	Asserts that shard failures have happened during a search request
`assertHighlight()`	Assert specific highlights matched
`assertSuggestion()`	Assert for specific suggestions
`assertSuggestionSize()`	Assert for specific suggestion count
`assertThrows()`	Assert a specific exception has been thrown

Common matchers

`hasId()`	Matcher to check for a search hit id
`hasType()`	Matcher to check for a search hit type
`hasIndex()`	Matcher to check for a search hit index
`hasScore()`	Matcher to check for a certain score of a hit
`hasStatus()`	Matcher to check for a certain `RestStatus` of a response

Usually, you would combine assertions and matchers in your test like this

SearchResponse searchResponse = client().prepareSearch() ...;
assertHitCount(searchResponse, 4);
assertFirstHit(searchResponse, hasId("4"));
assertSearchHits(searchResponse, "1", "2", "3", "4");

« Randomized testing Glossary of terms »