watir 1.4.1 → 7.3.0

data/spec/watirspec/elements/tfoots_spec.rb

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

data/spec/watirspec/elements/thead_spec.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe 'TableHeader' do
+    before do
+      browser.goto(WatirSpec.url_for('tables.html'))
+    end
+
+    describe '#exists?' do
+      it 'returns true if the table theader exists (page context)' do
+        expect(browser.thead(id: 'tax_headers')).to exist
+        expect(browser.thead(id: /tax_headers/)).to exist
+        expect(browser.thead(index: 0)).to exist
+        expect(browser.thead(xpath: "//thead[@id='tax_headers']")).to exist
+      end
+
+      it 'returns the first thead if given no args' do
+        expect(browser.thead).to exist
+      end
+
+      it 'returns true if the table theader exists (table context)' do
+        expect(browser.table(index: 0).thead(id: 'tax_headers')).to exist
+        expect(browser.table(index: 0).thead(id: /tax_headers/)).to exist
+        expect(browser.table(index: 0).thead(index: 0)).to exist
+        expect(browser.table(index: 0).thead(xpath: "//thead[@id='tax_headers']")).to exist
+      end
+
+      it "returns false if the table theader doesn't exist (page context)" do
+        expect(browser.thead(id: 'no_such_id')).not_to exist
+        expect(browser.thead(id: /no_such_id/)).not_to exist
+        expect(browser.thead(index: 1337)).not_to exist
+        expect(browser.thead(xpath: "//thead[@id='no_such_id']")).not_to exist
+      end
+
+      it "returns false if the table theader doesn't exist (table context)" do
+        expect(browser.table(index: 0).thead(id: 'no_such_id')).not_to exist
+        expect(browser.table(index: 0).thead(id: /no_such_id/)).not_to exist
+        expect(browser.table(index: 0).thead(index: 1337)).not_to exist
+        expect(browser.table(index: 0).thead(xpath: "//thead[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.thead(id: 3.14).exists? }.to raise_error(TypeError)
+        expect { browser.table(index: 0).thead(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.thead(id: 'tax_headers')[0].id).to eq 'thead_row_1'
+        expect(browser.thead(id: 'tax_headers')[0][1].text).to eq 'Before income tax'
+        expect(browser.thead(id: 'tax_headers')[0][2].text).to eq 'Income tax'
+      end
+
+      it 'returns the row at the given index (table context)' do
+        expect(browser.table(index: 0).thead(id: 'tax_headers')[0].id).to eq 'thead_row_1'
+        expect(browser.table(index: 0).thead(id: 'tax_headers')[0][1].text).to eq 'Before income tax'
+        expect(browser.table(index: 0).thead(id: 'tax_headers')[0][2].text).to eq 'Income tax'
+      end
+    end
+
+    describe '#row' do
+      it 'finds the first row matching the selector' do
+        row = browser.thead(id: 'tax_headers').row(class: 'dark')
+        expect(row.id).to eq 'thead_row_1'
+      end
+    end
+
+    describe '#rows' do
+      it 'finds rows matching the selector' do
+        rows = browser.thead(id: 'tax_headers').rows(class: 'dark')
+
+        expect(rows.size).to eq 1
+        expect(rows.first.id).to eq 'thead_row_1'
+      end
+    end
+
+    describe '#strings' do
+      it 'returns the text of child cells' do
+        expect(browser.thead(id: 'tax_headers').strings).to eq [
+          ['', 'Before income tax', 'Income tax', 'After income tax']
+        ]
+      end
+    end
+  end
+end

data/spec/watirspec/elements/theads_spec.rb

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

data/spec/watirspec/elements/tr_spec.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TableRow do
+    before do
+      browser.goto(WatirSpec.url_for('tables.html'))
+    end
+
+    describe '#exists?' do
+      it 'returns true if the table row exists' do
+        expect(browser.tr(id: 'outer_first')).to exist
+        expect(browser.tr(id: /outer_first/)).to exist
+        expect(browser.tr(index: 0)).to exist
+        browser.tr(xpath: "//tr[@id='outer_first']")
+      end
+
+      it 'returns the first row if given no args' do
+        expect(browser.tr).to exist
+      end
+
+      it "returns false if the table row doesn't exist" do
+        expect(browser.tr(id: 'no_such_id')).not_to exist
+        expect(browser.tr(id: /no_such_id/)).not_to exist
+        expect(browser.tr(index: 1337)).not_to exist
+        browser.tr(xpath: "//tr[@id='no_such_id']")
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.tr(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    describe '#[]', except: {browser: :safari, reason: 'Safari does not strip text'} do
+      let(:table) { browser.table(id: 'outer') }
+
+      it 'returns the nth cell of the row' do
+        expect(table[0][0].text).to eq 'Table 1, Row 1, Cell 1'
+        expect(table[2][0].text).to eq 'Table 1, Row 3, Cell 1'
+      end
+    end
+
+    describe '#cells' do
+      let(:table) { browser.table(id: 'outer') }
+
+      it 'returns the correct number of cells' do
+        expect(table[0].cells.length).to eq 2
+        expect(table[1].cells.length).to eq 2
+        expect(table[2].cells.length).to eq 2
+      end
+
+      it 'finds cells in the table' do
+        expect(table[0].cells(text: /Table 1/).size).to eq 2
+      end
+
+      it 'does not find cells from nested tables' do
+        expect(table[1].cell(id: 't2_r1_c1')).not_to exist
+        expect(table[1].cell(id: /t2_r1_c1/)).not_to exist
+      end
+
+      it 'iterates correctly through the cells of the row' do
+        browser.table(id: 'outer').tr(index: 1).each_with_index do |cell, idx|
+          expect(cell.id).to eq "t1_r2_c#{idx + 1}"
+        end
+      end
+    end
+  end
+end

data/spec/watirspec/elements/trs_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe TableRowCollection do
+    before do
+      browser.goto(WatirSpec.url_for('tables.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.trs(id: 'outer_second').to_a).to eq [browser.tr(id: 'outer_second')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the correct number of cells (table context)' do
+        expect(browser.table(id: 'inner').trs.length).to eq 1
+        expect(browser.table(id: 'outer').trs.length).to eq 4
+      end
+
+      it 'returns the correct number of cells (page context)' do
+        expect(browser.trs.length).to eq 14
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the row at the given index (table context)' do
+        expect(browser.table(id: 'outer').trs[0].id).to eq 'outer_first'
+      end
+
+      it 'returns the row at the given index (page context)' do
+        expect(browser.trs[0].id).to eq 'thead_row_1'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through rows correctly' do
+        inner_table = browser.table(id: 'inner')
+        count = 0
+
+        inner_table.trs.each_with_index do |r, index|
+          expect(r.id).to eq inner_table.tr(index: index).id
+          count += 1
+        end
+        expect(count).to be > 0
+      end
+
+      it 'iterates through the outer table correctly' do
+        outer_table = browser.table(id: 'outer')
+        count = 0
+
+        outer_table.trs.each_with_index do |r, index|
+          expect(r.id).to eq outer_table.tr(index: index).id
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/elements/ul_spec.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe UList do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    # Exists method
+    describe '#exist?' do
+      it "returns true if the 'ul' exists" do
+        expect(browser.ul(id: 'navbar')).to exist
+        expect(browser.ul(id: /navbar/)).to exist
+        expect(browser.ul(index: 0)).to exist
+        expect(browser.ul(xpath: "//ul[@id='navbar']")).to exist
+      end
+
+      it 'returns the first ul if given no args' do
+        expect(browser.ul).to exist
+      end
+
+      it "returns false if the 'ul' doesn't exist" do
+        expect(browser.ul(id: 'no_such_id')).not_to exist
+        expect(browser.ul(id: /no_such_id/)).not_to exist
+        expect(browser.ul(text: 'no_such_text')).not_to exist
+        expect(browser.ul(text: /no_such_text/)).not_to exist
+        expect(browser.ul(class: 'no_such_class')).not_to exist
+        expect(browser.ul(class: /no_such_class/)).not_to exist
+        expect(browser.ul(index: 1337)).not_to exist
+        expect(browser.ul(xpath: "//ul[@id='no_such_id']")).not_to exist
+      end
+
+      it "raises TypeError when 'what' argument is invalid" do
+        expect { browser.ul(id: 3.14).exists? }.to raise_error(TypeError)
+      end
+    end
+
+    # Attribute methods
+    describe '#id' do
+      it 'returns the id attribute' do
+        expect(browser.ul(class: 'navigation').id).to eq 'navbar'
+      end
+
+      it "returns an empty string if the element exists and the attribute doesn't" do
+        expect(browser.ul(index: 1).id).to eq ''
+      end
+
+      it "raises UnknownObjectException if the ul doesn't exist" do
+        expect { browser.ul(id: 'no_such_id').id }.to raise_unknown_object_exception
+        expect { browser.ul(index: 1337).id }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#respond_to?' do
+      it 'returns true for all attribute methods' do
+        expect(browser.ul(index: 0)).to respond_to(:class_name)
+        expect(browser.ul(index: 0)).to respond_to(:id)
+      end
+    end
+  end
+end

data/spec/watirspec/elements/uls_spec.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require 'watirspec_helper'
+
+module Watir
+  describe UListCollection do
+    before do
+      browser.goto(WatirSpec.url_for('non_control_elements.html'))
+    end
+
+    describe 'with selectors' do
+      it 'returns the matching elements' do
+        expect(browser.uls(class: 'navigation').to_a).to eq [browser.ul(class: 'navigation')]
+      end
+    end
+
+    describe '#length' do
+      it 'returns the number of uls' do
+        expect(browser.uls.length).to eq 2
+      end
+    end
+
+    describe '#[]' do
+      it 'returns the ul at the given index' do
+        expect(browser.uls[0].id).to eq 'navbar'
+      end
+    end
+
+    describe '#each' do
+      it 'iterates through uls correctly' do
+        count = 0
+
+        browser.uls.each_with_index do |ul, index|
+          expect(ul.id).to eq browser.ul(index: index).id
+          count += 1
+        end
+
+        expect(count).to be > 0
+      end
+    end
+  end
+end

data/spec/watirspec/html/alerts.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Alerts</title>
+  </head>
+  <body>
+    <input id=alert type=button onclick="alert('ok')" value=Alert>
+    <input id=confirm type=button onclick="this.value = confirm('set the value')" value=Confirm>
+    <input id=prompt type=button onclick='this.value = prompt("enter your name", "John Doe")' value=Prompt>
+    <input id=timeout-alert type=button onclick="setTimeout('alert(\'ok\')', 3000)" value=Timeout-Alert>
+  </body>
+</html>

data/spec/watirspec/html/aria_attributes.html

@@ -0,0 +1,9 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>aria-* attributes</title>
+  </head>
+  <body>
+    <p aria-label=ruby-library>watir</p>
+  </body>
+</html>

data/spec/watirspec/html/child_frame.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <title>Child frame</title>
+  <meta name="author" content="Software Freedom Conservancy">
+  <link rel="author" href="https://github.com/SeleniumHQ/selenium/blob/selenium-4.2.0/common/src/web/scrolling_tests/frame_with_height_above_200.html">
+  <link rel="license" href="https://github.com/SeleniumHQ/selenium/blob/trunk/LICENSE">
+</head>
+<body>
+  <h1>This is a scrolling frame test</h1>
+  <div>
+    <table>
+      <tr height="50px">
+        <td>First row</td>
+      </tr>
+      <tr height="50px">
+        <td>Second row</td>
+      </tr>
+      <tr height="50px">
+        <td>Third row</td>
+      </tr>
+      <tr height="50px">
+        <td>Fourth row</td>
+      </tr>
+    </table>
+  </div>
+  <input type='checkbox' name='scroll_checkbox' />
+</body>
+</html>

data/spec/watirspec/html/class_locator.html

@@ -0,0 +1,11 @@
+<!DOCTYPE html>
+<html>
+  <body>
+    <div class="a">a</div>
+    <div class="a b c">a b c</div>
+    <div class="a b">a b</div>
+    <div class="abc">abc</div>
+    <div class="first
+newline	tabbed last">tab</div>
+  </body>
+</html>

data/spec/watirspec/html/clicks.html

@@ -0,0 +1,19 @@
+<html>
+  <head>
+    <script src="javascript/jquery-1.7.1.min.js" type="text/javascript" charset="utf-8"></script>
+  </head>
+  <script>
+  $(document).ready(function() {
+    $("#click-logger").click(function(evt) {
+      $("#log").append("<p>shift=" + evt.shiftKey + " alt=" + evt.altKey + "</p>");
+    });
+  });
+  </script>
+  <body>
+    <div id="click-logger">click me</div>
+    <div id="log"></div>
+    <div>
+      <div onclick="this.innerHTML = 'You Clicked It!'" style="color: red; text-decoration: underline; cursor: pointer;">Can You Click This?</div>
+    </div>
+  </body>
+</html>

data/spec/watirspec/html/closeable.html

@@ -0,0 +1,21 @@
+<!DOCTYPE HTML>
+<html>
+  <head>
+    <title>closeable window</title>
+    <script>
+      function closeDelayed(timeout) {
+        setTimeout(function() {
+          window.close();
+        }, timeout);
+      }
+    </script>
+  </head>
+
+  <body>
+    <p>
+      Click <a id="close" href="#" onclick="window.close()">here</a> to close this window.
+      Click <a id="close-delay" href="#" onclick="closeDelayed(500)">here</a> to close this window with a delay.
+    </p>
+  </body>
+
+</html>

data/spec/watirspec/html/collections.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+    <title>Collections</title>
+    <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+</head>
+<body>
+<span id="a_span">
+    <div>first_div</div>
+    <div>second_div</div>
+    <span>first_span</span>
+    <span>second_span</span>
+</span>
+</body>
+</html>