Class: StimulusSpec::Capybara::Matchers::HaveStimulusOutlet

Inherits:
Object
  • Object
show all
Defined in:
lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb

Overview

Capybara matcher for +data-controller-outlet-outlet+ attributes.

Examples:

expect(page).to have_stimulus_outlet("search", "results", "#results-list")

Instance Method Summary collapse

Constructor Details

#initialize(controller, outlet, selector = nil) ⇒ HaveStimulusOutlet

Returns a new instance of HaveStimulusOutlet.

Parameters:

  • controller (String) —

    controller name

  • outlet (String) —

    outlet name

  • selector (String, nil) (defaults to: nil) —

    expected CSS selector value



14
15
16
17
18
19
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb', line 14

def initialize(controller, outlet, selector = nil)
  @controller = controller.to_s
  @outlet = outlet.to_s
  @selector = selector
  @attr = "data-#{@controller}-#{@outlet}-outlet"
end

Instance Method Details

#description ⇒ Object 



59
60
61
62
63
64
65
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb', line 59

def description
  if @selector
    "have Stimulus outlet \"#{@outlet}\" with \"#{@selector}\" for controller \"#{@controller}\""
  else
    "have Stimulus outlet \"#{@outlet}\" for controller \"#{@controller}\""
  end
end

#does_not_match?(page) ⇒ Boolean

Returns:

  • (Boolean) 


43
44
45
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb', line 43

def does_not_match?(page)
  !matches?(page)
end

#failure_message ⇒ Object 



47
48
49
50
51
52
53
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb', line 47

def failure_message
  if @selector && @actual
    "expected #{@attr} to be \"#{@selector}\" but was \"#{@actual}\""
  else
    "expected to find an element with #{@attr} on the page"
  end
end

#failure_message_when_negated ⇒ Object 



55
56
57
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb', line 55

def failure_message_when_negated
  "expected not to find an element with #{@attr} on the page"
end

#matches?(page) ⇒ Boolean

Parameters:

  • page (Capybara::Session, Capybara::Node::Simple)

Returns:

  • (Boolean) 


30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb', line 30

def matches?(page)
  @page = page
  element = page.first(scoped_selector, minimum: 0, wait: 0)
  return false unless element

  if @selector
    @actual = element[@attr]
    @actual == @selector.to_s
  else
    true
  end
end

#within(selector) ⇒ self

Parameters:

  • selector (String) —

    CSS selector for the scope element

Returns:

  • (self) 


23
24
25
26
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_outlet.rb', line 23

def within(selector)
  @scope = selector
  self
end