require 'capybara' require 'mache/node' module Mache # The {Page} class wraps an HTML page with an application-specific API. You # can extend it to define your own API for manipulating the pages of your web # application. # # @example # # class WelcomePage < Mache::page # element :main, "#main" # component :nav, Nav, "#nav" # end # # page = WelcomePage.new(path: "/welcome") # page.visit # page.current # true # page.main.text # lorem ipsum # class Page < Node # The path where the page is located, without any domain information. # # @return [String] the path string # @example # "/welcome" # "/users/sign_in" attr_reader :path # Returns a new page object. # # @param node [Capybara::Node] a Capybara node to attach to # @param path [String] a path to where the page is located def initialize(node: Capybara.current_session, path: nil) @node ||= node @path ||= path end # Visits the page at its {#path}. # # @return [Page] a page object def visit @node.visit(path) self end # Tests whether the page is current. # # @return [Boolean] `true` if the page is current, `false` otherwise def current? @node.current_path == path end # Creates a new page object and calls {#visit} on it. # # @return [Page] a page object def self.visit new.visit end end end