Method: Insite::DefinedPage#initialize

Defined in:

lib/insite/page/defined_page.rb

#initialize(site, args = nil) ⇒ DefinedPage

Initializes a new page object. There’s no need to ever call this method directly. Your site class (the one that includes the Insite module) will handle this for you

# File 'lib/insite/page/defined_page.rb', line 242

def initialize(site, args = nil)
  @site               = site
  @browser            = process_browser

  @component_elements = self.class.component_elements ||= []
  @browser            = @site.browser
  @page_attributes    = self.class.page_attributes
  @page_url           = self.class.page_url
  @page_elements      = self.class.page_elements
  # TODO: Clean this up
  @page_features      = self.class.instance_variable_get(:@page_features)
  @all_arguments      = self.class.arguments
  @required_arguments = self.class.required_arguments
  @url_matcher        = self.class.url_matcher
  @url_template       = self.class.url_template
  @has_fragment       = self.class.has_fragment

  # Try to expand the URL template if the URL has parameters. Stores the
  # param list that will expand the url_template after examining the
  # arguments used to initialize the page. (Start with an empty hash and
  # then build it out.)
  @arguments = {}.with_indifferent_access

  match = @url_template.match(@browser.url)

  if @all_arguments.present? && !args
    @all_arguments.each do |arg|
      if match && match.keys.include?(arg.to_s)
        @arguments[arg] = match[arg.to_s]
      elsif @site.arguments[arg]
        @arguments[arg] = @site.arguments[arg]
      elsif @site.respond_to?(arg) && @site.public_send(arg)
        @arguments[arg] = @site.public_send(arg)
      elsif !@required_arguments.include?(arg)
        @arguments[arg] = nil
      else
        raise(
          Insite::Errors::PageInitError,
          "An error occurred when attempting to build a URL for the #{self.class} page.\n" \
          "URL template:\t#{@url_template.pattern}\n" \
          "URL arguments:\t#{@arguments}\n" \
          "Required args:\t#{@required_arguments.join(', :')}.\n" \
          "Generated URL:\t#{@url_template.expand(@arguments)}\n"
        )
      end
    end
  elsif @all_arguments.present?
    @all_arguments.each do |arg| # Try to extract each URL argument from the hash or object provided, OR from the site object.
      if args.is_a?(Hash) && args.present?
        if @arguments[arg] #The hash has the required argument.
          @arguments[arg]= args[arg]
        elsif match && match.keys.include?(arg.to_s)
          @arguments[arg] = match[arg.to_s]
        elsif @site.respond_to?(arg)
          @arguments[arg] = site.public_send(arg)
        elsif @site.arguments[arg]
          @arguments[arg] = @site.arguments[arg]
        elsif !@required_arguments.include?(arg)
          @arguments[arg] = nil
        else
          raise(
            Insite::Errors::PageInitError,
            "An error occurred when attempting to build a URL for the #{self.class} page.\n" \
            "URL template:\t#{@url_template.pattern}\n" \
            "URL arguments:\t#{@arguments}\n" \
            "Required args:\t#{@required_arguments.join(', :')}.\n" \
            "Generated URL:\t#{@url_template.expand(@arguments)}\n"
          )
        end
      elsif args # Some non-hash object was provided.
        if args.respond_to?(arg) #The hash has the required argument.
          @arguments[arg]= args.public_send(arg)
        elsif @site.respond_to?(arg)
          @arguments[arg]= site.public_send(arg)
        elsif @site.arguments[arg]
          @arguments[arg] = @site.arguments[arg]
        elsif !@required_arguments.include?(arg)
          @arguments[arg] = nil
        else
          raise(
            Insite::Errors::PageInitError,
            "An error occurred when attempting to build a URL for the #{self.class} page.\n" \
            "URL template:\t#{@url_template.pattern}\n" \
            "URL arguments:\t#{@arguments}\n" \
            "Required args:\t#{@required_arguments.join(', :')}.\n" \
            "Generated URL:\t#{@url_template.expand(@arguments)}\n"
          )
        end
      else
        # Do nothing here yet.
      end
    end
  else
    # Do nothing here yet.
  end

  @url = @url_template.expand(@arguments).to_s
  @page_features ||= []
  @page_features.each do |fname|
    begin
      klass = fname.to_s.camelize.constantize
    rescue NameError => e
      klass = self.class.const_get fname.to_s.camelize
    end

    self.class_eval do
      if klass.alias
        define_method(klass.alias) do
          klass.new(self)
        end
      else
        define_method(fname) do
          klass.new(self)
        end
      end
    end
  end

  @site.most_recent_page = self
  unless on_page?
    if navigation_disabled?
      raise(
        Insite::Errors::PageNavigationNotAllowedError,
        "Navigation is intentionally disabled for the #{self.class.name} page. " \
        "You can only call the accessor method for this page when it's already " \
        "being displayed in the browser.\n\nCurrent URL:" \
        "\n------------\n#{@site.browser.url}\n\n#{caller.join("\n")}"
      )
    end

    visit
  end
end