Class: StimulusSpec::Matchers::HaveStimulusOutlet

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

Overview

Asserts that rendered HTML contains a +data-controller-outlet-outlet+ attribute.

Examples:

Existence check

expect(response).to have_stimulus_outlet("search", "results")

Selector check

expect(response).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 (omit for existence check)



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

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/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?(subject) ⇒ Boolean

Returns:

  • (Boolean) 


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

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

#failure_message ⇒ Object 



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

def failure_message
  if @selector && @actual
    "expected #{@attr} to be \"#{@selector}\" but was \"#{@actual}\"\n  on: #{@element.to_html}"
  else
    "expected to find an element with #{@attr} but found none in:\n#{snippet}"
  end
end

#failure_message_when_negated ⇒ Object 



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

def failure_message_when_negated
  "expected not to find an element with #{@attr} but found one"
end

#matches?(subject) ⇒ Boolean

Parameters:

  • subject (#body, String) —

    response object or HTML string

Returns:

  • (Boolean) 


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

def matches?(subject)
  @body = extract_body(subject)
  @doc = Nokogiri::HTML5.fragment(@body)
  @element = search_root&.at_css("[#{@attr}]")
  return false unless @element

  return true unless @selector

  @actual = @element[@attr]
  @actual == @selector.to_s
end

#within(selector) ⇒ self

Parameters:

  • selector (String) —

    CSS selector for the scope element

Returns:

  • (self) 


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

def within(selector)
  @scope = selector
  self
end