cucumber-ruby/features/docs/writing_support_code/hooks/after_hooks.feature

Feature: After Hooks

  After hooks can be used to clean up any state you've altered during your
  scenario, or to check the status of the scenario and act accordingly.

  You can ask a scenario whether it has failed, for example.

  Mind you, even if it hasn't failed yet, you can still make the scenario
  fail if your After hook throws an error.

  Background:
    Given the standard step definitions

  Scenario Outline: Retrieve the status of a scenario as a symbol
    Given a file named "features/support/debug_hook.rb" with:
      """
      After do |scenario|
        log scenario.status.inspect
      end
      """
    And a file named "features/result.feature" with:
      """
      Feature:
        Scenario:
          Given this step <result>
      """
    When I run `cucumber -f progress`
    Then the output should contain "<status symbol>"

    Examples:
      | result     | status symbol |
      | passes     | :passed       |
      | fails      | :failed       |
      | is pending | :pending      |

  Scenario: Check the failed status of a scenario in a hook
    Given a file named "features/support/debug_hook.rb" with:
      """
      After do |scenario|
        if scenario.failed?
          log "eek"
        end
      end
      """
    And a file named "features/fail.feature" with:
      """
      Feature:
        Scenario:
          Given this step fails
      """
    When I run `cucumber -f progress`
    Then the output should contain:
      """
      eek
      """

  Scenario: Make a scenario fail from an After hook
    Given a file named "features/support/bad_hook.rb" with:
      """
      After do
        fail 'yikes'
      end
      """
    And a file named "features/pass.feature" with:
      """
      Feature:
        Scenario:
          Given this step passes
      """
    When I run `cucumber -f pretty`
    Then it should fail with:
      """
        Scenario:                # features/pass.feature:2
          Given this step passes # features/step_definitions/steps.rb:1
            yikes (RuntimeError)
            ./features/support/bad_hook.rb:2:in `After'
      """

  Scenario: After hooks are executed in reverse order of definition
    Given a file named "features/support/hooks.rb" with:
      """
      After do
        log "First"
      end

      After do
        log "Second"
      end
      """
    And a file named "features/pass.feature" with:
      """
      Feature:
        Scenario:
          Given this step passes
      """
    When I run `cucumber -f progress`
    Then the output should contain:
      """
      Second

      First
      """