Module: Capybara::SpecHelper

Defined in:
lib/capybara/spec/spec_helper.rb

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.configure(config) ⇒ Object



12
13
14
15
16
17
18
# File 'lib/capybara/spec/spec_helper.rb', line 12

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. = :apply_to_host_groups if RSpec::Core::Version::STRING.to_f >= 3.5
end

.filter(requires, metadata) ⇒ Object



34
35
36
37
38
39
40
41
42
# File 'lib/capybara/spec/spec_helper.rb', line 34

def filter(requires, )
  if requires and [:capybara_skip]
    requires.any? do |require|
      [:capybara_skip].include?(require)
    end
  else
    false
  end
end

.reset!Object



20
21
22
23
24
25
26
27
28
29
30
31
32
# File 'lib/capybara/spec/spec_helper.rb', line 20

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.raise_server_errors = true
  Capybara.visible_text_only = false
  Capybara.match = :smart
  Capybara.enable_aria_label = false
  reset_threadsafe
end

.reset_threadsafe(bool = false, session = nil) ⇒ Object



78
79
80
81
82
83
# File 'lib/capybara/spec/spec_helper.rb', line 78

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) ⇒ Object



49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
# File 'lib/capybara/spec/spec_helper.rb', line 49

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) ⇒ Object



44
45
46
47
# File 'lib/capybara/spec/spec_helper.rb', line 44

def spec(name, *options, &block)
  @specs ||= []
  @specs << [name, options, block]
end

Instance Method Details

#extract_results(session) ⇒ Object



103
104
105
106
# File 'lib/capybara/spec/spec_helper.rb', line 103

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) ⇒ Boolean

Returns:

  • (Boolean)


108
109
110
# File 'lib/capybara/spec/spec_helper.rb', line 108

def marionette?(session)
  session.driver.respond_to?(:marionette?, true) && session.driver.send(:marionette?)
end

#quietlyObject



95
96
97
98
99
100
101
# File 'lib/capybara/spec/spec_helper.rb', line 95

def quietly
  silence_stream(STDOUT) do
    silence_stream(STDERR) do
      yield
    end
  end
end

#silence_stream(stream) ⇒ Object

class << self



86
87
88
89
90
91
92
93
# File 'lib/capybara/spec/spec_helper.rb', line 86

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