watir 6.16.3 → 6.19.0

data/spec/watirspec/window_switching_spec.rb

@@ -1,11 +1,10 @@
 require 'watirspec_helper'
 
-describe 'Browser' do
+describe Watir::Browser do
   before do
-    url = WatirSpec.url_for('window_switching.html')
-    browser.goto url
+    browser.goto WatirSpec.url_for('window_switching.html')
     browser.a(id: 'open').click
-    Watir::Wait.until { browser.windows.size == 2 }
+    browser.windows.wait_until(size: 2)
   end
 
   after do
@@ -14,14 +13,15 @@ describe 'Browser' do
   end
 
   describe '#windows' do
-    it 'returns an array of window handles' do
-      wins = browser.windows
-      expect(wins).to_not be_empty
-      wins.each { |win| expect(win).to be_kind_of(Watir::Window) }
+    it 'returns a WindowCollection' do
+      expect(browser.windows).to be_a(Watir::WindowCollection)
     end
 
-    it 'only returns windows matching the given selector' do
-      browser.wait_until { |b| b.window(title: 'closeable window').exists? }
+    it 'stores Window instances' do
+      expect(browser.windows(title: 'closeable window')).to all(be_a(Watir::Window))
+    end
+
+    it 'filters windows to match the given selector' do
       expect(browser.windows(title: 'closeable window').size).to eq 1
     end
 
@@ -30,24 +30,31 @@ describe 'Browser' do
     end
 
     it 'returns an empty array if no window matches the selector' do
-      expect(browser.windows(title: 'noop')).to eq []
+      expect(browser.windows(title: 'noop')).to be_empty
     end
   end
 
   describe '#window' do
     it 'finds window by :url' do
-      w = browser.window(url: /closeable\.html/).use
-      expect(w).to be_kind_of(Watir::Window)
+      expect(browser.window(url: /closeable\.html/).use).to be_a(Watir::Window)
     end
 
     it 'finds window by :title' do
-      w = browser.window(title: 'closeable window').use
-      expect(w).to be_kind_of(Watir::Window)
+      expect(browser.window(title: 'closeable window').use).to be_a(Watir::Window)
     end
 
     it 'finds window by :index' do
-      w = browser.window(index: 1).use
-      expect(w).to be_kind_of(Watir::Window)
+      expect {
+        expect(browser.window(index: 1).use).to be_a(Watir::Window)
+      }.to have_deprecated_window_index
+    end
+
+    it 'finds window by :element' do
+      expect(browser.window(element: browser.a(id: 'close')).use).to be_a(Watir::Window)
+    end
+
+    it 'finds window by multiple values' do
+      expect(browser.window(title: 'closeable window', url: /closeable\.html/).use).to be_a(Watir::Window)
     end
 
     it 'should not find incorrect handle' do
@@ -60,21 +67,19 @@ describe 'Browser' do
 
     it 'stores the reference to a window when no argument is given' do
       original_window = browser.window
-      browser.window(index: 1).use
+      browser.window(title: 'closeable window').use
       expect(original_window.url).to match(/window_switching\.html/)
     end
 
-    bug 'https://bugzilla.mozilla.org/show_bug.cgi?id=1223277', :firefox do
-      not_compliant_on :headless do
-        it 'it executes the given block in the window' do
-          browser.window(title: 'closeable window') {
-            link = browser.a(id: 'close')
-            expect(link).to exist
-            link.click
-          }.wait_while(&:present?)
-
-          expect(browser.windows.size).to eq 1
+    bug 'Clicking an Element that Closes a Window is returning NoMatchingWindowFoundException', :safari do
+      it 'it executes the given block in the window' do
+        browser.window(title: 'closeable window') do
+          link = browser.a(id: 'close')
+          expect(link).to exist
+          link.click
         end
+
+        expect { browser.windows.wait_until(size: 1) }.to_not raise_error
       end
     end
 
@@ -87,21 +92,57 @@ describe 'Browser' do
     end
 
     it "raises a NoMatchingWindowFoundException error if there's no window at the given index" do
-      expect { browser.window(index: 100).use }.to raise_no_matching_window_exception
+      expect {
+        expect { browser.window(index: 100).use }.to raise_no_matching_window_exception
+      }.to have_deprecated_window_index
     end
 
     it 'raises NoMatchingWindowFoundException error when attempting to use a window with an incorrect handle' do
       expect { browser.window(handle: 'bar').use }.to raise_no_matching_window_exception
     end
   end
+
+  describe '#switch_window' do
+    it 'switches to second window' do
+      original_window = browser.window
+      browser.switch_window
+      new_window = browser.window
+
+      expect(original_window).to_not eq new_window
+      expect(browser.windows).to include(original_window, new_window)
+    end
+
+    it 'returns an instance of Window' do
+      expect(browser.switch_window).to be_a(Watir::Window)
+    end
+
+    it 'times out if there is no second window' do
+      browser.windows.reject(&:current?).each(&:close)
+      message = /waiting for true condition on (.*) title="window switching">$/
+      expect { browser.switch_window }.to raise_timeout_exception(message)
+    end
+
+    it 'provides previous window value to #original_window' do
+      browser.switch_window
+      expect(browser.original_window).to_not be_nil
+    end
+
+    it 'waits for second window' do
+      browser.windows.reject(&:current?).each(&:close)
+      expect {
+        browser.a(id: 'delayed').click
+        browser.switch_window
+      }.to execute_when_satisfied(min: 1)
+    end
+  end
 end
 
-describe 'Window' do
+describe Watir::Window do
   context 'multiple windows' do
     before do
       browser.goto WatirSpec.url_for('window_switching.html')
       browser.a(id: 'open').click
-      Watir::Wait.until { browser.windows.size == 2 }
+      browser.windows.wait_until(size: 2)
     end
 
     after do
@@ -109,198 +150,194 @@ describe 'Window' do
       browser.windows.reject(&:current?).each(&:close)
     end
 
-    not_compliant_on :safari, %i[firefox linux] do
+    bug 'Focus is on newly opened window instead of the first', :safari do
+      it 'allows actions on first window after opening second' do
+        browser.a(id: 'open').click
+
+        expect { browser.windows.wait_until(size: 3) }.to_not raise_timeout_exception
+      end
+    end
+
+    not_compliant_on %i[firefox linux] do
       describe '#close' do
         it 'closes a window' do
+          browser.window(title: 'window switching').use
           browser.a(id: 'open').click
-          Watir::Wait.until { browser.windows.size == 3 }
+          browser.windows.wait_until(size: 3)
+
+          Watir::Window.new(browser, title: 'closeable window').close
 
-          browser.window(title: 'closeable window').close
-          expect(browser.windows.size).to eq 2
+          expect { browser.windows.wait_until(size: 2) }.to_not raise_timeout_exception
         end
-      end
 
-      it 'closes the current window' do
-        browser.a(id: 'open').click
-        Watir::Wait.until { browser.windows.size == 3 }
+        bug 'Focus is on newly opened window instead of the first', :safari do
+          it 'closes the current window' do
+            browser.a(id: 'open').click
+            browser.windows.wait_until(size: 3)
 
-        window = browser.window(title: 'closeable window').use
-        window.close
-        expect(browser.windows.size).to eq 2
+            Watir::Window.new(browser, title: 'closeable window').use.close
+
+            expect { browser.windows.wait_until(size: 2) }.to_not raise_timeout_exception
+          end
+        end
       end
     end
 
     describe '#use' do
       it 'switches to the window' do
-        browser.window(title: 'closeable window').use
+        Watir::Window.new(browser, title: 'closeable window').use
         expect(browser.title).to eq 'closeable window'
       end
     end
 
     describe '#current?' do
       it 'returns true if it is the current window' do
-        expect(browser.window(title: browser.title)).to be_current
+        expect(Watir::Window.new(browser, title: browser.title)).to be_current
       end
 
       it 'returns false if it is not the current window' do
-        expect(browser.window(title: 'closeable window')).to_not be_current
+        expect(Watir::Window.new(browser, title: 'closeable window')).to_not be_current
       end
     end
 
     describe '#title' do
       it 'returns the title of the window' do
         titles = browser.windows.map(&:title)
-        expect(titles.size).to eq 2
 
-        expect(titles.sort).to eq ['window switching', 'closeable window'].sort
-      end
-
-      it 'does not change the current window' do
-        expect(browser.title).to eq 'window switching'
-        expect(browser.windows.find { |w| w.title == 'closeable window' }).to_not be_nil
-        expect(browser.title).to eq 'window switching'
+        expect(titles.size).to eq 2
+        expect(titles).to include 'window switching', 'closeable window'
       end
     end
 
     describe '#url' do
       it 'returns the url of the window' do
-        expect(browser.windows.select { |w| w.url =~ /window_switching\.html/ }.size).to eq 1
-        expect(browser.windows.select { |w| w.url =~ /closeable\.html$/ }.size).to eq 1
-      end
+        urls = browser.windows.map(&:url)
 
-      it 'does not change the current window' do
-        expect(browser.url).to match(/window_switching\.html/)
-        expect(browser.windows.find { |w| w.url =~ /closeable\.html/ }).to_not be_nil
-        expect(browser.url).to match(/window_switching/)
+        expect(urls.size).to eq 2
+        expect(urls).to(include(/window_switching\.html/, /closeable\.html$/))
       end
     end
 
     describe '#eql?' do
       it 'knows when two windows are equal' do
-        expect(browser.window).to eq browser.window(index: 0)
+        win1 = Watir::Window.new browser, {}
+        win2 = Watir::Window.new browser, title: 'window switching'
+
+        expect(win1).to eq win2
       end
 
       it 'knows when two windows are not equal' do
-        win1 = browser.window(index: 0)
-        win2 = browser.window(index: 1)
+        win1 = Watir::Window.new browser, title: 'closeable window'
+        win2 = Watir::Window.new browser, title: 'window switching'
 
         expect(win1).to_not eq win2
       end
     end
 
-    not_compliant_on :relaxed_locate do
-      describe '#wait_until &:present?' do
-        it 'times out waiting for a non-present window' do
-          expect {
-            browser.window(title: 'noop').wait_until(timeout: 0.5, &:present?)
-          }.to raise_error(Watir::Wait::TimeoutError)
-        end
+    describe '#handle' do
+      it 'does not find if not matching' do
+        expect(browser.window(title: 'noop').handle).to be_nil
       end
-    end
-  end
 
-  context 'with a closed window' do
-    before do
-      browser.goto WatirSpec.url_for('window_switching.html')
-      browser.a(id: 'open').click
-      Watir::Wait.until { browser.windows.size == 2 }
-    end
+      it 'finds window by :url' do
+        expect(browser.window(url: /closeable\.html/).handle).to_not be_nil
+      end
 
-    after do
-      browser.original_window.use
-      browser.windows.reject(&:current?).each(&:close)
+      it 'finds window by :title' do
+        expect(browser.window(title: 'closeable window').handle).to_not be_nil
+      end
+
+      it 'finds window by :index' do
+        expect {
+          expect(browser.window(index: 1).handle).to_not be_nil
+        }.to have_deprecated_window_index
+      end
+
+      it 'finds window by :element' do
+        expect(browser.window(element: browser.a(id: 'close')).handle).to_not be_nil
+      end
+
+      it 'finds window by multiple values' do
+        expect(browser.window(url: /closeable\.html/, title: 'closeable window').handle).to_not be_nil
+      end
     end
+  end
 
-    bug 'https://bugzilla.mozilla.org/show_bug.cgi?id=1223277', :firefox do
-      not_compliant_on :headless do
-        describe '#exists?' do
-          it 'returns false if previously referenced window is closed' do
-            window = browser.window(title: 'closeable window')
-            window.use
-            browser.a(id: 'close').click
-            Watir::Wait.until { browser.windows.size == 1 }
-            expect(window).to_not be_present
-          end
+  bug 'Clicking an Element that Closes a Window is returning NoMatchingWindowFoundException', :safari do
+    context 'with a closed window' do
+      before do
+        @original_window = browser.window
+        browser.goto WatirSpec.url_for('window_switching.html')
+        browser.a(id: 'open').click
+        browser.windows.wait_until(size: 2)
+        @handles = browser.driver.window_handles
+        @closed_window = browser.window(title: 'closeable window').use
+        browser.a(id: 'close').click
+        browser.windows.wait_until(size: 1)
+      end
 
-          it 'returns false if closed window is referenced' do
-            browser.window(title: 'closeable window').use
-            browser.a(id: 'close').click
-            Watir::Wait.until { browser.windows.size == 1 }
-            expect(browser.window).to_not exist
-          end
+      after do
+        browser.original_window.use
+        browser.windows.reject(&:current?).each(&:close)
+      end
 
-          it 'returns false if window closes during iteration' do
-            browser.window(title: 'closeable window').use
-            original_handle = browser.original_window.instance_variable_get('@handle')
-            handles = browser.windows.map { |w| w.instance_variable_get('@handle') }
+      describe '#exists?' do
+        it 'returns false if previously referenced window is closed' do
+          expect(@closed_window).to_not be_present
+        end
 
-            browser.a(id: 'close').click
-            Watir::Wait.until { browser.windows.size == 1 }
-            allow(browser.wd).to receive(:window_handles).and_return(handles, [original_handle])
-            expect(browser.window(title: 'closeable window')).to_not exist
-          end
+        it 'returns false if closed window is referenced' do
+          expect(browser.window).to_not exist
         end
       end
-    end
 
-    describe '#current?' do
-      it 'returns false if the referenced window is closed' do
-        original_window = browser.window
-        browser.window(title: 'closeable window').use
-        original_window.close
-        expect(original_window).to_not be_current
+      describe '#current?' do
+        it 'returns false if the referenced window is closed' do
+          expect(@original_window).to_not be_current
+        end
       end
-    end
 
-    not_compliant_on :safari, :headless do
       describe '#eql?' do
         it 'should return false when checking equivalence to a closed window' do
-          original_window = browser.window
-          other_window = browser.window(index: 1)
-          other_window.use
-          original_window.close
-          expect(other_window == original_window).to be false
+          expect(browser.window).not_to eq @closed_widow
         end
       end
-    end
 
-    not_compliant_on :headless do
       describe '#use' do
         it 'raises NoMatchingWindowFoundException error when attempting to use a referenced window that is closed' do
-          original_window = browser.window
-          browser.window(index: 1).use
-          original_window.close
-          expect { original_window.use }.to raise_no_matching_window_exception
+          expect { @closed_window.use }.to raise_no_matching_window_exception
         end
 
-        bug 'https://bugzilla.mozilla.org/show_bug.cgi?id=1223277', :firefox do
+        bug 'Clicking an Element that Closes a Window is returning NoMatchingWindowFoundException', :safari do
           it 'raises NoMatchingWindowFoundException error when attempting to use the current window if it is closed' do
-            browser.window(title: 'closeable window').use
-            browser.a(id: 'close').click
-            Watir::Wait.until { browser.windows.size == 1 }
             expect { browser.window.use }.to raise_no_matching_window_exception
           end
         end
       end
-    end
 
-    it 'raises an exception when using an element on a closed window' do
-      window = browser.window(title: 'closeable window')
-      window.use
-      browser.a(id: 'close').click
-      msg = 'browser window was closed'
-      expect { browser.a.text }.to raise_exception(Watir::Exception::NoMatchingWindowFoundException, msg)
+      bug 'https://github.com/mozilla/geckodriver/issues/1847', :firefox do
+        it 'raises an exception when using an element on a closed window' do
+          msg = 'browser window was closed'
+          expect { browser.a.text }.to raise_exception(Watir::Exception::NoMatchingWindowFoundException, msg)
+        end
+      end
+
+      it 'raises an exception when locating a closed window' do
+        expect { browser.window(title: 'closeable window').use }.to raise_no_matching_window_exception
+      end
     end
+  end
 
-    it 'raises an exception when locating a closed window' do
-      browser.window(title: 'closeable window').use
-      handles = browser.windows.map(&:handle)
-      browser.a(id: 'close').click
-      allow(browser.wd).to receive(:window_handles).and_return(handles, [browser.original_window.handle])
-      expect { browser.window(title: 'closeable window').use }.to raise_no_matching_window_exception
+  context 'with a closed window on a delay' do
+    after do
+      browser.original_window.use
+      browser.windows.reject(&:current?).each(&:close)
     end
 
     it 'raises an exception when locating a window closed during lookup' do
+      browser.goto WatirSpec.url_for('window_switching.html')
+      browser.a(id: 'open').click
+      browser.windows.wait_until(size: 2)
       browser.window(title: 'closeable window').use
       browser.a(id: 'close-delay').click
 
@@ -327,95 +364,109 @@ describe 'Window' do
     end
   end
 
-  bug 'https://bugzilla.mozilla.org/show_bug.cgi?id=1223277', :firefox do
-    not_compliant_on :headless do
-      context 'with current window closed' do
-        before do
-          browser.goto WatirSpec.url_for('window_switching.html')
-          browser.a(id: 'open').click
-          Watir::Wait.until { browser.windows.size == 2 }
-          browser.window(title: 'closeable window').use
-          browser.a(id: 'close').click
-          Watir::Wait.until { browser.windows.size == 1 }
+  bug 'Clicking an Element that Closes a Window is returning NoMatchingWindowFoundException', :safari do
+    context 'with current window closed' do
+      before do
+        browser.goto WatirSpec.url_for('window_switching.html')
+        browser.a(id: 'open').click
+        browser.windows.wait_until(size: 2)
+        browser.window(title: 'closeable window').use
+        browser.a(id: 'close').click
+        browser.windows.wait_until(size: 1)
+      end
+
+      after do
+        browser.original_window.use
+        browser.windows.reject(&:current?).each(&:close)
+      end
+
+      describe '#present?' do
+        it 'should find window by index' do
+          expect {
+            expect(browser.window(index: 0)).to be_present
+          }.to have_deprecated_window_index
         end
 
-        after do
-          browser.window(index: 0).use
-          browser.windows[1..-1].each(&:close)
+        it 'should find window by url' do
+          expect(browser.window(url: /window_switching\.html/)).to be_present
         end
 
-        describe '#present?' do
-          it 'should find window by index' do
-            expect(browser.window(index: 0)).to be_present
-          end
+        it 'should find window by title' do
+          expect(browser.window(title: 'window switching')).to be_present
+        end
 
-          it 'should find window by url' do
-            expect(browser.window(url: /window_switching\.html/)).to be_present
-          end
+        it 'should find window by element' do
+          expect(browser.window(element: browser.link(id: 'open'))).to be_present
+        end
+      end
 
-          it 'should find window by title' do
-            expect(browser.window(title: 'window switching')).to be_present
+      describe '#use' do
+        context 'switching windows without blocks' do
+          it 'by index' do
+            expect { browser.window(index: 0).use }.to have_deprecated_window_index
+            expect(browser.title).to be == 'window switching'
           end
-        end
 
-        describe '#use' do
-          context 'switching windows without blocks' do
-            it 'by index' do
-              browser.window(index: 0).use
-              expect(browser.title).to be == 'window switching'
-            end
+          it 'by url' do
+            browser.window(url: /window_switching\.html/).use
+            expect(browser.title).to be == 'window switching'
+          end
 
-            it 'by url' do
-              browser.window(url: /window_switching\.html/).use
-              expect(browser.title).to be == 'window switching'
-            end
+          it 'by title' do
+            browser.window(title: 'window switching').use
+            expect(browser.url).to match(/window_switching\.html/)
+          end
 
-            it 'by title' do
-              browser.window(title: 'window switching').use
-              expect(browser.url).to match(/window_switching\.html/)
-            end
+          it 'by element' do
+            browser.window(element: browser.link(id: 'open')).use
+            expect(browser.url).to match(/window_switching\.html/)
           end
+        end
 
-          context 'Switching windows with blocks' do
-            it 'by index' do
+        context 'Switching windows with blocks' do
+          it 'by index' do
+            expect {
               browser.window(index: 0).use { expect(browser.title).to be == 'window switching' }
-            end
+            }.to have_deprecated_window_index
+          end
 
-            it 'by url' do
-              browser.window(url: /window_switching\.html/).use { expect(browser.title).to be == 'window switching' }
-            end
+          it 'by url' do
+            browser.window(url: /window_switching\.html/).use { expect(browser.title).to be == 'window switching' }
+          end
 
-            it 'by title' do
-              browser.window(title: 'window switching').use { expect(browser.url).to match(/window_switching\.html/) }
-            end
+          it 'by title' do
+            browser.window(title: 'window switching').use { expect(browser.url).to match(/window_switching\.html/) }
+          end
+
+          it 'by element' do
+            element = browser.link(id: 'open')
+            browser.window(element: element).use { expect(browser.url).to match(/window_switching\.html/) }
           end
         end
       end
     end
   end
 
-  context 'manipulating size and position' do
-    before do
-      browser.goto WatirSpec.url_for('window_switching.html')
-    end
+  not_compliant_on :headless do
+    context 'manipulating size and position' do
+      before do
+        browser.goto WatirSpec.url_for('window_switching.html')
+      end
 
-    not_compliant_on :headless do
       it 'should get the size of the current window' do
         size = browser.window.size
 
         expect(size.width).to eq browser.execute_script('return window.outerWidth;')
         expect(size.height).to eq browser.execute_script('return window.outerHeight;')
       end
-    end
 
-    it 'should get the position of the current window' do
-      pos = browser.window.position
+      it 'should get the position of the current window' do
+        pos = browser.window.position
 
-      expect(pos.x).to eq browser.execute_script('return window.screenX;')
-      expect(pos.y).to eq browser.execute_script('return window.screenY;')
-    end
+        expect(pos.x).to eq browser.execute_script('return window.screenX;')
+        expect(pos.y).to eq browser.execute_script('return window.screenY;')
+      end
 
-    not_compliant_on :headless do
       it 'should resize the window' do
         initial_size = browser.window.size
         browser.window.resize_to(
@@ -428,9 +479,7 @@ describe 'Window' do
         expect(new_size.width).to eq initial_size.width - 20
         expect(new_size.height).to eq initial_size.height - 20
       end
-    end
 
-    not_compliant_on :headless, %i[remote firefox] do
       it 'should move the window' do
         initial_pos = browser.window.position
 
@@ -443,25 +492,103 @@ describe 'Window' do
         expect(new_pos.x).to eq initial_pos.x + 2
         expect(new_pos.y).to eq initial_pos.y + 2
       end
-    end
 
-    not_compliant_on :headless do
       compliant_on :window_manager do
         it 'should maximize the window' do
           initial_size = browser.window.size
           browser.window.resize_to(
-            initial_size.width,
-            initial_size.height - 20
+            initial_size.width - 40,
+            initial_size.height - 40
           )
+          browser.wait_until { |b| b.window.size != initial_size }
+          new_size = browser.window.size
 
           browser.window.maximize
-          browser.wait_until { browser.window.size != initial_size }
+          browser.wait_until { |b| b.window.size != new_size }
 
-          new_size = browser.window.size
-          expect(new_size.width).to be >= initial_size.width
-          expect(new_size.height).to be > (initial_size.height - 20)
+          final_size = browser.window.size
+          expect(final_size.width).to be >= new_size.width
+          expect(final_size.height).to be > (new_size.height)
         end
       end
     end
   end
 end
+
+describe Watir::WindowCollection do
+  before do
+    browser.goto WatirSpec.url_for('window_switching.html')
+    browser.a(id: 'open').click
+    browser.windows.wait_until(size: 2)
+  end
+
+  after do
+    browser.original_window.use
+    browser.windows.reject(&:current?).each(&:close)
+  end
+
+  it '#to_a' do
+    expect {
+      Watir::WindowCollection.new(browser).to_a
+    }.to have_deprecated_window_index
+  end
+
+  describe '#new' do
+    it 'returns all windows by default' do
+      windows = Watir::WindowCollection.new(browser)
+
+      expect(windows.size).to eq 2
+    end
+
+    it 'filters available windows by url' do
+      windows = Watir::WindowCollection.new(browser, url: /closeable\.html/)
+
+      expect(windows.size).to eq 1
+    end
+
+    it 'filters available windows by title' do
+      windows = Watir::WindowCollection.new(browser, title: /closeable/)
+
+      expect(windows.size).to eq 1
+    end
+
+    it 'filters available windows by element' do
+      windows = Watir::WindowCollection.new(browser, element: browser.element(id: 'close'))
+
+      expect(windows.size).to eq 1
+    end
+
+    it 'raises ArgumentError if unrecognized locator' do
+      expect {
+        Watir::WindowCollection.new(browser, foo: /closeable/)
+      }.to raise_error(ArgumentError)
+    end
+  end
+
+  describe '#size' do
+    it 'counts the number of matching windows' do
+      expect(Watir::WindowCollection.new(browser).size).to eq 2
+    end
+  end
+
+  describe '#[]' do
+    it 'returns window instance at provided index' do
+      windows = Watir::WindowCollection.new(browser)
+
+      expect {
+        expect(windows).to all(be_an(Watir::Window))
+        expect(windows.first).to_not eq windows.last
+      }.to have_deprecated_window_index
+    end
+  end
+
+  describe '#eq?' do
+    it 'compares the equivalence of window handles' do
+      windows1 = Watir::WindowCollection.new(browser, title: //)
+      windows2 = Watir::WindowCollection.new(browser, url: //)
+
+      expect(windows1).to eq windows2
+      expect(windows1.to_a.map(&:handle)).to eq windows2.to_a.map(&:handle)
+    end
+  end
+end