bdd-helper 0.0.4 → 1.0.2

data/lib/steps/assertion/assertion_steps.rb

@@ -0,0 +1,314 @@
+# frozen_string = true
+begin
+  Then(/^verify "([^"]*)" text is displayed$/) do |text|
+    # E.g : Then verify "Thank you for filling in the form" text is displayed
+    page.should have_text(text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" text is not displayed$/) do |text|
+    # E.g : Then verify "Thank you for filling in the form" text is not displayed
+    page.should_not have_text(text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" element has "([^"]*)" text$/) do |selector, text|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify ".success-message" element has "Welcome" text
+    page.should have_selector(selector, text: text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" element has not "([^"]*)" text$/) do |selector, text|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify ".success-message" element has not "Welcome" text
+    page.should_not have_selector(selector, text: text, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" element contains "([^"]*)" text$/) do |selector, text|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify ".success-message" element contains "elcom" text
+    page.should have_selector(selector, text: text, exact_text: false, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" (css|xpath) element starts with "([^"]*)" text$/) do |selector, selector_type, text|
+    "
+      Selector can be css or xpath.
+    "
+    # E.g : Then verify "#select-class-example legend" css element starts with "Select" text
+    case selector_type
+    when "xpath"
+      find(:xpath, "#{selector}").text.should start_with(text)
+    else #which is css
+      find(:css, "#{selector}").text.should start_with(text)
+    end
+  end
+
+  Then(/^verify "([^"]*)" (css|xpath) element ends with "([^"]*)" text$/) do |selector, selector_type, text|
+    "
+      Selector can be css or xpath.
+    "
+    # E.g : Then verify "//*[@id='open-tab-example-div']" xpath element ends with "Tab" text
+    case selector_type
+    when "xpath"
+      find(:xpath, "#{selector}").text.should end_with(text)
+    else
+      #which is css
+      find(:css, "#{selector}").text.should end_with(text)
+    end
+  end
+
+  Then(/^verify page has (\d+) (?:occurrences|occurrence) of "([^"]*)" element$/) do |number,selector|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify page has 7 occurrences of "[name='cars']" element
+    expect(page).to have_selector(selector, visible: true, count: number, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify page has minimum (\d+) (?:occurrences|occurrence) of "([^"]*)" element$/) do |number, selector|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify page has minimum 1 occurrence of "[name='cars']" element
+    page.assert_selector(selector, minimum: number, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify page has maximum (\d+) (?:occurrences|occurrence) of "([^"]*)" element$/) do |number, selector|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify page has maximum 8 occurrences of "[name='cars']" element
+    page.assert_selector(selector, maximum: number, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify page has between (\d+) and (\d+) occurrences of "([^"]*)" element$/) do |minimum, maximum, selector|
+    "
+      Selector should be a css selector
+    "
+    # E.g : Then verify page has between 1 and 7 occurrences of "[name='cars']" element
+    page.assert_selector(selector, between: minimum..maximum, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" (css|xpath) element has "([^"]*)" text$/) do |selector, selector_type, text|
+    "
+      Selector can be xpath or css.
+    "
+    # E.g : Then verify ".success-message" css element has "Welcome" text
+    case selector_type
+    when "xpath"
+      page.should have_xpath(selector, text: text)
+    else #which is css
+      page.should have_css(selector, text: text)
+    end
+  end
+
+  Then(/^verify "([^"]*)" (css|xpath) element has not "([^"]*)" text$/) do |selector, selector_type, text|
+    "
+      Selector can be xpath or css.
+    "
+    # E.g : Then verify ".success-message" css element has not "Welcome" text
+    case selector_type
+    when "xpath"
+      find(:xpath,"#{selector}").text.should_not == text
+    else #which is css
+      find(:css,"#{selector}").text.should_not == text
+    end
+  end
+
+  Then(/^verify "([^"]*)" button is displayed$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is displayed
+    page.should have_button(button, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" button is not displayed$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is not displayed
+    page.should_not have_button(button, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" button is enabled$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is enabled
+    page.should have_button(button, disabled: false, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" button is disabled$/) do |button|
+    "
+      Button can be id, name, value, or title
+    "
+    # E.g : Then verify "Login" button is disabled
+    page.should have_button(button, disabled: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify current url is "([^"]*)"$/) do |expected_url|
+    "
+      Expected url should be fully URL of the current page
+    "
+    # E.g : Then verify current url is "http:www.example.com"
+    current_url.should == expected_url
+  end
+
+  Then(/^verify current path is "([^"]*)"$/) do |current_path|
+    "
+      Path should be path+query of the current page
+    "
+    # E.g : Then verify current path is "/login"
+    assert_current_path(current_path)
+  end
+
+  Then(/^verify page title is "([^"]*)"$/) do |page_title|
+    "
+      Title should be title of the current page
+    "
+    # E.g : Then verify page title is "Welcome"
+    assert_title(page_title, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify page title contains "([^"]*)"$/) do |text|
+    "
+      Title should be contains of the current page title
+    "
+    # E.g : Then verify page title contains "Welcome"
+    title.should include(text)
+  end
+
+  Then(/^verify below texts are displayed:$/) do |table|
+    # E.g : Then verify below texts are displayed:
+    #       | Welcome   |
+    #       | Thank you |
+    table.raw.each { |raw| page.should have_text(raw[0], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify below texts are not displayed:$/) do |table|
+    # E.g : Then verify below texts are not displayed:
+    #       | Welcome   |
+    #       | Thank you |
+    table.raw.each { |raw| page.should_not have_text(raw[0], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify "([^"]*)" alert message is displayed$/) do |text|
+    # E.g : Then verify "Successful" alert message is displayed
+    text.should == page.driver.browser.switch_to.alert.text
+  end
+
+  Then(/^verify "([^"]*)" alert message is not displayed$/) do |text|
+    # E.g : Then verify "Successful" alert message is not displayed
+    text.should_not == page.driver.browser.switch_to.alert.text
+  end
+
+  Then(/^verify "([^"]*)" checkbox is checked$/) do |checkbox|
+    "
+      Checkbox can be name, id and label text
+    "
+    # E.g : Then verify "Terms & Conditions" checkbox is checked
+    expect(page).to have_field(checkbox, checked: true, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" checkbox is unchecked/) do |checkbox|
+    "
+      Checkbox can be name, id and label text
+    "
+    # E.g : Then verify "Terms & Conditions" checkbox is unchecked
+    expect(page).to have_field(checkbox, checked: false, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" radio button is selected$/) do |radio_button|
+    "
+      Radio Button can be name, id and label text
+    "
+    # E.g : Then verify "Male" radio button is selected
+    expect(page).to have_field(radio_button, checked: true, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" radio button is not selected$/) do |radio_button|
+    "
+      Radio Button can be name, id and label text
+    "
+    # E.g : Then verify "Female" radio button is not selected
+    expect(page).to have_field(radio_button, checked: false, visible: true, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" dropdown contains "([^"]*)" option$/) do |dropdown, option_text|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown contains "United States" option
+    page.should have_select(dropdown, with_options: [option_text], wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" dropdown does not contain "([^"]*)" option$/) do |dropdown, option_text|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown does not contain "United States" option
+    page.should_not have_select(dropdown, with_options: [option_text], wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" dropdown contains the options below:$/) do |dropdown, table|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown contains the options below:
+    #       |United States|
+    #       |Turkey       |
+    table.raw.each { |raw| page.should have_select(dropdown, with_options: [raw[0]], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify "([^"]*)" dropdown does not contain the options below:$/) do |dropdown, table|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "Country" dropdown does not contain the options below:
+    #       |United States|
+    #       |Turkey       |
+    table.raw.each { |raw| page.should_not have_select(dropdown, with_options: [raw[0]], wait: BddHelper.timeout) }
+  end
+
+  Then(/^verify "([^"]*)" options is selected from "([^"]*)" dropdown$/) do |option, dropdown|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "United States" options is selected from "Country" dropdown
+    page.should have_select(dropdown, selected: option, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify "([^"]*)" options is not selected from "([^"]*)" dropdown$/) do |option, dropdown|
+    "
+      Dropdown can be id, name, label
+    "
+    # E.g : Then verify "United States" options is not selected from "Country" dropdown
+    page.should_not have_select(dropdown, selected: option, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify page has "([^"]*)" (css|xpath) element$/) do |locator, locator_type|
+    "
+      Locator type can be 'css' or 'xpath'.
+      Then the locator should be given correspondingly.
+    "
+    #E.g. : Then verify page has ".class" css element
+    page.assert_selector("#{locator_type}".to_sym, locator, wait: BddHelper.timeout)
+  end
+
+  Then(/^verify page has not "([^"]*)" (css|xpath) element$/) do |locator, locator_type|
+    "
+      Locator type can be 'css' or 'xpath'.
+      Then the locator should be given correspondingly.
+    "
+    #E.g. : Then verify page has not ".class" css element
+    page.should_not have_selector("#{locator_type}".to_sym, locator, wait: BddHelper.timeout)
+  end
+
+rescue StandardError => e
+  puts e
+end

data/lib/steps/config.rb

@@ -1,5 +1,20 @@
-module BaseConstants
+module BddHelper
+  class << self
+    attr_accessor :timeout, :base_url
 
-  $timeout = 20
+    def timeout
+      @timeout || 20
+    end
 
-end
+    def base_url
+      unless @base_url.nil? || @base_url.match?(URI::DEFAULT_PARSER.make_regexp)
+        raise ArgumentError, "BddHelper.base_url should be set to a url (http://www.example.com). Attempted to set #{@base_url.inspect}."
+      end
+      @base_url || nil
+    end
+
+    def configure
+      yield self
+    end
+  end
+end

data/lib/steps/customized/customized_steps.rb

@@ -0,0 +1,37 @@
+begin
+  When(/^hover to "([^"]*)" value "([^"]*)" web element$/) do |web_element_type, web_element|
+    "
+      Web element type can be css, xpath, id, field, link, button, link_or_button or label
+    "
+    # E.g: And hover to "css" value ".list_item" web element
+    find(:"#{web_element_type}".to_sym, web_element).hover
+  end
+
+  When(/^wait (\d+) (?:second|seconds)$/) do |sec_value|
+    "
+      Second's value should be integer
+    "
+    # E.g: And wait 2 seconds
+    sleep sec_value.to_i
+  end
+
+  And(/^generate (\d+) char random string and type into type "([^"]*)" value "([^"]*)"$/) do |count, web_element_type, web_element|
+    "
+      Web element type can be css, xpath, id, field, fillable_field or label
+    "
+    # E.g: And generate "10" char random string and type into type "id" value "mobile"
+    charset = (0...count).map { rand(65..90).chr }.join
+    find(:"#{web_element_type}".to_sym, web_element, wait: BddHelper.timeout).set(charset)
+  end
+
+  And(/^execute javascript code "([^"]*)"/) do |code|
+    "
+      Code should be javascript code
+    "
+    # E.g : And execute javascript code "window.location.reload()"
+    page.execute_script(code)
+  end
+
+rescue StandardError => e
+  puts e
+end

data/lib/steps/global/global_context.rb

@@ -0,0 +1,9 @@
+class GlobalContext
+
+  # Resets global variables for each scenario in an execution
+  def initialize
+    $page_title = nil
+    $current_url = nil
+    $window_size =nil
+  end
+end

data/lib/steps/util/browser_util_methods.rb

@@ -0,0 +1,12 @@
+ class BrowserUtilMethods
+
+   def scroll_to(element)
+     script = <<-JS
+      arguments[0].scrollIntoView(true);
+     JS
+     page.execute_script(script, element.native)
+   end
+
+ rescue StandardError => e
+   puts e
+  end

data/lib/steps/util/browser_util_steps.rb

@@ -0,0 +1,202 @@
+begin
+  When(/^scroll (\d+) px (down) the page$/) do |pixel, arg|
+    "
+      This scrolls down the page by the given amount of pixel.
+    "
+    # E.g : And scroll 500 px down the page
+    page.execute_script("window.scrollBy(0,#{pixel})")
+  end
+
+  When(/^scroll (\d+) px (up) the page$/) do |pixel, arg|
+    "
+      This scrolls up the page by the given amount of pixel.
+    "
+    # E.g : And scroll 500 px up the page
+    page.execute_script("window.scrollBy(0,#{-pixel})")
+  end
+
+  When(/^scroll (bottom) of the page$/) do |arg|
+    "
+      This scrolls the page to the bottom
+    "
+    # E.g : And scroll bottom of the page
+    page.execute_script('window.scrollTo(0, document.body.scrollHeight)')
+  end
+
+  When(/^scroll (top) of the page$/) do |arg|
+    "
+      This scrolls the page to the top
+    "
+    # E.g : And scroll top of the page
+    page.execute_script('window.scrollTo(document.body.scrollHeight,0)')
+  end
+
+  When(/^focus to element by "([^"]*)" text$/) do |text|
+    # E.g : And focus to element by "Agree Button" text
+    scroll_to(find(xpath: "//*[contains(text(), '#{text}')]"))
+  end
+
+  When(/^refresh the page$/) do
+    "
+      This refreshes the current page
+    "
+    # E.g : And refresh the page
+    page.evaluate_script('window.location.reload()')
+  end
+
+  When(/^open a (new window)$/) do |args|
+    # E.g : And open a new window
+    open_new_window(:window)
+  end
+
+  When(/^open a (new tab)$/) do |args|
+    # E.g : And open a new tab
+    open_new_window
+  end
+
+  When(/^switch to last (?:window|tab)$/) do 
+    # E.g : And switch to last window
+    # E.g : And switch to last tab
+    page.driver.browser.switch_to.window(page.driver.browser.window_handles.last)
+  end
+
+  When(/^switch to first (?:window|tab)$/) do
+    # E.g : And switch to first window
+    # E.g : And switch to first tab
+    page.driver.browser.switch_to.window(page.driver.browser.window_handles.first)
+  end
+
+  When(/^switch to window by "([^"]*)" title$/) do |window_title|
+    "
+      Window title should be title of the target window
+    "
+    # E.g : And switch to window by "Welcome" title
+    switch_to_window { title == window_title }
+  end
+
+  When(/^resize window to (\d+) width (\d+) height$/) do |width, height|
+    "
+      This resize to the current window by the given width and height
+    "
+    # E.g : And resize window to 1280 width 720 height
+    page.driver.browser.manage.window.resize_to(width, height)
+  end
+
+  When(/^get window size$/) do
+    "
+       This gets the current window's size then defines it to the global variable
+    "
+    # E.g : And get window size
+    $window_size = page.driver.browser.manage.window.size
+  end
+
+  When(/^close window$/) do
+    "
+      This closes the current window
+    "
+    # E.g : And close window
+    page.driver.browser.close
+  end
+
+  When(/^get current url$/) do
+    "
+      This get full URL of the current page then defines it to the global variable
+    "
+    # E.g : And get current url
+    $current_url = current_url
+  end
+
+  When(/^go back$/) do
+    "
+      This move back a single entry in the browser's history
+    "
+    # E.g : And go back
+    go_back
+  end
+
+  When(/^go forward$/) do
+    "
+      This move forward a single entry in the browser's history
+    "
+    # E.g : And go forward
+    go_forward
+  end
+
+  When(/^visit base page$/) do
+    "
+      Should configure base_url from bdd-helper config
+    "
+    # E.g : And visit base page
+    visit BddHelper.base_url
+  end
+
+  When(/^visit "([^"]*)" url$/) do |url|
+    "
+      The URL can either be a relative URL or an absolute URL
+    "
+    # E.g : And visit "http://www.example.com" url
+    visit url
+  end
+
+  When(/^visit relative url "([^"]*)"$/) do |url|
+    "
+      The URL can be a relative URL
+    "
+    # E.g : And visit relative url '/login'
+    visit BddHelper.base_url + url
+  end
+
+  When(/^maximize window$/) do
+    "
+      This maximizes the current window
+    "
+    # E.g : And maximize window
+    page.driver.browser.manage.window.maximize
+  end
+
+  When(/^accept alert$/) do
+    # E.g : And accept alert
+    page.driver.browser.switch_to.alert.accept
+  end
+
+  When(/^dismiss alert$/) do
+    # E.g : And dismiss alert
+    page.driver.browser.switch_to.alert.dismiss
+  end
+
+  When(/^get window title$/) do
+    "
+      This gets title of the current page then defines it to the global variable
+    "
+    # E.g : And get window title
+    $page_title = title
+  end
+
+  When(/^switch to iframe by "([^"]*)" id$/) do |web_element|
+    "
+      Switches to the iframe with id.
+    "
+    #E.g. : And switch to iframe by "myIframe" id
+    page.driver.browser.switch_to.frame(web_element)
+  end
+
+  When(/^switch to parent frame$/) do
+    "
+      Switches to the parent frame.
+    "
+    #E.g. : And switch to parent frame
+    page.driver.browser.switch_to.parent_frame
+  end
+
+  When(/^switch to default content$/) do
+    "
+      Switches back to default content.
+    "
+    #E.g. : And switch to default content
+    switch_to_frame(:top)
+  end
+
+rescue StandardError => e
+  puts e
+end
+

data/lib/steps/util/fill_in_util.rb

@@ -0,0 +1,11 @@
+class FillInUtil
+
+  def self.clear_text_field(locator)
+    fill_in(locator, with: '', fill_options: { clear: :backspace }, wait: BddHelper.timeout)
+  end
+
+  def self.fill_text_field(locator, text)
+    clear_text_field(locator)
+    fill_in(locator, with: text, wait: BddHelper.timeout)
+  end
+end