org.mockito.quality

Enum Strictness

java.lang.Object

java.lang.Enum<Strictness>

org.mockito.quality.Strictness

All Implemented Interfaces:

Serializable, Comparable<Strictness>

@Incubating
public enum Strictness
extends Enum<Strictness>

Configures the "strictness" of Mockito during a mocking session. A session typically maps to a single test method invocation. Strictness drives cleaner tests and better productivity. The easiest way to leverage enhanced Strictness is using Mockito's JUnit support (MockitoRule or MockitoJUnitRunner). If you cannot use JUnit support MockitoSession is the way to go.

How strictness level influences the behavior of the test (mocking session)?

1. LENIENT - no added behavior. The default of Mockito 1.x. Recommended only if you cannot use STRICT_STUBS nor WARN.
2. WARN - helps keeping tests clean and improves debuggability. Reports console warnings about unused stubs and stubbing argument mismatch (see MockitoHint). The default behavior of Mockito 2.x when JUnitRule or MockitoJUnitRunner are used.
Recommended if you cannot use STRICT_STUBS.
3. STRICT_STUBS - ensures clean tests, reduces test code duplication, improves debuggability. Best combination of flexibility and productivity. Highly recommended. Planned as default for Mockito v3. See STRICT_STUBS for the details.

Since:

2.3.0

Enum Constant Summary

Enum Constants

Enum Constant and Description
LENIENT No extra strictness.
STRICT_STUBS Ensures clean tests, reduces test code duplication, improves debuggability.
WARN Helps keeping tests clean and improves debuggability.

Method Summary

Modifier and Type	Method and Description
static Strictness	valueOf(String name) Returns the enum constant of this type with the specified name.
static Strictness[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

LENIENT

@Incubating
public static final Strictness LENIENT

No extra strictness. Mockito 1.x behavior. Recommended only if you cannot use STRICT_STUBS nor WARN.

For more information see Strictness.

Since:

2.3.0

WARN

@Incubating
public static final Strictness WARN

Helps keeping tests clean and improves debuggability. Extra warnings emitted to the console, see MockitoHint. Default Mockito 2.x behavior. Recommended if you cannot use STRICT_STUBS.

For more information see Strictness.

Since:

2.3.0

STRICT_STUBS

@Incubating
public static final Strictness STRICT_STUBS

Ensures clean tests, reduces test code duplication, improves debuggability. Offers best combination of flexibility and productivity. Highly recommended. Planned as default for Mockito v3.

Adds following behavior:

• Improved productivity: the test fails early when code under test invokes stubbed method with different arguments (see PotentialStubbingProblem).
• Cleaner tests without unnecessary stubbings: the test fails when unused stubs are present (see UnnecessaryStubbingException).
• Cleaner, more DRY tests ("Don't Repeat Yourself"): If you use Mockito.verifyNoMoreInteractions(Object...) you no longer need to explicitly verify stubbed invocations. They are automatically verified for you. However if you have more invocations, the test won't fail since it won't check that there are no more interactions on that stub.

For more information see Strictness.

Since:

2.3.0

Method Detail

values

public static Strictness[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (Strictness c : Strictness.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static Strictness valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null