watir 7.2.0 → 7.3.0

data/spec/watirspec/support/rspec_matchers.rb

@@ -1,36 +1,45 @@
 # frozen_string_literal: true
 
 if defined?(RSpec)
-  RSpec::Matchers.define :have_deprecated do |deprecation|
-    match do |actual|
-      # Suppresses logging output to stdout while ensuring that it is still happening
-      default_output = Selenium::WebDriver.logger.io
-      io = StringIO.new
-      Watir.logger.output = io
+  LEVELS = %w[warning info deprecated].freeze
 
-      actual.call
+  LEVELS.each do |level|
+    RSpec::Matchers.define "have_#{level}" do |entry|
+      match do |actual|
+        # Suppresses logging output to stdout while ensuring that it is still happening
+        default_output = Watir.logger.io
+        io = StringIO.new
+        Watir.logger.output = io
 
-      Watir.logger.output = default_output
-      @deprecations_found = (io.rewind && io.read).scan(/DEPRECATION\] \[:([^\]]*)\]/).flatten.map(&:to_sym)
-      expect(Array(deprecation).sort).to eq(@deprecations_found.sort)
-    end
+        begin
+          actual.call
+        rescue StandardError => e
+          raise e, 'Can not evaluate output when statement raises an exception'
+        ensure
+          Watir.logger.output = default_output
+        end
 
-    failure_message do
-      but_message = if @deprecations_found.nil? || @deprecations_found.empty?
-                      'no deprecations were found'
-                    else
-                      "instead these deprecations were found: [#{@deprecations_found.join(', ')}]"
-                    end
-      "expected :#{deprecation} to have been deprecated, but #{but_message}"
-    end
+        @entries_found = (io.rewind && io.read).scan(/\[:([^\]]*)\]/).flatten.map(&:to_sym)
+        expect(Array(entry).sort).to eq(@entries_found.sort)
+      end
 
-    failure_message_when_negated do
-      but_message = "it was found among these deprecations: [#{@deprecations_found.join(', ')}]"
-      "expected :#{deprecation} not to have been deprecated, but #{but_message}"
-    end
+      failure_message do
+        but_message = if @entries_found.nil? || @entries_found.empty?
+                        "no #{entry} entries were reported"
+                      else
+                        "instead these entries were found: [#{@entries_found.join(', ')}]"
+                      end
+        "expected :#{entry} to have been logged, but #{but_message}"
+      end
 
-    def supports_block_expectations?
-      true
+      failure_message_when_negated do
+        but_message = "it was found among these entries: [#{@entries_found.join(', ')}]"
+        "expected :#{entry} not to have been logged, but #{but_message}"
+      end
+
+      def supports_block_expectations?
+        true
+      end
     end
   end
 

data/spec/watirspec/user_editable_spec.rb

@@ -2,204 +2,206 @@
 
 require 'watirspec_helper'
 
-describe Watir::UserEditable do
-  before :each do
-    browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
-  end
-
-  describe '#append' do
-    it 'appends the text to the text field', except: {browser: :safari, reason: 'incorrectly clears first'} do
-      browser.text_field(name: 'new_user_occupation').append(' Append This')
-      expect(browser.text_field(name: 'new_user_occupation').value).to eq 'Developer Append This'
-    end
-
-    it 'appends multi-byte characters', except: {browser: :safari, reason: 'incorrectly clears first'} do
-      browser.text_field(name: 'new_user_occupation').append(' ijij')
-      expect(browser.text_field(name: 'new_user_occupation').value).to eq 'Developer ijij'
-    end
-
-    it 'raises NotImplementedError if the object is content editable element' do
-      msg = '#append method is not supported with contenteditable element'
-      expect { browser.div(id: 'contenteditable').append('bar') }.to raise_exception(NotImplementedError, msg)
-    end
-
-    it 'raises ObjectReadOnlyException if the object is read only' do
-      expect { browser.text_field(id: 'new_user_code').append('Append This') }.to raise_object_read_only_exception
-    end
-
-    it 'raises ObjectDisabledException if the object is disabled' do
-      expect { browser.text_field(name: 'new_user_species').append('Append This') }.to raise_object_disabled_exception
-    end
-
-    it "raises UnknownObjectException if the object doesn't exist" do
-      expect { browser.text_field(name: 'no_such_name').append('Append This') }.to raise_unknown_object_exception
-    end
-  end
-
-  describe '#clear' do
-    it 'removes all text from the text field' do
-      browser.text_field(name: 'new_user_occupation').clear
-      expect(browser.text_field(name: 'new_user_occupation').value).to be_empty
-      browser.textarea(id: 'delete_user_comment').clear
-      expect(browser.textarea(id: 'delete_user_comment').value).to be_empty
-    end
-
-    it 'removes all text from the content editable element' do
-      browser.div(id: 'contenteditable').clear
-      expect(browser.div(id: 'contenteditable').text).to eq ''
-    end
-
-    it "raises UnknownObjectException if the text field doesn't exist" do
-      expect { browser.text_field(id: 'no_such_id').clear }.to raise_unknown_object_exception
-    end
-
-    it 'raises ObjectReadOnlyException if the object is read only' do
-      expect { browser.text_field(id: 'new_user_code').clear }.to raise_object_read_only_exception
-    end
-  end
-
-  describe '#value=' do
-    it 'sets the value of the element' do
-      browser.text_field(id: 'new_user_email').value = 'Hello Cruel World'
-      expect(browser.text_field(id: 'new_user_email').value).to eq 'Hello Cruel World'
-    end
-
-    it 'is able to set multi-byte characters' do
-      browser.text_field(name: 'new_user_occupation').value = 'ijij'
-      expect(browser.text_field(name: 'new_user_occupation').value).to eq 'ijij'
-    end
-
-    it 'sets the value of a textarea element' do
-      browser.textarea(id: 'delete_user_comment').value = 'Hello Cruel World'
-      expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Hello Cruel World'
-    end
-
-    it "raises UnknownObjectException if the text field doesn't exist" do
-      expect { browser.text_field(name: 'no_such_name').value = 'yo' }.to raise_unknown_object_exception
-    end
-  end
-
-  describe '#set' do
-    it 'sets the value of the element' do
-      browser.text_field(id: 'new_user_email').set('Bye Cruel World')
-      expect(browser.text_field(id: 'new_user_email').value).to eq 'Bye Cruel World'
-    end
-
-    it 'sets the value of a textarea element' do
-      browser.textarea(id: 'delete_user_comment').set('Hello Cruel World')
-      expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Hello Cruel World'
-    end
-
-    it 'sets the value of a content editable element' do
-      browser.div(id: 'contenteditable').set('Bar')
-      expect(browser.div(id: 'contenteditable').text).to eq 'Bar'
-    end
-
-    it 'fires events' do
-      browser.text_field(id: 'new_user_username').set('Hello World')
-      expect(browser.span(id: 'current_length').text).to eq '11'
-    end
-
-    it 'sets the value of a password field' do
-      browser.text_field(name: 'new_user_password').set('secret')
-      expect(browser.text_field(name: 'new_user_password').value).to eq 'secret'
-    end
-
-    it 'sets the value when accessed through the enclosing Form' do
-      browser.form(id: 'new_user').text_field(name: 'new_user_password').set('secret')
-      expect(browser.form(id: 'new_user').text_field(name: 'new_user_password').value).to eq 'secret'
-    end
-
-    it 'is able to set multi-byte characters' do
-      browser.text_field(name: 'new_user_occupation').set('ijij')
-      expect(browser.text_field(name: 'new_user_occupation').value).to eq 'ijij'
-    end
-
-    it 'sets the value to a concatenation of multiple arguments' do
-      browser.text_field(id: 'new_user_email').set('Bye', 'Cruel', 'World')
-      expect(browser.text_field(id: 'new_user_email').value).to eq 'ByeCruelWorld'
-    end
-
-    it 'sets the value to blank when no arguments are provided' do
-      browser.text_field(id: 'new_user_email').set
-      expect(browser.text_field(id: 'new_user_email').value).to eq ''
-    end
-
-    it "raises UnknownObjectException if the text field doesn't exist" do
-      expect { browser.text_field(id: 'no_such_id').set('secret') }.to raise_unknown_object_exception
-    end
-
-    it 'raises ObjectReadOnlyException if the object is read only' do
-      expect { browser.text_field(id: 'new_user_code').set('Foo') }.to raise_object_read_only_exception
-    end
-  end
-
-  describe '#set!' do
-    it 'sets the value of the element' do
-      browser.text_field(id: 'new_user_email').set!('Bye Cruel World')
-      expect(browser.text_field(id: 'new_user_email').value).to eq 'Bye Cruel World'
-    end
-
-    it 'sets the value of a textarea element' do
-      browser.textarea(id: 'delete_user_comment').set!('Hello Cruel World')
-      expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Hello Cruel World'
-    end
-
-    it 'sets the value of a content editable element' do
-      browser.div(id: 'contenteditable').set!('foo')
-      expect(browser.div(id: 'contenteditable').text).to eq 'foo'
-    end
-
-    it 'fires events' do
-      browser.text_field(id: 'new_user_username').set!('Hello World')
-      expect(browser.span(id: 'current_length').text).to eq '11'
-    end
-
-    it 'sets the value of a password field' do
-      browser.text_field(name: 'new_user_password').set!('secret')
-      expect(browser.text_field(name: 'new_user_password').value).to eq 'secret'
-    end
-
-    it 'sets the value when accessed through the enclosing Form' do
-      browser.form(id: 'new_user').text_field(name: 'new_user_password').set!('secret')
-      expect(browser.form(id: 'new_user').text_field(name: 'new_user_password').value).to eq 'secret'
-    end
-
-    it 'is able to set multi-byte characters' do
-      browser.text_field(name: 'new_user_occupation').set!('ijij')
-      expect(browser.text_field(name: 'new_user_occupation').value).to eq 'ijij'
-    end
-
-    it 'sets the value to a concatenation of multiple arguments' do
-      browser.text_field(id: 'new_user_email').set!('Bye', 'Cruel', 'World')
-      expect(browser.text_field(id: 'new_user_email').value).to eq 'ByeCruelWorld'
-    end
-
-    it 'sets the value to blank when no arguments are provided' do
-      browser.text_field(id: 'new_user_email').set!
-      expect(browser.text_field(id: 'new_user_email').value).to eq ''
-    end
-
-    it 'raises ArgumentError for special keys' do
-      expect { browser.text_field(id: 'new_user_email').set!('a', :tab) }.to raise_error(ArgumentError)
-    end
-
-    it "raises UnknownObjectException if the text field doesn't exist" do
-      expect { browser.text_field(id: 'no_such_id').set!('secret') }.to raise_unknown_object_exception
-    end
-
-    it "raises Exception if the value of text field doesn't match" do
-      element = browser.text_field(id: 'new_user_password')
-      allow(element).to receive(:value).and_return('wrong')
-      msg = "#set! value: 'wrong' does not match expected input: 'secret'"
-      expect { element.set!('secret') }.to raise_exception(Watir::Exception::Error, msg)
-    end
-
-    it "raises Exception if the text of content editable element doesn't match" do
-      element = browser.div(id: 'contenteditable')
-      allow(element).to receive(:text).and_return('wrong')
-      msg = "#set! text: 'wrong' does not match expected input: 'secret'"
-      expect { element.set!('secret') }.to raise_exception(Watir::Exception::Error, msg)
+module Watir
+  describe UserEditable do
+    before do
+      browser.goto(WatirSpec.url_for('forms_with_input_elements.html'))
+    end
+
+    describe '#append' do
+      it 'appends the text to the text field', except: {browser: :safari, reason: 'incorrectly clears first'} do
+        browser.text_field(name: 'new_user_occupation').append(' Append This')
+        expect(browser.text_field(name: 'new_user_occupation').value).to eq 'Developer Append This'
+      end
+
+      it 'appends multi-byte characters', except: {browser: :safari, reason: 'incorrectly clears first'} do
+        browser.text_field(name: 'new_user_occupation').append(' ijij')
+        expect(browser.text_field(name: 'new_user_occupation').value).to eq 'Developer ijij'
+      end
+
+      it 'raises NotImplementedError if the object is content editable element' do
+        msg = '#append method is not supported with contenteditable element'
+        expect { browser.div(id: 'contenteditable').append('bar') }.to raise_exception(NotImplementedError, msg)
+      end
+
+      it 'raises ObjectReadOnlyException if the object is read only' do
+        expect { browser.text_field(id: 'new_user_code').append('Append This') }.to raise_object_read_only_exception
+      end
+
+      it 'raises ObjectDisabledException if the object is disabled' do
+        expect { browser.text_field(name: 'new_user_species').append('Append This') }.to raise_object_disabled_exception
+      end
+
+      it "raises UnknownObjectException if the object doesn't exist" do
+        expect { browser.text_field(name: 'no_such_name').append('Append This') }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#clear' do
+      it 'removes all text from the text field' do
+        browser.text_field(name: 'new_user_occupation').clear
+        expect(browser.text_field(name: 'new_user_occupation').value).to be_empty
+        browser.textarea(id: 'delete_user_comment').clear
+        expect(browser.textarea(id: 'delete_user_comment').value).to be_empty
+      end
+
+      it 'removes all text from the content editable element' do
+        browser.div(id: 'contenteditable').clear
+        expect(browser.div(id: 'contenteditable').text).to eq ''
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(id: 'no_such_id').clear }.to raise_unknown_object_exception
+      end
+
+      it 'raises ObjectReadOnlyException if the object is read only' do
+        expect { browser.text_field(id: 'new_user_code').clear }.to raise_object_read_only_exception
+      end
+    end
+
+    describe '#value=' do
+      it 'sets the value of the element' do
+        browser.text_field(id: 'new_user_email').value = 'Hello Cruel World'
+        expect(browser.text_field(id: 'new_user_email').value).to eq 'Hello Cruel World'
+      end
+
+      it 'is able to set multi-byte characters' do
+        browser.text_field(name: 'new_user_occupation').value = 'ijij'
+        expect(browser.text_field(name: 'new_user_occupation').value).to eq 'ijij'
+      end
+
+      it 'sets the value of a textarea element' do
+        browser.textarea(id: 'delete_user_comment').value = 'Hello Cruel World'
+        expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Hello Cruel World'
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(name: 'no_such_name').value = 'yo' }.to raise_unknown_object_exception
+      end
+    end
+
+    describe '#set' do
+      it 'sets the value of the element' do
+        browser.text_field(id: 'new_user_email').set('Bye Cruel World')
+        expect(browser.text_field(id: 'new_user_email').value).to eq 'Bye Cruel World'
+      end
+
+      it 'sets the value of a textarea element' do
+        browser.textarea(id: 'delete_user_comment').set('Hello Cruel World')
+        expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Hello Cruel World'
+      end
+
+      it 'sets the value of a content editable element' do
+        browser.div(id: 'contenteditable').set('Bar')
+        expect(browser.div(id: 'contenteditable').text).to eq 'Bar'
+      end
+
+      it 'fires events' do
+        browser.text_field(id: 'new_user_username').set('Hello World')
+        expect(browser.span(id: 'current_length').text).to eq '11'
+      end
+
+      it 'sets the value of a password field' do
+        browser.text_field(name: 'new_user_password').set('secret')
+        expect(browser.text_field(name: 'new_user_password').value).to eq 'secret'
+      end
+
+      it 'sets the value when accessed through the enclosing Form' do
+        browser.form(id: 'new_user').text_field(name: 'new_user_password').set('secret')
+        expect(browser.form(id: 'new_user').text_field(name: 'new_user_password').value).to eq 'secret'
+      end
+
+      it 'is able to set multi-byte characters' do
+        browser.text_field(name: 'new_user_occupation').set('ijij')
+        expect(browser.text_field(name: 'new_user_occupation').value).to eq 'ijij'
+      end
+
+      it 'sets the value to a concatenation of multiple arguments' do
+        browser.text_field(id: 'new_user_email').set('Bye', 'Cruel', 'World')
+        expect(browser.text_field(id: 'new_user_email').value).to eq 'ByeCruelWorld'
+      end
+
+      it 'sets the value to blank when no arguments are provided' do
+        browser.text_field(id: 'new_user_email').set
+        expect(browser.text_field(id: 'new_user_email').value).to eq ''
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(id: 'no_such_id').set('secret') }.to raise_unknown_object_exception
+      end
+
+      it 'raises ObjectReadOnlyException if the object is read only' do
+        expect { browser.text_field(id: 'new_user_code').set('Foo') }.to raise_object_read_only_exception
+      end
+    end
+
+    describe '#set!' do
+      it 'sets the value of the element' do
+        browser.text_field(id: 'new_user_email').set!('Bye Cruel World')
+        expect(browser.text_field(id: 'new_user_email').value).to eq 'Bye Cruel World'
+      end
+
+      it 'sets the value of a textarea element' do
+        browser.textarea(id: 'delete_user_comment').set!('Hello Cruel World')
+        expect(browser.textarea(id: 'delete_user_comment').value).to eq 'Hello Cruel World'
+      end
+
+      it 'sets the value of a content editable element' do
+        browser.div(id: 'contenteditable').set!('foo')
+        expect(browser.div(id: 'contenteditable').text).to eq 'foo'
+      end
+
+      it 'fires events' do
+        browser.text_field(id: 'new_user_username').set!('Hello World')
+        expect(browser.span(id: 'current_length').text).to eq '11'
+      end
+
+      it 'sets the value of a password field' do
+        browser.text_field(name: 'new_user_password').set!('secret')
+        expect(browser.text_field(name: 'new_user_password').value).to eq 'secret'
+      end
+
+      it 'sets the value when accessed through the enclosing Form' do
+        browser.form(id: 'new_user').text_field(name: 'new_user_password').set!('secret')
+        expect(browser.form(id: 'new_user').text_field(name: 'new_user_password').value).to eq 'secret'
+      end
+
+      it 'is able to set multi-byte characters' do
+        browser.text_field(name: 'new_user_occupation').set!('ijij')
+        expect(browser.text_field(name: 'new_user_occupation').value).to eq 'ijij'
+      end
+
+      it 'sets the value to a concatenation of multiple arguments' do
+        browser.text_field(id: 'new_user_email').set!('Bye', 'Cruel', 'World')
+        expect(browser.text_field(id: 'new_user_email').value).to eq 'ByeCruelWorld'
+      end
+
+      it 'sets the value to blank when no arguments are provided' do
+        browser.text_field(id: 'new_user_email').set!
+        expect(browser.text_field(id: 'new_user_email').value).to eq ''
+      end
+
+      it 'raises ArgumentError for special keys' do
+        expect { browser.text_field(id: 'new_user_email').set!('a', :tab) }.to raise_error(ArgumentError)
+      end
+
+      it "raises UnknownObjectException if the text field doesn't exist" do
+        expect { browser.text_field(id: 'no_such_id').set!('secret') }.to raise_unknown_object_exception
+      end
+
+      it "raises Exception if the value of text field doesn't match" do
+        element = browser.text_field(id: 'new_user_password')
+        allow(element).to receive(:value).and_return('wrong')
+        msg = "#set! value: 'wrong' does not match expected input: 'secret'"
+        expect { element.set!('secret') }.to raise_exception(Watir::Exception::Error, msg)
+      end
+
+      it "raises Exception if the text of content editable element doesn't match" do
+        element = browser.div(id: 'contenteditable')
+        allow(element).to receive(:text).and_return('wrong')
+        msg = "#set! text: 'wrong' does not match expected input: 'secret'"
+        expect { element.set!('secret') }.to raise_exception(Watir::Exception::Error, msg)
+      end
     end
   end
 end