watir 1.4.1 → 7.3.0

data/spec/unit/element_locator_spec.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative 'unit_helper'
+
+module Watir
+  module Locators
+    class Element
+      describe Locator do
+        include LocatorSpecHelper
+
+        describe '#locate' do
+          context 'when XPath can be built to represent entire selector' do
+            it 'locates without using match' do
+              @locator = {xpath: './/div'}
+
+              allow(driver).to receive(:find_element).and_return(el)
+              allow(element_matcher).to receive(:match)
+
+              expect(locate_one).to eq el
+              expect(element_matcher).not_to have_received(:match)
+            end
+
+            it 'returns nil if not found' do
+              @locator = {xpath: './/div'}
+
+              allow(driver).to receive(:find_element).and_raise(Selenium::WebDriver::Error::NoSuchElementError)
+              expect(locate_one).to be_nil
+            end
+          end
+
+          context 'when SelectorBuilder result has additional locators to match' do
+            it 'locates using match' do
+              @locator = {xpath: './/div', id: 'foo'}
+
+              allow(driver).to receive(:find_elements).and_return([el])
+              allow(element_matcher).to receive(:match).and_return(el)
+
+              expect(locate_one).to eq el
+              expect(element_matcher).to have_received(:match).once
+            end
+
+            it 'relocates if element goes stale' do
+              @locator = {xpath: './/div', id: 'foo'}
+
+              allow(driver).to receive(:find_elements).and_return([el])
+              stale_exception = Selenium::WebDriver::Error::StaleElementReferenceError
+              allow(element_matcher).to receive(:match).and_invoke(proc { raise stale_exception }, proc { el })
+
+              expect(locate_one).to eq el
+              expect(element_matcher).to have_received(:match).exactly(2).times
+            end
+
+            it 'Raises Exception if element continues to go stale' do
+              @locator = {xpath: './/div', id: 'foo'}
+
+              allow(driver).to receive(:find_elements).and_return([el])
+              stale_exception = Selenium::WebDriver::Error::StaleElementReferenceError
+              allow(element_matcher).to receive(:match).and_raise(stale_exception)
+
+              msg = 'Unable to locate element from {:xpath=>".//div", :id=>"foo"} due to changing page'
+              expect { locate_one }.to raise_exception Watir::Exception::LocatorException, msg
+              expect(element_matcher).to have_received(:match).exactly(3).times
+            end
+          end
+        end
+
+        describe '#locate_all' do
+          it 'locates using match' do
+            @locator = {xpath: './/div', id: 'foo'}
+
+            allow(driver).to receive(:find_elements).and_return([el])
+            allow(element_matcher).to receive(:match).and_return([el])
+
+            expect(locate_all).to eq [el]
+            expect(element_matcher).to have_received(:match).once
+          end
+
+          it 'raises LocatorException if element continues to go stale' do
+            @locator = {xpath: './/div', id: 'foo'}
+
+            allow(driver).to receive(:find_elements).and_return([el])
+            stale_exception = Selenium::WebDriver::Error::StaleElementReferenceError
+            allow(element_matcher).to receive(:match).and_raise(stale_exception)
+
+            msg = 'Unable to locate element collection from {:xpath=>".//div", :id=>"foo"} due to changing page'
+            expect { locate_all }.to raise_exception Watir::Exception::LocatorException, msg
+            expect(element_matcher).to have_received(:match).exactly(3).times
+          end
+
+          it 'raises Argument error if using index key' do
+            expect { locate_all(index: 2) }.to raise_exception(ArgumentError, "can't locate all elements by :index")
+          end
+        end
+      end
+    end
+  end
+end

data/spec/unit/match_elements/button_spec.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require_relative '../unit_helper'
+
+module Watir
+  module Locators
+    class Button
+      describe Matcher do
+        include LocatorSpecHelper
+
+        let(:query_scope) { @query_scope || instance_double(Watir::Browser) }
+        let(:matcher) { described_class.new(query_scope, @selector) }
+
+        describe '#match' do
+          it 'value attribute matches value' do
+            elements = [wd_element(text: 'foo', attributes: {value: 'foo'}),
+                        wd_element(text: 'bar', attributes: {value: 'bar'}),
+                        wd_element(text: '', attributes: {value: 'foobar'})]
+            values_to_match = {value: 'foobar'}
+
+            expect(matcher.match(elements, values_to_match, :all)).to eq [elements[2]]
+          end
+
+          it 'returns empty array if neither value nor text match' do
+            elements = [wd_element(text: 'foo', attributes: {value: 'foo'}),
+                        wd_element(text: 'bar', attributes: {value: 'bar'}),
+                        wd_element(text: '', attributes: {value: 'foobar'})]
+            values_to_match = {value: 'nope'}
+
+            expect(matcher.match(elements, values_to_match, :all)).to eq []
+          end
+
+          it 'does not evaluate other parameters if value locator is not satisfied' do
+            elements = [wd_element(text: 'foo', attributes: {value: 'foo'}, displayed?: nil),
+                        wd_element(text: 'bar', attributes: {value: 'bar'}, displayed?: nil),
+                        wd_element(text: '', attributes: {value: 'foobar'}, displayed?: nil)]
+
+            values_to_match = {value: 'nope', visible: true}
+            expect(matcher.match(elements, values_to_match, :all)).to eq []
+            expect(elements[0]).not_to have_received(:displayed?)
+            expect(elements[1]).not_to have_received(:displayed?)
+            expect(elements[2]).not_to have_received(:displayed?)
+          end
+
+          it 'does not calculate value if not passed in' do
+            elements = [wd_element(displayed?: true, text: 'foo', attributes: {value: 'foo'}),
+                        wd_element(displayed?: true, text: 'bar', attributes: {value: 'bar'})]
+            values_to_match = {visible: false}
+
+            expect(matcher.match(elements, values_to_match, :all)).to eq []
+            expect(elements[0]).not_to have_received(:text)
+            expect(elements[0]).not_to have_received(:text)
+            expect(elements[1]).not_to have_received(:attribute)
+            expect(elements[1]).not_to have_received(:attribute)
+          end
+
+          it 'returns empty array if element is not an input or button element' do
+            elements = [wd_element(tag_name: 'wrong', text: 'foob', attributes: {value: 'foo'}),
+                        wd_element(tag_name: 'wrong', text: 'bar', attributes: {value: 'bar'})]
+            values_to_match = {tag_name: 'button', value: 'foo'}
+
+            expect(matcher.match(elements, values_to_match, :all)).to eq []
+          end
+
+          it 'returns empty array if element is an input element with wrong type' do
+            elements = [wd_element(tag_name: 'input', text: 'foob', attributes: {value: 'foo', type: 'radio'}),
+                        wd_element(tag_name: 'input', text: 'bar', attributes: {value: 'bar', type: 'radio'})]
+            values_to_match = {tag_name: 'button', value: 'foo'}
+
+            expect(matcher.match(elements, values_to_match, :all)).to eq []
+          end
+        end
+      end
+    end
+  end
+end

data/spec/unit/match_elements/element_spec.rb

@@ -0,0 +1,424 @@
+# frozen_string_literal: true
+
+require_relative '../unit_helper'
+
+module Watir
+  module Locators
+    class Element
+      describe Matcher do
+        include LocatorSpecHelper
+
+        let(:query_scope) { @query_scope || browser }
+        let(:values_to_match) { @values_to_match || {} }
+        let(:matcher) { described_class.new(query_scope, values_to_match) }
+
+        describe '#match' do
+          context 'when a label element' do
+            it 'returns elements with for / id pairs' do
+              input_wds = [wd_element(tag_name: 'input', attributes: {id: 'foob_id'}),
+                           wd_element(tag_name: 'input', attributes: {id: 'bfoo_id'}),
+                           wd_element(tag_name: 'input', attributes: {id: 'foo_id'})]
+
+              label_wds = [wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label')]
+
+              allow(browser).to receive(:execute_script).and_return('foob', 'Foo', 'foo')
+
+              labels = [element(watir_element: Watir::Label, wd: label_wds[0], for: 'foob_id'),
+                        element(watir_element: Watir::Label, wd: label_wds[1], for: 'bfoo_id'),
+                        element(watir_element: Watir::Label, wd: label_wds[2], for: 'foo_id')]
+
+              allow(query_scope).to receive(:labels).and_return(labels)
+              allow_any_instance_of(Watir::Input).to receive(:wd).and_return(input_wds[2], input_wds[2])
+
+              values_to_match = {label_element: 'foo'}
+              expect(matcher.match(input_wds, values_to_match, :all)).to eq [input_wds[2]]
+              # Only the Watir::Label matching the text provided will have wd called
+              expect(labels[0]).not_to have_received(:for)
+              expect(labels[1]).not_to have_received(:for)
+            end
+
+            it 'returns elements without for / id pairs' do
+              input_wds = [wd_element(tag_name: 'input'),
+                           wd_element(tag_name: 'input'),
+                           wd_element(tag_name: 'input')]
+
+              inputs = [element(watir_element: Watir::Input, wd: input_wds[0]),
+                        element(watir_element: Watir::Input, wd: input_wds[1]),
+                        element(watir_element: Watir::Input, wd: input_wds[2])]
+
+              label_wds = [wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label')]
+
+              allow(browser).to receive(:execute_script).and_return('foob', 'Foo', 'foo')
+
+              labels = [element(watir_element: Watir::Label, wd: label_wds[0], for: '', input: inputs[0]),
+                        element(watir_element: Watir::Label, wd: label_wds[1], for: '', input: inputs[1]),
+                        element(watir_element: Watir::Label, wd: label_wds[2], for: '', input: inputs[2])]
+
+              allow(query_scope).to receive(:labels).and_return(labels)
+
+              values_to_match = {label_element: 'foo'}
+              expect(matcher.match(input_wds, values_to_match, :all)).to eq [input_wds[2]]
+
+              # Only the Watir::Label matching the text provided will have wd called
+              expect(labels[0]).not_to have_received(:for)
+              expect(labels[1]).not_to have_received(:for)
+            end
+
+            it 'returns elements with multiple matching label text but first missing corresponding element' do
+              input_wds = [wd_element(tag_name: 'input'),
+                           wd_element(tag_name: 'input')]
+
+              inputs = [element(watir_element: Watir::Input, wd: wd_element(tag_name: 'input')),
+                        element(watir_element: Watir::Input, wd: input_wds[1])]
+
+              label_wds = [wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label')]
+
+              allow(browser).to receive(:execute_script).and_return('foo', 'foo')
+
+              labels = [element(watir_element: Watir::Label, wd: label_wds[0], for: '', input: inputs[0]),
+                        element(watir_element: Watir::Label, wd: label_wds[1], for: '', input: inputs[1])]
+
+              allow(query_scope).to receive(:labels).and_return(labels)
+
+              values_to_match = {label_element: 'foo'}
+
+              expect(matcher.match(input_wds, values_to_match, :all)).to eq [input_wds[1]]
+            end
+
+            it 'returns empty Array if no label element matches' do
+              input_wds = [wd_element(tag_name: 'input', attributes: {id: 'foo'}),
+                           wd_element(tag_name: 'input', attributes: {id: 'bfoo'})]
+
+              label_wds = [wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label')]
+
+              allow(browser).to receive(:execute_script).and_return('Not this', 'or this')
+
+              labels = [element(watir_element: Watir::Label, wd: label_wds[0], for: 'foo'),
+                        element(watir_element: Watir::Label, wd: label_wds[1], for: 'bfoo')]
+
+              allow(query_scope).to receive(:labels).and_return(labels)
+
+              values_to_match = {label_element: 'foo'}
+
+              expect(matcher.match(input_wds, values_to_match, :all)).to eq []
+            end
+
+            it 'returns empty Array if matching label elements do not have an corresponding input element' do
+              input_wds = [wd_element(tag_name: 'input'),
+                           wd_element(tag_name: 'input')]
+
+              inputs = [element(watir_element: Watir::Input, wd: wd_element(tag_name: 'input')),
+                        element(watir_element: Watir::Input, wd: wd_element(tag_name: 'input'))]
+
+              label_wds = [wd_element(tag_name: 'label'),
+                           wd_element(tag_name: 'label')]
+
+              allow(browser).to receive(:execute_script).and_return('foob', 'foo')
+
+              labels = [element(watir_element: Watir::Label, wd: label_wds[0], for: '', input: inputs[0]),
+                        element(watir_element: Watir::Label, wd: label_wds[1], for: '', input: inputs[1])]
+
+              allow(query_scope).to receive(:labels).and_return(labels)
+
+              values_to_match = {label_element: 'foo'}
+
+              expect(matcher.match(input_wds, values_to_match, :all)).to eq []
+            end
+          end
+
+          context 'when locating one element' do
+            before { @filter = :first }
+
+            it 'by tag name' do
+              elements = [wd_element(tag_name: 'div'),
+                          wd_element(tag_name: 'span')]
+              @values_to_match = {tag_name: 'span'}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[1]
+            end
+
+            it 'by attribute' do
+              elements = [wd_element(attributes: {id: 'foo'}),
+                          wd_element(attributes: {id: 'bar'}),
+                          wd_element(attributes: {id: 'foobar'})]
+              @values_to_match = {id: 'foobar'}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[2]
+            end
+
+            it 'by class array' do
+              elements = [wd_element(attributes: {class: 'foob bar'}),
+                          wd_element(attributes: {class: 'bar'}),
+                          wd_element(attributes: {class: 'bar foo'})]
+              @values_to_match = {class: %w[foo bar]}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[2]
+            end
+
+            it 'by positive index' do
+              elements = [wd_element(tag_name: 'div'),
+                          wd_element(tag_name: 'span'),
+                          wd_element(tag_name: 'div')]
+
+              @values_to_match = {tag_name: 'div', index: 1}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[2]
+            end
+
+            it 'by negative index' do
+              elements = [wd_element(tag_name: 'div'),
+                          wd_element(tag_name: 'span'),
+                          wd_element(tag_name: 'div')]
+
+              @values_to_match = {tag_name: 'div', index: -1}
+
+              expect(matcher.match(elements.dup, values_to_match, @filter)).to eq elements[2]
+            end
+
+            it 'by visibility true' do
+              elements = [wd_element(tag_name: 'div', displayed?: false),
+                          wd_element(tag_name: 'span', displayed?: true)]
+              @values_to_match = {visible: true}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[1]
+            end
+
+            it 'by visibility false' do
+              elements = [wd_element(tag_name: 'div', displayed?: true),
+                          wd_element(tag_name: 'span', displayed?: false)]
+              @values_to_match = {visible: false}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[1]
+            end
+
+            it 'by text' do
+              elements = [wd_element, wd_element]
+              @values_to_match = {text: 'Foob'}
+
+              allow(browser).to receive(:execute_script).and_return('foo', 'Foob')
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[1]
+            end
+
+            it 'by visible text' do
+              elements = [wd_element(text: 'foo'),
+                          wd_element(text: 'Foob')]
+              @values_to_match = {visible_text: /Foo|Bar/}
+
+              allow(elements[0]).to receive(:text).and_return 'foo'
+              allow(elements[1]).to receive(:text).and_return 'Foob'
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[1]
+            end
+
+            it 'by href' do
+              elements = [wd_element(tag_name: 'div', attributes: {href: 'froo.com'}),
+                          wd_element(tag_name: 'span', attributes: {href: 'bar.com'})]
+              @values_to_match = {href: /foo|bar/}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq elements[1]
+            end
+
+            it "returns nil if found element doesn't match the selector tag_name" do
+              elements = [wd_element(tag_name: 'div')]
+
+              @values_to_match = {tag_name: 'span'}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to be_nil
+            end
+          end
+
+          context 'when locating collection' do
+            before { @filter = :all }
+
+            it 'by tag name' do
+              elements = [wd_element(tag_name: 'div'),
+                          wd_element(tag_name: 'span'),
+                          wd_element(tag_name: 'div')]
+              @values_to_match = {tag_name: 'div'}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+
+            it 'by attribute' do
+              elements = [wd_element(attributes: {foo: 'foo'}),
+                          wd_element(attributes: {foo: 'bar'}),
+                          wd_element(attributes: {foo: 'foo'})]
+              @values_to_match = {foo: 'foo'}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+
+            it 'by single class' do
+              elements = [wd_element(attributes: {class: 'foo bar cool'}),
+                          wd_element(attributes: {class: 'foob bar'}),
+                          wd_element(attributes: {class: 'bar foo foobar'})]
+              @values_to_match = {class: 'foo'}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+
+            it 'by class array' do
+              elements = [wd_element(attributes: {class: 'foo bar cool'}),
+                          wd_element(attributes: {class: 'foob bar'}),
+                          wd_element(attributes: {class: 'bar foo foobar'})]
+              @values_to_match = {class: %w[foo bar]}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+
+            it 'by visibility true' do
+              elements = [wd_element(tag_name: 'div'),
+                          wd_element(tag_name: 'span'),
+                          wd_element(tag_name: 'div')]
+              @values_to_match = {visible: true}
+
+              allow(elements[0]).to receive(:displayed?).and_return false
+              allow(elements[1]).to receive(:displayed?).and_return true
+              allow(elements[2]).to receive(:displayed?).and_return true
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[1], elements[2]]
+            end
+
+            it 'by visibility false' do
+              elements = [wd_element(displayed?: false),
+                          wd_element(displayed?: true),
+                          wd_element(displayed?: false)]
+              @values_to_match = {visible: false}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+
+            it 'by text' do
+              elements = [wd_element, wd_element, wd_element]
+              @values_to_match = {text: /Foo|Bar/}
+
+              allow(browser).to receive(:execute_script).and_return('foo', 'Foob', 'bBarb')
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[1], elements[2]]
+            end
+
+            it 'by visible text' do
+              elements = [wd_element(text: 'foo'),
+                          wd_element(text: 'Foob'),
+                          wd_element(text: 'bBarb')]
+              @values_to_match = {visible_text: /Foo|Bar/}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[1], elements[2]]
+            end
+
+            it 'by href' do
+              elements = [wd_element(attributes: {href: 'froo.com'}),
+                          wd_element(attributes: {href: 'bar.com'}),
+                          wd_element(attributes: {href: 'foobar.com'})]
+              @values_to_match = {href: /foo|bar/}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[1], elements[2]]
+            end
+
+            it 'returns empty Array if found no element matches the selector tag_name' do
+              elements = [wd_element(tag_name: 'div')]
+
+              @values_to_match = {tag_name: 'span'}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq []
+            end
+          end
+
+          context 'when matching Regular Expressions' do
+            it 'with white space' do
+              allow(browser).to receive(:execute_script).and_return("\n match this \n", 'no', 'match  this')
+
+              elements = [wd_element,
+                          wd_element,
+                          wd_element]
+              @values_to_match = {text: /^match this$/}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+
+            it 'with tag_name' do
+              elements = [wd_element(tag_name: 'div'),
+                          wd_element(tag_name: 'span'),
+                          wd_element(tag_name: 'div')]
+              @values_to_match = {tag_name: /d|q/}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+
+            it 'with single class' do
+              elements = [wd_element(attributes: {class: 'foo bar cool'}),
+                          wd_element(attributes: {class: 'foob bar'}),
+                          wd_element(attributes: {class: 'bar foo foobar'})]
+              @values_to_match = {class: /foob|q/}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[1], elements[2]]
+            end
+
+            it 'with multiple classes' do
+              elements = [wd_element(attributes: {class: 'foo bar cool'}),
+                          wd_element(attributes: {class: 'foob bar'}),
+                          wd_element(attributes: {class: 'bar foo foobar'})]
+              @values_to_match = {class: [/foob/, /bar/]}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[1], elements[2]]
+            end
+
+            it 'with attributes' do
+              elements = [wd_element(attributes: {foo: 'foo'}),
+                          wd_element(attributes: {foo: 'bar'}),
+                          wd_element(attributes: {foo: 'foo'})]
+              @values_to_match = {foo: /fo/}
+
+              expect(matcher.match(elements, values_to_match, @filter)).to eq [elements[0], elements[2]]
+            end
+          end
+
+          context 'when matching text Regexp' do
+            let(:elements) { [wd_element, wd_element] }
+
+            before { allow(browser).to receive(:execute_script).and_return('all visible', 'some visible') }
+
+            it 'not thrown when still matched by text content' do
+              values_to_match = {text: /some visible/}
+
+              expect(matcher.match(elements, values_to_match, :first)).to eq elements[1]
+            end
+
+            it 'not thrown with complex regexp matched by text content' do
+              values_to_match = {text: /some (in|)visible/}
+
+              expect(matcher.match(elements, values_to_match, :first)).to eq elements[1]
+            end
+
+            it 'thrown when no longer matched by text content' do
+              values_to_match = {text: /some visible$/}
+
+              expect(matcher.match(elements, values_to_match, :first)).to eq elements[1]
+            end
+
+            it 'not thrown when element does not exist' do
+              values_to_match = {text: /definitely not there/}
+
+              expect(matcher.match(elements, values_to_match, :first)).to be_nil
+            end
+
+            it 'keeps element from being located' do
+              values_to_match = {text: /some visible some hidden/}
+
+              expect(matcher.match(elements, values_to_match, :first)).to be_nil
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/unit/match_elements/text_field_spec.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+require_relative '../unit_helper'
+
+module Watir
+  module Locators
+    class TextField
+      describe Matcher do
+        include LocatorSpecHelper
+
+        let(:query_scope) { @query_scope || instance_double(Watir::Browser) }
+        let(:matcher) { described_class.new(query_scope, @selector) }
+
+        describe '#match?' do
+          context 'when input element' do
+            it 'converts text to value' do
+              elements = [wd_element(tag_name: 'input', attributes: {value: 'foo'}, text: nil),
+                          wd_element(tag_name: 'input', attributes: {value: 'Foob'}, text: nil)]
+              values_to_match = {text: 'Foob'}
+
+              expect(matcher.match(elements, values_to_match, :all)).to eq [elements[1]]
+              expect(elements[0]).not_to have_received(:text)
+              expect(elements[1]).not_to have_received(:text)
+            end
+
+            it 'converts label to value' do
+              elements = [wd_element(tag_name: 'input', attributes: {value: 'foo'}),
+                          wd_element(tag_name: 'input', attributes: {value: 'Foob'})]
+              values_to_match = {label: 'Foob'}
+
+              expect(matcher.match(elements, values_to_match, :all)).to eq [elements[1]]
+              expect(elements[0]).not_to have_received(:attribute).with(values_to_match)
+              expect(elements[1]).not_to have_received(:attribute).with(values_to_match)
+            end
+
+            it 'converts visible_text to value' do
+              elements = [wd_element(tag_name: 'input', attributes: {value: 'foo'}),
+                          wd_element(tag_name: 'input', attributes: {value: 'Foob'})]
+              values_to_match = {visible_text: 'Foob'}
+
+              expect(matcher.match(elements, values_to_match, :all)).to eq [elements[1]]
+              expect(elements[0]).not_to have_received(:attribute).with(values_to_match)
+              expect(elements[1]).not_to have_received(:attribute).with(values_to_match)
+            end
+          end
+
+          context 'when label element' do
+            it 'converts value to text' do
+              elements = [wd_element(tag_name: 'label', attribute: nil),
+                          wd_element(tag_name: 'label', attribute: nil)]
+              values_to_match = {value: 'Foob'}
+
+              allow(query_scope).to receive(:execute_script).and_return('foo', 'Foob')
+              expect(elements[0]).not_to have_received(:attribute)
+              expect(elements[1]).not_to have_received(:attribute)
+
+              expect(matcher.match(elements, values_to_match, :all)).to eq [elements[1]]
+            end
+
+            it 'converts label to text' do
+              elements = [wd_element(tag_name: 'label', attribute: nil),
+                          wd_element(tag_name: 'label', attribute: nil)]
+              values_to_match = {label: 'Foob'}
+
+              allow(query_scope).to receive(:execute_script).and_return('foo', 'Foob')
+
+              expect(matcher.match(elements, values_to_match, :all)).to eq [elements[1]]
+              expect(elements[0]).not_to have_received(:attribute)
+              expect(elements[1]).not_to have_received(:attribute)
+            end
+          end
+
+          it 'returns empty array if element is not an input' do
+            elements = [wd_element(tag_name: 'wrong', text: 'foob', attributes: {value: 'foo'}),
+                        wd_element(tag_name: 'wrong', text: 'bar', attributes: {value: 'bar'})]
+            values_to_match = {tag_name: 'input', value: 'foo'}
+
+            expect(matcher.match(elements, values_to_match, :all)).to eq []
+          end
+        end
+      end
+    end
+  end
+end