Package io.cucumber.java8

Class Scenario

java.lang.Object

io.cucumber.java8.Scenario

@API(status=STABLE)
public final class Scenario
extends Object

Before or After Hooks that declare a parameter of this type will receive an instance of this class. It allows writing text and embedding media into reports, as well as inspecting results (in an After block).

Note: This class is not intended to be used to create reports. To create custom reports use the io.cucumber.plugin.Plugin class. The plugin system provides a much richer access to Cucumbers then hooks after could provide. For an example see io.cucumber.core.plugin.PrettyFormatter.

Method Summary

Modifier and Type	Method	Description
void	attach(byte[] data, String mediaType, String name)	Attach data to the report(s).
void	attach(String data, String mediaType, String name)
String	getId()	Returns the unique identifier for this scenario.
Integer	getLine()	Returns the line in the feature file of the Scenario.
String	getName()
Collection<String>	getSourceTagNames()
Status	getStatus()	Returns the current status of this test case.
URI	getUri()
boolean	isFailed()
void	log(String text)	Outputs some text into the report.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getSourceTagNames

public Collection<String> getSourceTagNames()

Returns:

tags of this scenario.

getStatus

public Status getStatus()

Returns the current status of this test case.

The test case status is calculate as the most severe status of the executed steps in the testcase so far.

Returns:

the current status of this test case

isFailed

public boolean isFailed()

Returns:

true if and only if getStatus() returns "failed"

attach

public void attach(byte[] data,
                   String mediaType,
                   String name)

Attach data to the report(s).

 
 // Attach a screenshot. See your UI automation tool's docs for
 // details about how to take a screenshot.
 scenario.attach(pngBytes, "image/png", "Bartholomew and the Bytes of the Oobleck");
 
 

To ensure reporting tools can understand what the data is a mediaType must be provided. For example: text/plain, image/png, text/html;charset=utf-8.

Media types are defined in RFC 7231 Section 3.1.1.1.

Parameters:

data - what to attach, for example an image.

mediaType - what is the data?

name - attachment name

attach

public void attach(String data,
                   String mediaType,
                   String name)

Parameters:

data - what to attach, for example html.

mediaType - what is the data?

name - attachment name

See Also:

attach(byte[], String, String)

log

public void log(String text)

Outputs some text into the report.

Parameters:

text - what to put in the report.

See Also:

attach(byte[], String, String)

getName

public String getName()

Returns:

the name of the Scenario

getId

public String getId()

Returns the unique identifier for this scenario.

If this is a Scenario from Scenario Outlines this will return the id of the example row in the Scenario Outline.

The id is not stable across multiple executions of Cucumber but does correlate with ids used in messages output. Use the uri + line number to obtain a somewhat stable identifier of a scenario.

Returns:

the id of the Scenario.

getUri

public URI getUri()

Returns:

the uri of the Scenario.

getLine

public Integer getLine()

Returns the line in the feature file of the Scenario.

If this is a Scenario from Scenario Outlines this will return the line of the example row in the Scenario Outline.

Returns:

the line in the feature file of the Scenario