RubyGems - watir-formhandler - Versions diffs - 2.1.0 - Mend

watir-formhandler 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (24) hide show

checksums.yaml +7 -0
data/lib/watir_formhandler/check_box.rb +19 -0
data/lib/watir_formhandler/container.rb +49 -0
data/lib/watir_formhandler/element.rb +5 -0
data/lib/watir_formhandler/file_field.rb +9 -0
data/lib/watir_formhandler/option_group.rb +91 -0
data/lib/watir_formhandler/radio.rb +18 -0
data/lib/watir_formhandler/select.rb +34 -0
data/lib/watir_formhandler/text_area.rb +10 -0
data/lib/watir_formhandler/text_field.rb +10 -0
data/lib/watir_formhandler/watir.rb +13 -0
data/lib/watir_formhandler.rb +14 -0
data/spec/check_box_spec.rb +56 -0
data/spec/container_spec.rb +242 -0
data/spec/file_field_spec.rb +23 -0
data/spec/html/form.html +97 -0
data/spec/option_group_spec.rb +310 -0
data/spec/radio_spec.rb +55 -0
data/spec/select_spec.rb +63 -0
data/spec/spec_helper.rb +16 -0
data/spec/text_area_spec.rb +30 -0
data/spec/text_field_spec.rb +30 -0
data/spec/watir_spec.rb +17 -0
metadata +120 -0

data/spec/html/form.html ADDED Viewed

@@ -0,0 +1,97 @@
+<html>
+  <head>
+      <title>Example Form</title>
+  </head>
+  <body>
+    <div id="main_content">
+      <label for='checkbox'>Checkbox</label>
+      <input id="checkbox" type="checkbox" /><br />
+      <br />
+      <label for="select">Select</label>
+      <select id="select">
+        <option value="test">Test</option>
+        <option value="test2">Test2</option>
+      </select><br />
+      <br />
+      <label for="multiselect">Multi Select</label>
+      <select multiple id="multiselect">
+        <option value="option1">Option1</option>
+        <option value="option2">Option2</option>
+        <option value="option3">Option3</option>
+      </select><br />
+      <br />
+      <label for="text">Text Field</label>
+      <input id="text" type="text" /><br />
+      <br />
+      <label for="textarea">Text Area</label>
+      <textarea id="textarea"></textarea><br />
+      <br />
+      <label for="radio">Radio<input type="radio" id="radio" value="test" /></label><br />
+      <br />
+      <label for="date">Date</label>
+      <input id="date" type="date" />
+      <br />
+      <br />
+      <label for="file">File</label>
+      <input type="file" id="file">
+      <br />
+      <br />
+      <fieldset id="checkboxset">
+        <label for="checkbox1">
+          <input type="checkbox" id="checkbox1">Checkbox1
+        </label><br />
+        <label for="checkbox2">
+          <input type="checkbox" id="checkbox2">Checkbox2
+        </label><br />
+        <label for="checkbox3">
+          <input type="checkbox" id="checkbox3">Checkbox3
+        </label><br />
+        <label for="checkbox4">
+          <input type="checkbox" id="checkbox4">Checkbox4
+        </label><br />
+      </fieldset><br />
+      <fieldset id="radioset" class="radioset">
+        <label for="radio1">
+          <input type="radio" name="radioset" id="radio1">Radio1
+        </label><br />
+        <label for="radio2">
+          <input type="radio" name="radioset" id="radio2">Radio2
+        </label><br />
+        <label for="radio3">
+          <input type="radio" name="radioset" id="radio3">Radio3
+        </label><br />
+        <label for="radio4">
+          <input type="radio" name="radioset" id="radio4">Radio4
+        </label>
+      </fieldset>
+      <fieldset id="radio_and_checkbox">
+        <label for="checkbox5">
+          <input type="checkbox" id="checkbox5">Checkbox5
+        </label><br />
+        <label for="checkbox6">
+          <input type="checkbox" id="checkbox6">Checkbox6
+        </label><br />
+        <label for="radio5">
+          <input type="radio" name="radioset2" id="radio5">Radio5
+        </label><br />
+        <label for="radio6">
+          <input type="radio" name="radioset2" id="radio6">Radio6
+        </label><br />
+        <label for="radio7">
+          <input type="radio" name="radioset2" id="radio7">Radio7
+        </label>
+      </fieldset>
+    </div>
+  </body>
+</html>

data/spec/option_group_spec.rb ADDED Viewed

@@ -0,0 +1,310 @@
+require 'spec_helper'
+module Watir
+  describe OptionGroup do
+    before(:all) { @browser = Watir::Browser.new }
+    after(:all)  { @browser.close}
+    let(:browser){ @browser }
+    before(:each) { browser.goto(local_url(FORM_PAGE)) }
+    describe 'behaving like a normal Watir::Element' do
+      describe '#exists? should return' do
+        it 'true if it is present in the DOM' do
+          expect(browser.option_group(id: 'radioset').exist?).to eq(true)
+        end
+        it 'false otherwise' do
+          expect(browser.option_group(id: 'nowhere').exist?).to eq(false)
+        end
+      end
+    end
+    describe '#option_names' do
+      it 'gives the names of all available checkboxes'  do
+        expected_options = %w(Checkbox1 Checkbox2 Checkbox3 Checkbox4)
+        expect(browser.option_group(id: 'checkboxset').option_names).to include(*expected_options)
+      end
+      it 'gives the names of all available radio buttons'  do
+        expected_options = %w(Radio1 Radio2 Radio3 Radio4)
+        expect(browser.option_group(id: 'radioset').option_names).to include(*expected_options)
+      end
+      it 'gives the names of all available radio buttons and checkboxes'  do
+        expected_options = %w(Checkbox5 Checkbox6 Radio5 Radio6 Radio7)
+        option_group = browser.option_group(id: 'radio_and_checkbox')
+        expect(option_group.option_names).to include(*expected_options)
+      end
+    end
+    describe '#option_fields' do
+      it 'provides all fields belonging to an OptionGroup of checkboxes' do
+        expected_ids = %w(checkbox1 checkbox2 checkbox3 checkbox4)
+        option_group = browser.option_group(id: 'checkboxset')
+        expect(option_group.option_fields.map(&:id)).to include(*expected_ids)
+      end
+      it 'provides all fields belonging to an OptionGroup of radio buttons' do
+        expected_ids = %w(radio1 radio2 radio3 radio4)
+        option_group = browser.option_group(id: 'radioset')
+        expect(option_group.option_fields.map(&:id)).to include(*expected_ids)
+      end
+      it 'provides all fields belonging to an OptionGroup of radio buttons and checkboxes' do
+        expected_ids = %w(checkbox5 checkbox6 radio5 radio6 radio7)
+        option_group = browser.option_group(id: 'radio_and_checkbox')
+        expect(option_group.option_fields.map(&:id)).to include(*expected_ids)
+      end
+    end
+    describe '#options' do
+      it 'gives a hash with all available checkboxes and their labels' do
+        option_hash = {'Checkbox1' => 'checkbox1',
+                       'Checkbox2' => 'checkbox2',
+                       'Checkbox3' => 'checkbox3',
+                       'Checkbox4' => 'checkbox4'
+        }
+        found_options = browser.option_group(id: 'checkboxset').options
+        expect(found_options).to be_a(Hash)
+        expect(found_options.keys).to eq(option_hash.keys)
+        expect(found_options.values.map(&:id)).to eq(option_hash.values)
+      end
+      it 'gives a hash with all available radio buttons and their labels' do
+        option_hash = {'Radio1' => 'radio1',
+                       'Radio2' => 'radio2',
+                       'Radio3' => 'radio3',
+                       'Radio4' => 'radio4'
+        }
+        found_options = browser.option_group(id: 'radioset').options
+        expect(found_options).to be_a(Hash)
+        expect(found_options.keys).to eq(option_hash.keys)
+        expect(found_options.values.map(&:id)).to eq(option_hash.values)
+      end
+      it 'gives a hash with all available radio buttons, checkboxes and their labels' do
+        option_hash = { 'Checkbox5' => 'checkbox5',
+                        'Checkbox6' => 'checkbox6',
+                        'Radio5'    => 'radio5',
+                        'Radio6'    => 'radio6',
+                        'Radio7'    => 'radio7',
+        }
+        found_options = browser.option_group(id: 'radio_and_checkbox').options
+        expect(found_options).to be_a(Hash)
+        expect(found_options.keys).to eq(option_hash.keys)
+        expect(found_options.values.map(&:id)).to eq(option_hash.values)
+      end
+    end
+    describe '#set' do
+      let(:option_group) { @option_group }
+      context 'without preselected elements' do
+        context 'for OptionGroup only containing checkboxes' do
+          before(:each){ @option_group = browser.option_group(id: 'checkboxset') }
+          it 'clicks a single option' do
+            target_option = browser.checkbox(id: 'checkbox1')
+            option_group.set('Checkbox1')
+            expect(target_option).to be_checked
+          end
+          it 'clicks multiple options' do
+            target_options = browser.element(id: 'checkboxset').checkboxes[0..1]
+            option_group.set('Checkbox1', 'Checkbox2')
+            target_options.each{ |option| expect(option).to be_checked }
+          end
+          it 'click multiple options given as array' do
+            target_options = browser.element(id: 'checkboxset').checkboxes[0..1]
+            option_group.set(%w(Checkbox1 Checkbox2))
+            target_options.each{ |option| expect(option).to be_checked }
+          end
+        end
+        context 'for OptionGroup only containing radio buttons' do
+          before(:each){ @option_group = browser.option_group(id: 'radioset') }
+          it 'clicks a single option' do
+            target_option = browser.radio(id: 'radio1')
+            option_group.set('Radio1')
+            expect(target_option).to be_checked
+          end
+          it 'clicks multiple options' do
+            target_option = browser.radio(id: 'radio3')
+            option_group.set('Radio1', 'Radio2', 'Radio3')
+            expect(target_option).to be_checked
+          end
+          it 'click multiple options given as array' do
+            target_option = browser.radio(id: 'radio3')
+            option_group.set(%w(Radio1 Radio2 Radio3))
+            expect(target_option).to be_checked
+          end
+        end
+        context 'for OptionGroup containing checkboxes and radio buttons' do
+          before(:each){ @option_group = browser.option_group(id: 'radio_and_checkbox') }
+          it 'clicks a single option' do
+            target_option = browser.checkbox(id: 'checkbox5')
+            option_group.set('Checkbox5')
+            expect(target_option).to be_checked
+          end
+          it 'clicks multiple options' do
+            target_options = browser.element(id: 'radio_and_checkbox').checkboxes[0..1].to_a
+            target_options << browser.element(id: 'radio_and_checkbox').radios[0]
+            option_group.set('Checkbox5', 'Checkbox6', 'Radio5')
+            target_options.each { |option| expect(option).to be_checked }
+          end
+          it 'click multiple options given as array' do
+            target_options = browser.element(id: 'radio_and_checkbox').checkboxes[0..1].to_a
+            target_options << browser.element(id: 'radio_and_checkbox').radios[0]
+            option_group.set(%w(Checkbox5 Checkbox6 Radio5))
+            target_options.each { |option| expect(option).to be_checked }
+          end
+        end
+      end
+      context 'with preselected elements' do
+        context 'for OptionGroup only containing checkboxes' do
+          before(:each){ @option_group = browser.option_group(id: 'checkboxset') }
+          let(:fieldset) { browser.element(id: 'checkboxset') }
+          let(:preselected) { fieldset.checkboxes[2..3] }
+          before(:each) { preselected.map(&:click) }
+          it 'selects a single option and deselects any other' do
+            target_option = browser.element(id: 'checkboxset').checkboxes.first
+            option_group.set('Checkbox1')
+            preselected.each{ |option| expect(option).to_not be_checked }
+            expect(target_option).to be_checked
+          end
+          it 'selects multiple options and deselect unwanted ones' do
+            target_options = browser.element(id: 'checkboxset').checkboxes[0..1]
+            option_group.set('Checkbox1', 'Checkbox2')
+            preselected.each{ |option| expect(option).to_not be_checked }
+            target_options.each{ |option| expect(option).to be_checked }
+          end
+          it 'performs no clicks if preselected elements equal desired ones' do
+            preselected.each{ |option| expect(option).to_not receive(:click) }
+            option_group.set('Checkbox3', 'Checkbox4')
+          end
+        end
+        context 'for OptionGroup only containing radio buttons' do
+          before(:each){ @option_group = browser.option_group(id: 'radioset') }
+          let(:fieldset) { browser.element(id: 'radioset') }
+          let(:preselected) { fieldset.radios[1] }
+          before(:each) { preselected.click }
+          it 'selects a single option and deselects any other' do
+            target_option = browser.element(id: 'radioset').radios.first
+            sleep 2
+            option_group.set('Radio1')
+            sleep 2
+            expect(preselected).to_not be_checked
+            expect(target_option).to be_checked
+          end
+          it 'selects multiple options and deselect unwanted ones' do
+            target_option = browser.element(id: 'radioset').radios[3]
+            option_group.set('Radio3', 'Radio4')
+            expect(preselected).to_not be_checked
+            expect(target_option).to be_checked
+          end
+          it 'performs no clicks if preselected elements equal desired ones' do
+            expect(preselected).to_not receive(:click)
+            option_group.set('Radio2')
+          end
+        end
+        context 'for OptionGroup containing checkboxes and radio buttons' do
+          before(:each){ @option_group = browser.option_group(id: 'radio_and_checkbox') }
+          let(:fieldset) { browser.element(id: 'radio_and_checkbox') }
+          let(:preselected) { fieldset.inputs[1..2].map(&:to_subtype) }
+          before(:each) { preselected.map(&:click) }
+          it 'selects a single option and deselects any other' do
+            target_option = fieldset.checkboxes.first
+            option_group.set('Checkbox5')
+            expect(preselected.first).to_not be_checked
+            expect(preselected.last).to be_checked
+            expect(target_option).to be_checked
+          end
+          it 'selects multiple options and deselect unwanted ones' do
+            target_options = [fieldset.checkboxes.first, fieldset.radios.last]
+            option_group.set('Checkbox5', 'Radio7')
+            preselected.each{ |option| expect(option).to_not be_checked }
+            target_options.each{ |option| expect(option).to be_checked }
+          end
+          it 'performs no clicks if preselected elements equal desired ones' do
+            preselected.each{ |option| expect(option).to_not receive(:click) }
+            option_group.set('Checkbox6', 'Radio5')
+          end
+        end # group with radio and checkbox
+      end # with preselected elements
+    end # #set
+    describe '#selected_options' do
+      it 'returns the selected options of a group' do
+        option_group = browser.option_group(id: 'radio_and_checkbox')
+        option_group.set(%w(Checkbox5 Radio7))
+        expect(option_group.selected_options).to eq(%w(Checkbox5 Radio7))
+      end
+      it 'returns empty array if nothing is selected' do
+        option_group = browser.option_group(id: 'radio_and_checkbox')
+        expect(option_group.selected_options).to be_empty
+      end
+    end #selected_options
+    describe '#field_value' do
+      subject { OptionGroup.new('', id: '') }
+      context 'no option is selected' do
+        it 'returns an empty array' do
+          allow(subject).to receive(:selected_options).and_return([])
+          expect(subject.field_value).to eq([])
+        end
+      end
+      context 'one option is selected' do
+        it 'returns an array with one element' do
+          allow(subject).to receive(:selected_options).and_return(['Option1'])
+          expect(subject.field_value).to eq(['Option1'])
+        end
+      end
+      context 'several options are selected' do
+        it 'returns an array with one element' do
+          opts = %w(Option1 Option3)
+          allow(subject).to receive(:selected_options).and_return(opts)
+          expect(subject.field_value).to eq(opts)
+        end
+      end
+    end #field_value
+  end
+end

data/spec/radio_spec.rb ADDED Viewed

@@ -0,0 +1,55 @@
+require 'spec_helper'
+module Watir
+  describe Radio do
+    before(:each) { @radio = Watir::Radio.new('', id: '') }
+    let(:radio)   { @radio }
+    describe '#set' do
+      context 'when given true' do
+        it 'clicks it if unchecked' do
+          allow(radio).to receive(:checked?).and_return(false)
+          expect(radio).to receive(:click)
+          radio.set(true)
+        end
+        it 'does not click it if checked' do
+          allow(radio).to receive(:checked?).and_return(true)
+          expect(radio).to_not receive(:click)
+          radio.set(true)
+        end
+      end
+      context 'when given false' do
+        it 'does not click it if checked' do
+          allow(radio).to receive(:checked?).and_return(true)
+          expect(radio).to_not receive(:click)
+          radio.set(false)
+        end
+        it 'does not click it if unchecked' do
+          allow(radio).to receive(:checked?).and_return(false)
+          expect(radio).to_not receive(:click)
+          radio.set(false)
+        end
+      end # context when given false
+    end # #set
+    describe '#field_value' do
+      context 'if checked' do
+        it 'returns true' do
+          allow(radio).to receive(:checked?).and_return(true)
+          expect(radio.field_value).to eq(true)
+        end
+      end
+      context 'if unchecked' do
+        it 'returns false' do
+          allow(radio).to receive(:checked?).and_return(false)
+          expect(radio.field_value).to eq(false)
+        end
+      end
+    end # #read
+  end
+end

data/spec/select_spec.rb ADDED Viewed

@@ -0,0 +1,63 @@
+require 'spec_helper'
+module Watir
+  describe Select do
+    before(:all)    { @browser = Browser.new              }
+    after(:all)     { @browser.close                      }
+    before(:each)   { @browser.goto(local_url(FORM_PAGE)) }
+    let(:select)    { @select                             }
+    describe '#set' do
+      context 'single select' do
+        it 'selects the given option' do
+          select = @browser.select(id: 'select')
+          select.set('Test2')
+          expect(select.selected_options.first.text).to eq('Test2')
+        end
+      end
+      context 'multiple select' do
+        before(:each) { @select = @browser.select(id: 'multiselect') }
+        it 'should select a single option' do
+          select.set('Option2')
+          expect(select.selected_options.count).to eq(1)
+          expect(select.selected_options.first.text).to eq('Option2')
+        end
+        it 'should select multiple options' do
+          select.set('Option2', 'Option3')
+          expect(select.selected_options.count).to eq(2)
+          expect(select.selected_options.map(&:text)).to eq(['Option2', 'Option3'])
+        end
+        it 'should select multiple options from an array' do
+          select.set(['Option2', 'Option3'])
+          expect(select.selected_options.count).to eq(2)
+          expect(select.selected_options.map(&:text)).to eq(['Option2', 'Option3'])
+        end
+      end # context multiple select
+    end # #set
+    describe '#field_value' do
+      context 'one option is selected' do
+        subject { @browser.select(id: 'select') }
+        it 'returns a string' do
+          expect(subject.field_value).to eq('Test')
+        end
+      end
+      context 'multiple options are selected' do
+        subject { @browser.select(id: 'multiselect') }
+        it 'returns a list of selected values' do
+          opts = %w(Option1 Option3)
+          subject.set(opts)
+          expect(subject.field_value.count).to eq(2)
+          expect(subject.field_value).to eq(opts)
+        end
+      end
+    end #field_value
+  end
+end

data/spec/spec_helper.rb ADDED Viewed

@@ -0,0 +1,16 @@
+require 'simplecov'
+SimpleCov.start
+require 'watir'
+require 'watir-webdriver'
+require 'selenium-webdriver'
+require 'rspec'
+require 'watir_formhandler'
+require 'pry'
+HTML_DIR = File.join(File.dirname(File.expand_path(__FILE__)), 'html')
+FORM_PAGE = 'form.html'
+def local_url(page)
+  File.join('file://', HTML_DIR, page)
+end

data/spec/text_area_spec.rb ADDED Viewed

@@ -0,0 +1,30 @@
+require 'spec_helper'
+module Watir
+  describe TextArea do
+    describe '#field_value' do
+      subject { Watir::TextArea.new('', id: '') }
+      context 'has text' do
+        it 'returns the set text' do
+          allow(subject).to receive(:value).and_return('test text')
+          expect(subject.field_value).to eq('test text')
+        end
+      end
+      context 'empty' do
+        it 'returns empty string'do
+          allow(subject).to receive(:value).and_return('')
+          expect(subject.field_value).to eq('')
+        end
+      end
+      context 'unset' do
+        it 'returns empty string'do
+          allow(subject).to receive(:value).and_return(nil)
+          expect(subject.field_value).to eq('')
+        end
+      end
+    end
+  end
+end

data/spec/text_field_spec.rb ADDED Viewed

@@ -0,0 +1,30 @@
+require 'spec_helper'
+module Watir
+  describe TextField do
+    describe '#field_value' do
+      subject { Watir::TextField.new('', id: '') }
+      context 'has text' do
+        it 'returns the set text' do
+          allow(subject).to receive(:value).and_return('test text')
+          expect(subject.field_value).to eq('test text')
+        end
+      end
+      context 'empty' do
+        it 'returns empty string'do
+          allow(subject).to receive(:value).and_return('')
+          expect(subject.field_value).to eq('')
+        end
+      end
+      context 'unset' do
+        it 'returns empty string'do
+          allow(subject).to receive(:value).and_return(nil)
+          expect(subject.field_value).to eq('')
+        end
+      end
+    end
+  end
+end

data/spec/watir_spec.rb ADDED Viewed

@@ -0,0 +1,17 @@
+require 'spec_helper'
+describe Watir do
+  describe 'extend_tag_to_class' do
+    TestClass = Class.new
+    it 'should add a new tag-class combination to the original hash' do
+      Watir.extend_tag_to_class(:test, TestClass)
+      expect(Watir.tag_to_class.keys).to include(:test)
+      expect(Watir.tag_to_class[:test]).to be_a(Class)
+    end
+    it 'should freeze the tag_to_class hash again after the addition' do
+      Watir.extend_tag_to_class(:test, TestClass)
+      expect(Watir.tag_to_class).to be_frozen
+    end
+  end
+end