module Capybara::SpecHelper

Public Class Methods

configure(config) click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 20
def configure(config)
  config.filter_run_excluding requires: method(:filter).to_proc
  config.before { Capybara::SpecHelper.reset! }
  config.after { Capybara::SpecHelper.reset! }
  # Test in 3.5+ where metadata doesn't autotrigger shared context inclusion - will be only behavior in RSpec 4
  config.shared_context_metadata_behavior = :apply_to_host_groups if RSpec::Core::Version::STRING.to_f >= 3.5
end
filter(requires, metadata) click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 44
def filter(requires, metadata)
  if requires and metadata[:capybara_skip]
    requires.any? do |require|
      metadata[:capybara_skip].include?(require)
    end
  else
    false
  end
end
reset!() click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 28
def reset!
  Capybara.app = TestApp
  Capybara.app_host = nil
  Capybara.default_selector = :xpath
  Capybara.default_max_wait_time = 1
  Capybara.ignore_hidden_elements = true
  Capybara.exact = false
  Capybara.exact_options = false
  Capybara.raise_server_errors = true
  Capybara.visible_text_only = false
  Capybara.match = :smart
  Capybara.wait_on_first_by_default = false
  Capybara.enable_aria_label = false
  reset_threadsafe
end
reset_threadsafe(bool = false, session = nil) click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 88
def reset_threadsafe(bool = false, session = nil)
  Capybara::Session.class_variable_set(:@@instance_created, false) # Work around limit on when threadsafe can be changed
  Capybara.threadsafe = bool
  session = session.current_session if session.respond_to?(:current_session)
  session.instance_variable_set(:@config, nil) if session
end
run_specs(session, name, options={}) click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 59
def run_specs(session, name, options={})
  specs = @specs
  RSpec.describe Capybara::Session, name, options do
    include Capybara::SpecHelper
    include Capybara::RSpecMatchers
    before do
      @session = session
    end

    after do
      @session.reset_session!
    end

    before :each, psc: true do
      SpecHelper.reset_threadsafe(true, @session)
    end

    after psc: true do
      SpecHelper.reset_threadsafe(false, @session)
    end

    specs.each do |spec_name, spec_options, block|
      describe spec_name, spec_options do
        class_eval(&block)
      end
    end
  end
end
spec(name, options={}, &block) click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 54
def spec(name, options={}, &block)
  @specs ||= []
  @specs << [name, options, block]
end

Public Instance Methods

extract_results(session) click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 113
def extract_results(session)
  expect(session).to have_xpath("//pre[@id='results']")
  YAML.load Nokogiri::HTML(session.body).xpath("//pre[@id='results']").first.inner_html.lstrip
end
marionette?(session) click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 118
def marionette?(session)
  session.driver.respond_to?(:marionette?, true) && session.driver.send(:marionette?)
end
quietly() { || ... } click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 105
def quietly
  silence_stream(STDOUT) do
    silence_stream(STDERR) do
      yield
    end
  end
end
rspec2?() click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 122
def rspec2?
  !defined?(::RSpec::Expectations::Version) || (Gem::Version.new(RSpec::Expectations::Version::STRING) < Gem::Version.new('3.0'))
end
silence_stream(stream) { || ... } click to toggle source
# File lib/capybara/spec/spec_helper.rb, line 96
def silence_stream(stream)
  old_stream = stream.dup
  stream.reopen(RbConfig::CONFIG['host_os'] =~ /rmswin|mingw/ ? 'NUL:' : '/dev/null')
  stream.sync = true
  yield
ensure
  stream.reopen(old_stream)
end