Class: Screengem::ScreenElements

Inherits:
Object
  • Object
show all
Includes:
Singleton
Defined in:
lib/screengem/screen_elements.rb

Overview

Singleton that gives the ability to get references to screen elements.

On initialization generate a factory method for each screen element. If the screen element defines a visit_path method then we wrap the screen element to support auto visit.

Examples:

def 
  ScreenElements::LoginPage.new
end

def 
  Screengem::AutomaticVisit.new(ScreenElements::LoginPage.new)
end

Instance Method Summary collapse

Constructor Details

#initialize ⇒ ScreenElements

Returns a new instance of ScreenElements.



21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 
# File 'lib/screengem/screen_elements.rb', line 21

def initialize
  generated_method_names = []

  Screengem::ScreenElement.descendants.each do |screen_element_class|
    # Skip any anonymous classes. We can't do anything with them. Probably they're from testing.
    next if screen_element_class.anonymous?

    class_name = screen_element_class.name
    method_name = class_name.demodulize.underscore

    # Create some safety by detecting and failing fast for duplicate creation method names.
    if generated_method_names.include?(method_name)
      raise "Name collision: two screen elements resolve to '#{method_name}'."
    end

    generated_method_names << method_name

    if auto_visit?(screen_element_class)
      class_eval(<<~RUBY, __FILE__, __LINE__ + 1)
        def #{method_name}(...)
          Screengem::AutomaticVisit.new(#{class_name}.new(...))
        end
      RUBY
    else
      class_eval(<<~RUBY, __FILE__, __LINE__ + 1)
        def #{method_name}(...)
          #{class_name}.new(...)
        end
      RUBY
    end
  end
end