watir 1.4.1 → 7.3.0

data/spec/watirspec/elements/tbodys_spec.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'TableBodies' do
+    before do
+      browser.goto(WatirSpec.url_for('tables.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.tbodys(id: 'first').to_a).to eq [browser.tbody(id: 'first')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the correct number of table bodies (page context)' do
+        expect(browser.tbodys.length).to eq 5
+      end
+
+      it 'returns the correct number of table bodies (table context)' do
+        expect(browser.table(index: 0).tbodys.length).to eq 2
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the row at the given index (page context)' do
+        expect(browser.tbodys[0].id).to eq 'first'
+      end
+
+      it 'returns the row at the given index (table context)' do
+        expect(browser.table(index: 0).tbodys[0].id).to eq 'first'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through table bodies correctly (browser context)' do
+        count = 0
+
+        browser.tbodys.each_with_index do |body, index|
+          expect(body.id).to eq browser.tbody(index: index).id
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+
+      it 'iterates through table bodies correctly (table context)' do
+        table = browser.table(index: 0)
+        count = 0
+
+        table.tbodys.each_with_index do |body, index|
+          expect(body.id).to eq table.tbody(index: index).id
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/td_spec.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TableDataCell do
+    before do
+      browser.goto(WatirSpec.url_for('tables.html'))
+    end
+
+    # Exists
+    describe '#exists?' do
+      it 'returns true when the table cell exists' do
+        expect(browser.td(id: 't1_r2_c1')).to exist
+        expect(browser.td(id: /t1_r2_c1/)).to exist
+        expect(browser.td(text: 'Table 1, Row 3, Cell 1')).to exist
+        expect(browser.td(text: /Table 1/)).to exist
+        expect(browser.td(index: 0)).to exist
+        expect(browser.td(xpath: "//td[@id='t1_r2_c1']")).to exist
+      end
+
+      it 'returns the first cell if given no args' do
+        expect(browser.td).to exist
+      end
+
+      it 'returns false when the table cell does not exist' do
+        expect(browser.td(id: 'no_such_id')).not_to exist
+        expect(browser.td(id: /no_such_id/)).not_to exist
+        expect(browser.td(text: 'no_such_text')).not_to exist
+        expect(browser.td(text: /no_such_text/)).not_to exist
+        expect(browser.td(index: 1337)).not_to exist
+        expect(browser.td(xpath: "//td[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.td(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    describe '#click' do
+      it "fires the table's onclick event" do
+        browser.td(id: 't2_r1_c1').click
+        expect(messages).to include('td')
+      end
+    end
+
+    # Attribute methods
+    describe '#text', except: {browser: :safari, reason: 'Safari does not strip text'} do
+      it 'returns the text inside the table cell' do
+        expect(browser.td(id: 't1_r2_c1').text).to eq 'Table 1, Row 2, Cell 1'
+        expect(browser.td(id: 't2_r1_c1').text).to eq 'Table 2, Row 1, Cell 1'
+      end
+    end
+
+    describe '#colspan' do
+      it 'gets the colspan attribute' do
+        expect(browser.td(id: 'colspan_2').colspan).to eq 2
+        expect(browser.td(id: 'no_colspan').colspan).to eq 1
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.td(index: 0)).to respond_to(:text)
+        expect(browser.td(index: 0)).to respond_to(:colspan)
+      end
+    end
+
+    describe '#column_header' do
+      it 'returns the corresponding column header' do
+        header = browser.td(text: '1 331').column_header
+        expect(header).to eq 'Income tax'
+      end
+    end
+
+    describe '#sibling_from_header' do
+      it 'returns the corresponding sibling cell by text' do
+        local_td = browser.td(text: '1 331')
+
+        td = local_td.sibling_from_header(text: 'After income tax')
+        expect(td.text).to eq '4 532'
+      end
+
+      it 'returns the corresponding sibling cell by index' do
+        local_td = browser.td(text: '1 331')
+
+        td = local_td.sibling_from_header(text: /tax/, index: 2)
+        expect(td.text).to eq '4 532'
+      end
+    end
+  end
+end

data/spec/watirspec/elements/tds_spec.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TableDataCellCollection do
+    before do
+      browser.goto(WatirSpec.url_for('tables.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.tds(headers: 'before_tax').to_a).to eq [browser.td(headers: 'before_tax')]
+      end
+    end
+
+    #  describe "#length" do
+    #    it "returns the number of cells" do
+    #      browser.table(id: 'outer').cells.length.to eq 6
+    #      browser.table(id: 'inner').cells.length.to eq 2
+    #    end
+    #  end
+    #
+    #  describe "#[]" do
+    #    it "returns the row at the given index" do
+    #      browser.table(id: 'outer').cells[0].text.to eq "Table 1, Row 1, Cell 1"
+    #      browser.table(id: 'inner').cells[0].text.to eq "Table 2, Row 1, Cell 1"
+    #      browser.table(id: 'outer').cells[6].text.to eq "Table 1, Row 3, Cell 2"
+    #    end
+    #  end
+
+    describe '#each' do
+      it 'iterates through all cells on the page correctly' do
+        count = 0
+
+        browser.tds.each_with_index do |c, index|
+          expect(c.id).to eq browser.td(index: index).id
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+
+      it 'iterates through cells inside a table' do
+        count = 0
+
+        inner_table = browser.table(id: 'inner')
+        inner_table.tds.each_with_index do |c, index|
+          expect(c.id).to eq inner_table.td(index: index).id
+          count += 1
+        end
+      end
+    end
+  end
+end

data/spec/watirspec/elements/text_field_spec.rb

@@ -0,0 +1,223 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TextField do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    # Exists method
+    describe '#exists?' do
+      it 'returns true if the element exists' do
+        expect(browser.text_field(id: 'new_user_email')).to exist
+        expect(browser.text_field(id: /new_user_email/)).to exist
+        expect(browser.text_field(name: 'new_user_email')).to exist
+        expect(browser.text_field(name: /new_user_email/)).to exist
+        expect(browser.text_field(name: /new_user_occupation/i)).to exist
+        expect(browser.text_field(value: 'Developer')).to exist
+        expect(browser.text_field(value: /Developer/)).to exist
+        expect(browser.text_field(class: 'name')).to exist
+        expect(browser.text_field(class: /name/)).to exist
+        expect(browser.text_field(index: 0)).to exist
+        expect(browser.text_field(xpath: "//input[@id='new_user_email']")).to exist
+        expect(browser.text_field(label: 'First name')).to exist
+        expect(browser.text_field(label: /(q|a)st? name/)).to exist
+        expect(browser.text_field(label: 'Without for')).to exist
+        expect(browser.text_field(label: /Without for/)).to exist
+        expect(browser.text_field(label: 'With hidden text')).to exist
+        expect(browser.text_field(label: 'With text')).not_to exist
+
+        expect(browser.text_field(label: /With hidden text/)).to exist
+        expect(browser.text_field(label: /With text/)).not_to exist
+      end
+
+      it 'returns true in spite of hidden text',
+         except: {browser: :safari, reason: 'Safari is not filtering out hidden text'} do
+        expect(browser.text_field(visible_label: 'With hidden text')).not_to exist
+        expect(browser.text_field(visible_label: 'With text')).to exist
+        expect(browser.text_field(visible_label: /With text/)).to exist
+        expect(browser.text_field(visible_label: /With hidden text/)).not_to exist
+      end
+
+      it 'locates value of text_field using text locators' do
+        browser.text_field(id: 'new_user_occupation').set 'Firefighter'
+
+        expect(browser.text_field(text: 'Firefighter')).to exist
+        expect(browser.text_field(text: /Fire/)).to exist
+        expect(browser.text_field(visible_text: 'Firefighter')).to exist
+        expect(browser.text_field(visible_text: /Fire/)).to exist
+      end
+
+      it 'returns the first text field if given no args' do
+        expect(browser.text_field).to exist
+      end
+
+      it 'respects text fields types' do
+        expect(browser.text_field.type).to eq('text')
+      end
+
+      it 'returns true if the element exists (no type attribute)' do
+        expect(browser.text_field(id: 'new_user_first_name')).to exist
+      end
+
+      it 'returns true if the element exists (invalid type attribute)' do
+        expect(browser.text_field(id: 'new_user_last_name')).to exist
+      end
+
+      it 'returns true for element with upper case type' do
+        expect(browser.text_field(id: 'new_user_email_confirm')).to exist
+      end
+
+      it 'returns true for element with unknown type attribute' do
+        expect(browser.text_field(id: 'unknown_text_field')).to exist
+      end
+
+      it 'returns false if the element does not exist' do
+        expect(browser.text_field(id: 'no_such_id')).not_to exist
+        expect(browser.text_field(id: /no_such_id/)).not_to exist
+        expect(browser.text_field(name: 'no_such_name')).not_to exist
+        expect(browser.text_field(name: /no_such_name/)).not_to exist
+        expect(browser.text_field(value: 'no_such_value')).not_to exist
+        expect(browser.text_field(value: /no_such_value/)).not_to exist
+        expect(browser.text_field(text: 'no_such_text')).not_to exist
+        expect(browser.text_field(text: /no_such_text/)).not_to exist
+        expect(browser.text_field(class: 'no_such_class')).not_to exist
+        expect(browser.text_field(class: /no_such_class/)).not_to exist
+        expect(browser.text_field(index: 1337)).not_to exist
+        expect(browser.text_field(xpath: "//input[@id='no_such_id']")).not_to exist
+        expect(browser.text_field(label: 'bad label')).not_to exist
+        expect(browser.text_field(label: /bad label/)).not_to exist
+
+        # input type='hidden' should not be found by #text_field
+        expect(browser.text_field(id: 'new_user_interests_dolls')).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.text_field(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute if the text field exists' do
+        expect(browser.text_field(index: 4).id).to eq 'new_user_occupation'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#name' do
+      it 'returns the name attribute if the text field exists' do
+        expect(browser.text_field(index: 3).name).to eq 'new_user_email_confirm'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(index: 1337).name }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#title' do
+      it 'returns the title attribute if the text field exists' do
+        expect(browser.text_field(id: 'new_user_code').title).to eq 'Your personal code'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(index: 1337).title }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#type' do
+      it 'returns the type attribute if the text field exists' do
+        expect(browser.text_field(index: 3).type).to eq 'text'
+      end
+
+      it "returns 'text' if the type attribute is invalid" do
+        expect(browser.text_field(id: 'new_user_last_name').type).to eq 'text'
+      end
+
+      it "returns 'text' if the type attribute does not exist" do
+        expect(browser.text_field(id: 'new_user_first_name').type).to eq 'text'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(index: 1337).type }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#value' do
+      it 'returns the value attribute if the text field exists' do
+        expect(browser.text_field(name: 'new_user_occupation').value).to eq 'Developer'
+        expect(browser.text_field(index: 4).value).to eq 'Developer'
+        expect(browser.text_field(name: /new_user_occupation/i).value).to eq 'Developer'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(index: 1337).value }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.text_field(index: 0)).to respond_to(:class_name)
+        expect(browser.text_field(index: 0)).to respond_to(:id)
+        expect(browser.text_field(index: 0)).to respond_to(:name)
+        expect(browser.text_field(index: 0)).to respond_to(:title)
+        expect(browser.text_field(index: 0)).to respond_to(:type)
+        expect(browser.text_field(index: 0)).to respond_to(:value)
+      end
+    end
+
+    # Access methods
+    describe '#enabled?' do
+      it 'returns true for enabled text fields' do
+        expect(browser.text_field(name: 'new_user_occupation')).to be_enabled
+        expect(browser.text_field(id: 'new_user_email')).to be_enabled
+      end
+
+      it 'returns false for disabled text fields' do
+        expect(browser.text_field(name: 'new_user_species')).not_to be_enabled
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(id: 'no_such_id').enabled? }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#disabled?' do
+      it 'returns true if the text field is disabled' do
+        expect(browser.text_field(id: 'new_user_species')).to be_disabled
+      end
+
+      it 'returns false if the text field is enabled' do
+        expect(browser.text_field(index: 0)).not_to be_disabled
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(index: 1337).disabled? }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#readonly?' do
+      it 'returns true for read-only text fields' do
+        expect(browser.text_field(name: 'new_user_code')).to be_readonly
+        expect(browser.text_field(id: 'new_user_code')).to be_readonly
+      end
+
+      it 'returns false for writable text fields' do
+        expect(browser.text_field(name: 'new_user_email')).not_to be_readonly
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(id: 'no_such_id').readonly? }.to raise_unknown_object_exception
+      end
+
+      it 'raises UnknownReadOnlyException if sending keys to readonly element' do
+        expect { browser.text_field(id: 'new_user_code').set 'foo' }.to raise_object_read_only_exception
+      end
+    end
+  end
+end

data/spec/watirspec/elements/text_fields_spec.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TextFieldCollection do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.text_fields(name: 'new_user_email').to_a).to eq [browser.text_field(name: 'new_user_email')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of text fields' do
+        expect(browser.text_fields.length).to eq 19
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the text field at the given index' do
+        expect(browser.text_fields[0].id).to eq 'new_user_first_name'
+        expect(browser.text_fields[1].id).to eq 'new_user_last_name'
+        expect(browser.text_fields[2].id).to eq 'new_user_email'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through text fields correctly' do
+        count = 0
+
+        browser.text_fields.each_with_index do |r, index|
+          expect(r.name).to eq browser.text_field(index: index).name
+          expect(r.id).to eq browser.text_field(index: index).id
+          expect(r.value).to eq browser.text_field(index: index).value
+
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/textarea_spec.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TextArea do
+    before do
+      browser.goto WatirSpec.url_for('forms_with_input_elements.html')
+    end
+
+    let(:textarea) { browser.textarea }
+
+    it 'can set a value' do
+      textarea.set 'foo'
+      expect(textarea.value).to eq 'foo'
+    end
+
+    it 'can clear a value' do
+      textarea.set 'foo'
+      textarea.clear
+      expect(textarea.value).to eq ''
+    end
+
+    it 'locates textarea by value' do
+      browser.textarea.set 'foo'
+      expect(browser.textarea(value: /foo/)).to exist
+      expect(browser.textarea(value: 'foo')).to exist
+    end
+  end
+end

data/spec/watirspec/elements/textareas_spec.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TextAreaCollection do
+    before do
+      browser.goto WatirSpec.url_for('forms_with_input_elements.html')
+    end
+
+    context 'when locating by :value' do
+      before do
+        browser.textarea(index: 0).set 'foo1'
+        browser.textarea(index: 1).set 'foo2'
+      end
+
+      it 'finds textareas by string' do
+        expect(browser.textareas(value: 'foo1').map(&:id)).to eq [browser.textarea(index: 0).id]
+        expect(browser.textareas(value: 'foo2').map(&:id)).to eq [browser.textarea(index: 1).id]
+      end
+
+      it 'finds textareas by regexp' do
+        expect(browser.textareas(value: /foo/)[0].id).to eq browser.textarea(index: 0).id
+        expect(browser.textareas(value: /foo/)[1].id).to eq browser.textarea(index: 1).id
+      end
+    end
+  end
+end

data/spec/watirspec/elements/tfoot_spec.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'TableFooter' do
+    before do
+      browser.goto(WatirSpec.url_for('tables.html'))
+    end
+
+    describe '#exists?' do
+      it 'returns true if the table tfoot exists (page context)' do
+        expect(browser.tfoot(id: 'tax_totals')).to exist
+        expect(browser.tfoot(id: /tax_totals/)).to exist
+        expect(browser.tfoot(index: 0)).to exist
+        expect(browser.tfoot(xpath: "//tfoot[@id='tax_totals']")).to exist
+      end
+
+      it 'returns true if the table tfoot exists (table context)' do
+        expect(browser.table(index: 0).tfoot(id: 'tax_totals')).to exist
+        expect(browser.table(index: 0).tfoot(id: /tax_totals/)).to exist
+        expect(browser.table(index: 0).tfoot(index: 0)).to exist
+        expect(browser.table(index: 0).tfoot(xpath: "//tfoot[@id='tax_totals']")).to exist
+      end
+
+      it 'returns the first tfoot if given no args' do
+        expect(browser.tfoot).to exist
+      end
+
+      it "returns false if the table tfoot doesn't exist (page context)" do
+        expect(browser.tfoot(id: 'no_such_id')).not_to exist
+        expect(browser.tfoot(id: /no_such_id/)).not_to exist
+        expect(browser.tfoot(index: 1337)).not_to exist
+        expect(browser.tfoot(xpath: "//tfoot[@id='no_such_id']")).not_to exist
+      end
+
+      it "returns false if the table tfoot doesn't exist (table context)" do
+        expect(browser.table(index: 0).tfoot(id: 'no_such_id')).not_to exist
+        expect(browser.table(index: 0).tfoot(id: /no_such_id/)).not_to exist
+        expect(browser.table(index: 0).tfoot(index: 1337)).not_to exist
+        expect(browser.table(index: 0).tfoot(xpath: "//tfoot[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.tfoot(id: 3.14).exists? }.to raise_error(TypeError)
+        expect { browser.table(index: 0).tfoot(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the row at the given index (page context)' do
+        expect(browser.tfoot(id: 'tax_totals')[0].id).to eq 'tfoot_row_1'
+        expect(browser.tfoot(id: 'tax_totals')[0][1].text).to eq '24 349'
+        expect(browser.tfoot(id: 'tax_totals')[0][2].text).to eq '5 577'
+      end
+
+      it 'returns the row at the given index (table context)' do
+        expect(browser.table(index: 0).tfoot(id: 'tax_totals')[0].id).to eq 'tfoot_row_1'
+        expect(browser.table(index: 0).tfoot(id: 'tax_totals')[0][1].text).to eq '24 349'
+        expect(browser.table(index: 0).tfoot(id: 'tax_totals')[0][2].text).to eq '5 577'
+      end
+    end
+
+    describe '#row' do
+      it 'finds the first row matching the selector' do
+        row = browser.tfoot(id: 'tax_totals').row(id: 'tfoot_row_1')
+
+        expect(row.id).to eq 'tfoot_row_1'
+      end
+    end
+
+    describe '#rows' do
+      it 'finds rows matching the selector' do
+        rows = browser.tfoot(id: 'tax_totals').rows(id: 'tfoot_row_1')
+
+        expect(rows.size).to eq 1
+        expect(rows.first.id).to eq 'tfoot_row_1'
+      end
+    end
+
+    describe '#strings' do
+      it 'returns the text of child cells' do
+        expect(browser.tfoot(id: 'tax_totals').strings).to eq [
+          ['Sum', '24 349', '5 577', '18 722']
+        ]
+      end
+    end
+  end
+end