bdd-helper 1.0.1 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2145ba3857d634716486eeab60b125e0c56af52cbfcb735831495ead13e92dbc
-  data.tar.gz: d80054b77e9cb799facf5d25accd5d8d660d0ad9b68535f756a18f8969de881c
+  metadata.gz: 55509be429c7af805db4bb6f2ba8e84a000379b5c50b60515533596271ee7a9f
+  data.tar.gz: fecc456613479d7c1cc70514eb492c26481a6c41491f4a896e22c08c7ae102db
 SHA512:
-  metadata.gz: be9dfa09bf3029a7cc421e01e7edda5f730af542d6967cba432a3bfa60abb82b5a6fbf16f4be01db6276ffcd210522d1d82fc2c34e2657130b3732affed77826
-  data.tar.gz: d662253aed144d9999d1c7ec59fd55f9bab80a94663b6b57a0fdd7d72adb66ee2ecf8042891a09ca812a9a73e3f254fa583cee4962879e714de979d5e023f236
+  metadata.gz: 6f7376af00c34fef3a1437de882166da25d9e8b2a65e2a476875d288429989ce01a9abb671dd682d76465d70261f468672d64e5a5d1be4aefb061f9208fdd9eb
+  data.tar.gz: 616b8f799f735b10864851fa8bac2e5c3fb0d24a79f70c863d9d58a85956463db21b460bcc35b1e47bc0bcbf6406441fd587a9b3e2a60b4b0bd6b356b5e68569

data/lib/bdd-helper.rb

@@ -7,7 +7,6 @@ require 'selenium/webdriver'
 require 'selenium/webdriver/common/wait'
 require 'faker'
 
-
 require 'steps/action/check_steps'
 require 'steps/action/choose_steps'
 require 'steps/action/click_steps'
@@ -18,6 +17,8 @@ require 'steps/assertion/assertion_steps'
 require 'steps/customized/customized_steps'
 require 'steps/util/browser_util_steps'
 require 'steps/util/browser_util_methods'
+require 'steps/util/fill_in_util'
 require 'steps/config'
 require 'steps/global/global_context'
-require 'steps/config'
+require 'steps/config'
+

data/lib/demo.feature

@@ -31,11 +31,15 @@ Feature: demo features
     When switch to first tab
     When switch to last tab
     When switch to window by "Welcome" title
+    When switch to iframe by "123" id
+    When switch to parent frame
+    When switch to default content
 
     When close window
     When maximize window
     When get window size
     When resize window to 123 width 123 height
+
     # BROWSER UTIL
     ####################################
 
@@ -55,6 +59,17 @@ Feature: demo features
 
     Then verify ".success-message" element has "Welcome" text
     Then verify ".fail-message" element has not "Welcome" text
+    Then verify ".success-message" element contains "Welcome" text
+    Then verify ".success-message" element contains "elcom" text
+
+    Then verify "#select-class-example legend" css element starts with "Select" text
+    Then verify "//*[@id='open-tab-example-div']" xpath element ends with "Tab" text
+
+    Then verify page has 8 occurrences of "[name='cars']" element
+    Then verify page has minimum 1 occurrences of "[name='cars']" element
+    Then verify page has maximum 8 occurrences of "[name='cars']" element
+    Then verify page has between 1 and 7 occurrences of "[name='cars']" element
+
 
     Then verify "Login" button is displayed
     Then verify "Sign In " button is not displayed
@@ -85,6 +100,17 @@ Feature: demo features
 
     Then verify "audi" options is selected from "cars" dropdown
     Then verify "audi" options is not selected from "cars" dropdown
+
+    Then verify page has ".login" css element
+    Then verify page has "//*[@class='login']" xpath element
+    Then verify page has not "#checkbox-example-div1" css element
+    Then verify page has not "//*[@id='checkbox-example-div1']" xpath element
+
+    Then verify "#checkbox-example-div" css element has "Checkbox Example" text
+    Then verify "//*[@id='checkbox-example-div']" xpath element has "Checkbox Example" text
+    Then verify "#checkbox-example-div" css element has not "Checkbox Example1" text
+    Then verify "//*[@id='checkbox-example-div']" xpath element has not "Checkbox Example1" text
+
     # ASSERTION
     ####################################
 
@@ -93,19 +119,22 @@ Feature: demo features
     ####################################
     # ACTION
     When fill "Username" with "value"
+    When fill ".login-form .message" css element with "Thank you"
+    When fill "//div[@class='login-form']//input[@class='message']" xpath element with "Thank you"
     When fill "First Name" with random first name
     When fill "Last Name" with random last name
     When fill "Email" with random email
     When fill "Phone Number" with random phone number
     When fill "Address" with random address
     When fill "Zip Code" with random zip code
-
     When fill inputs:
-      | username   | test user |
-      | password   | pas123    |
+      | username | test user |
+      | password | pas123    |
 
     When click "Contact Us" link
     When click "Sign In" button
+    When click "#bmwradio" css element
+    When click "//*[@id='openwindow']" xpath element
 
     When check "Terms & Conditions" checkbox
     When uncheck "Privacy Policy" checkbox
@@ -114,6 +143,8 @@ Feature: demo features
 
     When clear "First Name" input
     When select "audi" from "cars" dropdown
+    When select "Honda" from "#carselect" css element
+    When select "BMW" from "//*[@id='carselect']" xpath element
 
     When press "#login" enter
     When press "#username" delete

data/lib/steps/action/click_steps.rb

@@ -15,6 +15,14 @@ begin
     click_link(link_id_title_or_text, wait: BddHelper.timeout)
   end
 
+  When(/^click "([^"]*)" (css|xpath) element$/) do |locator, locator_type|
+    "
+      Locator can be xpath or css.
+    "
+    # E.g. : And click ".login" css element
+    find("#{locator_type}".to_sym, locator).click
+  end
+
   When(/^click "([^"]*)" under "([^"]*)"$/) do |link, menu|
     "
       Finds a element with capybara default_selector, link can be id, text or title

data/lib/steps/action/fill_steps.rb

@@ -4,7 +4,15 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And fill "Name" with "John"
-    fill_in(locator, with: text, wait: BddHelper.timeout)
+    FillInUtil.fill_text_field(locator, text)
+  end
+
+  When(/^fill "([^"]*)" (css|xpath) element with "([^"]*)"$/) do |locator, locator_type, text|
+    "
+      Fillable field can be css or xpath locator.
+    "
+    # E.g : And fill ".username" css element with "John"
+    find("#{locator_type}".to_sym, locator).set(text)
   end
 
   When(/^fill inputs:$/) do |table|
@@ -14,7 +22,7 @@ begin
     # E.g : And fill inputs:
     #      | username | test user |
     #      | password | pass123 |
-    table.raw.each { |raw| fill_in(raw[0], with: raw[1], wait: BddHelper.timeout) }
+    table.raw.each { |raw| FillInUtil.fill_text_field(raw[0], raw[1]) }
   end
 
   When(/^fill "([^"]*)" with random (first name)$/) do |locator, arg|
@@ -22,7 +30,7 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And fill "First Name" with random first name
-    fill_in(locator, with: Faker::Name.first_name, wait: BddHelper.timeout)
+    FillInUtil.fill_text_field(locator, Faker::Name.first_name)
   end
 
   When(/^fill "([^"]*)" with random (last name)$/) do |locator, arg|
@@ -30,7 +38,7 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And fill "Last Name" with random last name
-    fill_in(locator, with: Faker::Name.last_name, wait: BddHelper.timeout)
+    FillInUtil.fill_text_field(locator, Faker::Name.last_name)
   end
 
   When(/^fill "([^"]*)" with random (email)$/) do |locator, arg|
@@ -38,7 +46,7 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And fill "Email" with random email
-    fill_in(locator, with: Faker::Internet.safe_email, wait: BddHelper.timeout)
+    FillInUtil.fill_text_field(locator, Faker::Internet.safe_email)
   end
 
   When(/^fill "([^"]*)" with random (phone number)$/) do |locator, arg|
@@ -46,7 +54,7 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And fill "Phone Number" with random phone number
-    fill_in(locator, with: Array.new(7) { Array(0..9).sample }.join, wait: BddHelper.timeout)
+    FillInUtil.fill_text_field(locator, Array.new(7) { Array(0..9).sample }.join)
   end
 
   When(/^fill "([^"]*)" with random (address)$/) do |locator, arg|
@@ -54,7 +62,7 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And fill "Address" with random address
-    fill_in(locator, with: Faker::Address.full_address, wait: BddHelper.timeout)
+    FillInUtil.fill_text_field(locator, Faker::Address.full_address)
   end
 
   When(/^fill "([^"]*)" with random (zip code)$/) do |locator, arg|
@@ -62,7 +70,7 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And fill "Zip Code" with random zip code
-    fill_in(locator, with: Faker::Address.zip_code, wait: BddHelper.timeout)
+    FillInUtil.fill_text_field(locator, Faker::Address.zip_code)
   end
 
   When(/^clear "([^"]*)" input$/) do |locator|
@@ -70,7 +78,7 @@ begin
       Fillable field can be name, id, placeholder or label text
     "
     # E.g : And clear "Name" input
-    fill_in(locator, with: '', fill_options: { clear: :backspace }, wait: BddHelper.timeout)
+    FillInUtil.clear_text_field(locator)
   end
 rescue StandardError => e
   puts e

data/lib/steps/action/select_steps.rb

@@ -11,6 +11,14 @@ begin
     page.should have_select(dropdown_id_name_or_label_text, selected: option)
   end
 
+  When(/^select "([^"]*)" from "([^"]*)" (xpath|css) element$/) do |option, dropdown_locator, locator_type|
+    "
+      Option is visible text and the dropdown locator should be css or xpath according to locator type.
+    "
+    # E.g : And select "Honda" from "#carselect" css element
+    find("#{locator_type}".to_sym, dropdown_locator).find(:option, option).select_option
+  end
+
 rescue StandardError => e
   puts e
 end

data/lib/steps/assertion/assertion_steps.rb

@@ -26,6 +26,99 @@ begin
     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
@@ -197,6 +290,25 @@ begin
     # 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/util/browser_util_steps.rb

@@ -54,13 +54,13 @@ begin
     open_new_window
   end
 
-  When(/^switch to (last window|last tab)$/) do |arg|
+  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|first tab)$/) do |arg|
+  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)
@@ -166,12 +166,36 @@ begin
 
   When(/^get window title$/) do
     "
-       This gets title of the current page then defines it to the global variable
+      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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bdd-helper
 version: !ruby/object:Gem::Version
-  version: 1.0.1
+  version: 1.0.2
 platform: ruby
 authors:
 - kloia
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2022-02-07 00:00:00.000000000 Z
+date: 2022-04-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
@@ -106,6 +106,7 @@ files:
 - lib/steps/global/global_context.rb
 - lib/steps/util/browser_util_methods.rb
 - lib/steps/util/browser_util_steps.rb
+- lib/steps/util/fill_in_util.rb
 homepage: https://github.com/kloia/bdd-helper
 licenses:
 - MIT
@@ -127,7 +128,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.22
+rubygems_version: 3.2.32
 signing_key:
 specification_version: 4
 summary: Helper steps for client-based automation testing