We now have a similar card on feature flags that covers this topic and more
There is a kind of features in web applications that hinder automated integration tests. Examples include cookie consent banners or form captchas. Clearly, these should be disabled so you do not have to explicitly deal with them in each and every test (like, every test starting with accepting the cookies notice). On the other hand, they must be tested as well.
A good feature disabling solution should therefore meet these requirements:
The feature is generally disabled in tests. A test does not need to do anything manually.
It is possible to activate the feature manually, so it can be tested specifically.
Define a constant that is set to
true when in test mode:
class ExampleController < BaseController SKIP_CAPTCHA = Rails.env.test? ...
Next, depend activation of that feature on the value of that constant:
private def captcha_valid? return true if SKIP_CAPTCHA ...
To manually activate the feature in tests that actually need it, override the constant:
Given 'bot detection is enabled' do stub_const 'ExampleController::SKIP_CAPTCHA', false end
You may also choose to enable a feature flag using a tag instead:
Before '@captcha' do stub_const 'ExampleController::SKIP_CAPTCHA', false end