cucumber-ruby/features/docs/writing_support_code/hooks

• Cucumber Hooks
• • InstallPlugin
  • BeforeAll and AfterAll
  • Around
  • Before and After
  • AfterStep

Cucumber Hooks

Cucumber proposes several hooks to let you specify some code to be executed at
different stages of test execution, like before or after the execution of a
scenario.

Hooks are part of your support code.

They are executed in the following order:

• InstallPlugin
• BeforeAll
  • Per scenario:
    • Around
    • Before
      • Per step:
        • AfterStep
    • After
• AfterAll

You can define as many hooks as you want. If you have several hooks of the same
types - for example, several BeforeAll hooks - they will be all executed once.

Multiple hooks of the same type are executed in the order that they were defined.
If you wish to control this order, use manual requires in env.rb - This file is
loaded first - or migrate them all to one hooks.rb file.

Finaly, all hooks can be given a name to improve reporting and help debugging.

Note: Hooks names are only reported when using the message and the html formatters.

InstallPlugin

InstallPlugin hook is dedicated to using plugins and is meant to
extend Cucumber. For example, it allows to dynamically change the configuration
before the execution of tests or to add some code that could impact the execution itself.

In addition to the configuration, InstallPlugin has access to some of the Cucumber
internals through a RegistryWrapper, defined in
lib/cucumber/glue/registry_wrapper.rb.

InstallPlugin do |configuration, registry|
  # configuration is an instance of Cucumber::Configuration defined in
  # lib/cucumber/configuration.rb
  #
  # registry is an instance of Cucumber::Glue::RegistryWrapper defined in
  # lib/cucumber/glue/registry_wrapper.rb
end

# named hook:

InstallPlugin(name: 'Installation of a plugin') do |configuration, registry|
  # The name is optional
end

You can see an example in the Cucumber Wire plugin.

BeforeAll and AfterAll

BeforeAll is executed once before the execution of the first scenario. AfterAll
is executed once after the execution of the last scenario.

These two types of hooks have no parameters. Their purpose is to set-up and/or clean-up
your environment not related to Cucumber, like a database or a browser.

BeforeAll do
  # snip
end

AfterAll do
  # snip
end

# Named hooks:

BeforeAll(name: 'Name of the hook') do
  # snip
end

AfterAll(name: 'Name of the hook') do
  # snip
end

Around

Note: Around is a legacy hook and its usage is discouraged in favor of
Before and After hooks.

Around is a special hook which allows you to have a block syntax. Its original
purpose was to support some databases with only block syntax for transactions.

Around do |scenario, block|
  SomeDatabase::begin_transaction do # this is just for illustration
    block.call
  end
end

# with a name:

Around(name: 'Name of the hook') do |scenario, block|
  # snip
end

Before and After

Before is executed before each test case. After is executed after each test case.
They both have the test case being executed as a parameter. Within the After hook,
the status of the test case is also available.

Before do |test_case|
  log test_case.name
end

After do |test_case|
  log test_case.failed?
  log test_case.status
end

# With names:

Before(name: 'Name of the hook') do |test_case|
  # snip
end

After(name: 'Name of the hook') do |test_case|
  # snip
end

AfterStep

AfterStep is executed after each step of a test. If steps are not executed due
to a previous failure, AfterStep won't be executed either.

AfterStep do |result, test_step|
  log test_step.inspect # test_step is a Cucumber::Core::Test::Step
  log result.inspect # result is a Cucumber::Core::Test::Result
end

# with a name:

AfterStep(name: 'Named hook') do |result, test_step|
  # snip
end