Class: StimulusSpec::Capybara::Matchers::HaveStimulusValue

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

Overview

Capybara matcher for +data-controller-name-value+ attributes.

Examples:

expect(page).to have_stimulus_value("search", "url", "/results")

Instance Method Summary collapse

Constructor Details

#initialize(controller, name, expected = nil) ⇒ HaveStimulusValue

Returns a new instance of HaveStimulusValue.

Parameters:

  • controller (String) —

    controller name

  • name (String) —

    value name

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

    expected attribute value



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

def initialize(controller, name, expected = nil)
  @controller = controller.to_s
  @name = name.to_s
  @expected = expected
  @attr = "data-#{@controller}-#{@name}-value"
end

Instance Method Details

#description ⇒ Object 



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

def description
  if @expected
    "have Stimulus value \"#{@name}\" with \"#{@expected}\" for controller \"#{@controller}\""
  else
    "have Stimulus value \"#{@name}\" for controller \"#{@controller}\""
  end
end

#does_not_match?(page) ⇒ Boolean

Returns:

  • (Boolean) 


43
44
45
 
# File 'lib/stimulus_spec/capybara/matchers/have_stimulus_value.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_value.rb', line 47

def failure_message
  if @expected && @actual
    "expected #{@attr} to be \"#{@expected}\" 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_value.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_value.rb', line 30

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

  if @expected
    @actual = element[@attr]
    @actual == @expected.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_value.rb', line 23

def within(selector)
  @scope = selector
  self
end