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 Details

    • 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:

    • log

      public void log(String text)
      Outputs some text into the report.
      Parameters:
      text - what to put in the report.
      See Also:

    • 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