Soft Assertions are the type of assertions that do not throw an exception when an assertion fails and would continue with the next step after assert statement. This is usually used when our test requires multiple assertions to be executed and the user want all of the assertions/codes to be executed before failing/skipping the tests.

Released In

2.2.10-GA

Deprecated in 3.0.1. Please check the new one: Soft Assert Value (soft-assert-value) (assert-now) / deprecated!

Initiate assertion with soft-assert

Usage

Use soft-assert wherever you wanted to use assert, but don't want to fail there too.

With 'name' you can define different sets and evaluate them in different places.

General Syntax

<soft-assert name=""! method=""! actualValue=""! comparedValue=""! tolerance=""? message=""? />

! -mandatory , ? - optional

For more details on assert and its method, please check Assert (assert) / deprecated!

Example

Method

Behaviour

Adding soft assertions to two sets

<soft-assert name="first" method="equals" actualValue="xxxxx" comparedValue="xxxxx" message="xx"/>
<soft-assert name="second" method="equals" actualValue="yyyy" comparedValue="yyyy"/>
<soft-assert name="first" method="equals" actualValue="zzzzz" comparedValue="qqqqqq" />
<soft-assert name="first" method="equals" actualValue="wwwwwww" comparedValue="wwwwwww"/>
<soft-assert name="second" method="equals" actualValue="5" comparedValue="6" tolerance="10" message="5656"/>

creates two sets of assertion based on the names at these point no Assertion error can occur

Adding soft assertions to two sets

<soft-assert method="equals" actualValue="1" name="softAssert" comparedValue="1"/>
<soft-assert method="equals" actualValue="1" name="softAssertWithFail" comparedValue="1"/>
<soft-assert method="equals" actualValue="2" name="softAssert" comparedValue="2" message="don't assert here"/>
<soft-assert method="equals" actualValue="2" name="softAssertWithFail" comparedValue="2" message="don't assert here"/>
<soft-assert method="equals" actualValue="1" name="softAssert" comparedValue="15" tolerance="10" message="assert soon"/>
<soft-assert method="equals" actualValue="1" name="softAssertWithFail" comparedValue="15" tolerance="10" message="assert soon"/>
<soft-assert method="equals" actualValue="51" name="softAssertWithFail" comparedValue="15" message="expected to fail"/>

creates two sets of assertion based on the names at these point no Assertion error can occur

Evaluate assertion with assert-now

Usage

All of the added asserts get evaluated.

PASS: all of the assertions passed
FAIL: at least one of the assertions failed

General Syntax

<assert-now name=""! />

! -mandatory , ? - optional

Example

Method	Behaviour
Evaluating the 'second' soft-assertion set <assert-now name="second" />	PASS and a table with the details results
Evaluating the 'first' soft-assertion set <assert-now name="first" />	FAIL and a table with the details results
Evaluating both soft-assertion set <assert-now name="softAssert"/> <assert-now failWith="AssertionError" name="softAssertWithFail"/>	Both PASS and has separate table with the details

Tolerance

If you wonder why <assert-now name="second" /> PASS, please check the examples in Assert (assert) / deprecated!

Reporting in XRay