Module org.junit.jupiter.params

Package org.junit.jupiter.params.provider

Annotation Type ValueSource

@Target({ANNOTATION_TYPE,METHOD})
@Retention(RUNTIME)
@Documented
@API(status=STABLE,
     since="5.7")
@ArgumentsSource(org.junit.jupiter.params.provider.ValueArgumentsProvider.class)
public @interface ValueSource

@ValueSource is an ArgumentsSource which provides access to an array of literal values.

Supported types include shorts(), bytes(), ints(), longs(), floats(), doubles(), chars(), booleans(), strings(), and classes(). Note, however, that only one of the supported types may be specified per @ValueSource declaration.

The supplied literal values will be provided as arguments to the annotated @ParameterizedTest method.

Since:

5.0

See Also:

ArgumentsSource, ParameterizedTest

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
boolean[]	booleans	The boolean values to use as sources of arguments; must not be empty.
byte[]	bytes	The byte values to use as sources of arguments; must not be empty.
char[]	chars	The char values to use as sources of arguments; must not be empty.
Class<?>[]	classes	The Class values to use as sources of arguments; must not be empty.
double[]	doubles	The double values to use as sources of arguments; must not be empty.
float[]	floats	The float values to use as sources of arguments; must not be empty.
int[]	ints	The int values to use as sources of arguments; must not be empty.
long[]	longs	The long values to use as sources of arguments; must not be empty.
short[]	shorts	The short values to use as sources of arguments; must not be empty.
String[]	strings	The String values to use as sources of arguments; must not be empty.

Element Detail

shorts

short[] shorts

The short values to use as sources of arguments; must not be empty.

Since:

5.1

Default:

{}

bytes

byte[] bytes

The byte values to use as sources of arguments; must not be empty.

Since:

5.1

Default:

{}

ints

int[] ints

The int values to use as sources of arguments; must not be empty.

Default:

{}

longs

long[] longs

The long values to use as sources of arguments; must not be empty.

Default:

{}

floats

float[] floats

The float values to use as sources of arguments; must not be empty.

Since:

5.1

Default:

{}

doubles

double[] doubles

The double values to use as sources of arguments; must not be empty.

Default:

{}

chars

char[] chars

The char values to use as sources of arguments; must not be empty.

Since:

5.1

Default:

{}

booleans

boolean[] booleans

The boolean values to use as sources of arguments; must not be empty.

Since:

5.5

Default:

{}

strings

String[] strings

The String values to use as sources of arguments; must not be empty.

Default:

{}

classes

Class<?>[] classes

The Class values to use as sources of arguments; must not be empty.

Since:

5.1

Default:

{}