selenium-webdriver 3.141.0 → 3.142.3

data/lib/selenium/webdriver/common/error.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -17,7 +19,7 @@
 
 module Selenium
   module WebDriver
-    module Error
+    module Error # rubocop:disable Metrics/ModuleLength
 
       #
       # Returns exception from code (Integer - OSS, String - W3C).
@@ -29,7 +31,7 @@ module Selenium
         when nil, 0
           nil
         when Integer
-          ERRORS.fetch(code)
+          Object.const_get(ERRORS.fetch(code).to_s)
         when String
           klass_name = code.split(' ').map(&:capitalize).join.sub(/Error$/, '')
           const_get("#{klass_name}Error", false)
@@ -210,6 +212,13 @@ module Selenium
 
       class ElementNotInteractableError < WebDriverError; end
 
+      #
+      # A command could not be completed because TLS certificate is expired
+      # or invalid.
+      #
+
+      class InsecureCertificateError < WebDriverError; end
+
       #
       # The arguments passed to a command are either invalid or malformed.
       #
@@ -263,30 +272,30 @@ module Selenium
       class UnsupportedOperationError < WebDriverError; end
 
       # Aliases for OSS dialect.
-      ScriptTimeoutError  = ScriptTimeOutError
-      TimeoutError        = TimeOutError
-      NoAlertOpenError    = NoAlertPresentError
+      ScriptTimeoutError  = Class.new(ScriptTimeOutError)
+      TimeoutError        = Class.new(TimeOutError)
+      NoAlertOpenError    = Class.new(NoAlertPresentError)
 
       # Aliases for backwards compatibility.
-      ObsoleteElementError      = StaleElementReferenceError
-      UnhandledError            = UnknownError
-      UnexpectedJavascriptError = JavascriptError
-      ElementNotDisplayedError  = ElementNotVisibleError
+      ObsoleteElementError      = Class.new(StaleElementReferenceError)
+      UnhandledError            = Class.new(UnknownError)
+      UnexpectedJavascriptError = Class.new(JavascriptError)
+      ElementNotDisplayedError  = Class.new(ElementNotVisibleError)
 
       #
       # @api private
       #
 
       ERRORS = {
-        1  => IndexOutOfBoundsError,
-        2  => NoCollectionError,
-        3  => NoStringError,
-        4  => NoStringLengthError,
-        5  => NoStringWrapperError,
-        6  => NoSuchDriverError,
-        7  => NoSuchElementError,
-        8  => NoSuchFrameError,
-        9  => UnknownCommandError,
+        1 => IndexOutOfBoundsError,
+        2 => NoCollectionError,
+        3 => NoStringError,
+        4 => NoStringLengthError,
+        5 => NoStringWrapperError,
+        6 => NoSuchDriverError,
+        7 => NoSuchElementError,
+        8 => NoSuchFrameError,
+        9 => UnknownCommandError,
         10 => StaleElementReferenceError,
         11 => ElementNotVisibleError,
         12 => InvalidElementStateError,
@@ -322,6 +331,53 @@ module Selenium
         63 => UnableToCaptureScreenError
       }.freeze
 
+      DEPRECATED_ERRORS = {
+        IndexOutOfBoundsError: nil,
+        NoCollectionError: nil,
+        NoStringError: nil,
+        NoStringLengthError: nil,
+        NoStringWrapperError: nil,
+        NoSuchDriverError: nil,
+        ElementNotVisibleError: ElementNotInteractableError,
+        InvalidElementStateError: ElementNotInteractableError,
+        ElementNotSelectableError: ElementNotInteractableError,
+        ExpectedError: nil,
+        NoSuchDocumentError: nil,
+        NoScriptResultError: nil,
+        XPathLookupError: InvalidSelectorError,
+        NoSuchCollectionError: nil,
+        UnhandledAlertError: UnexpectedAlertOpenError,
+        NoAlertPresentError: NoSuchAlertError,
+        NoAlertOpenError: NoSuchAlertError,
+        ScriptTimeOutError: ScriptTimeoutError,
+        InvalidElementCoordinatesError: nil,
+        IMENotAvailableError: nil,
+        IMEEngineActivationFailedError: nil,
+        InvalidXpathSelectorError: InvalidSelectorError,
+        InvalidXpathSelectorReturnTyperError: InvalidSelectorError,
+        TimeOutError: TimeoutError,
+        ObsoleteElementError: StaleElementReferenceError,
+        UnhandledError: UnknownError,
+        UnexpectedJavascriptError: JavascriptError,
+        ElementNotDisplayedError: ElementNotInteractableError
+      }.freeze
+
+      DEPRECATED_ERRORS.keys.each do |oss_error|
+        remove_const oss_error
+      end
+
+      def self.const_missing(const_name)
+        super unless DEPRECATED_ERRORS.key?(const_name)
+        if DEPRECATED_ERRORS[const_name]
+          WebDriver.logger.deprecate("Selenium::WebDriver::Error::#{const_name}",
+                                     "#{DEPRECATED_ERRORS[const_name]} (ensure the driver supports W3C WebDriver specification)")
+          DEPRECATED_ERRORS[const_name]
+        else
+          WebDriver.logger.deprecate("Selenium::WebDriver::Error::#{const_name}")
+          WebDriverError
+        end
+      end
+
     end # Error
   end # WebDriver
 end # Selenium

data/lib/selenium/webdriver/common/file_reaper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -41,9 +43,7 @@ module Selenium
         def reap(file)
           return unless reap?
 
-          unless tmp_files.include?(file)
-            raise Error::WebDriverError, "file not added for reaping: #{file.inspect}"
-          end
+          raise Error::WebDriverError, "file not added for reaping: #{file.inspect}" unless tmp_files.include?(file)
 
           FileUtils.rm_rf tmp_files.delete(file)
         end

data/lib/selenium/webdriver/common/html5/local_storage.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information

data/lib/selenium/webdriver/common/html5/session_storage.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information

data/lib/selenium/webdriver/common/html5/shared_web_storage.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -30,6 +32,7 @@ module Selenium
         def fetch(key)
           return self[key] if key? key
           return yield(key) if block_given?
+
           raise KeyError, "missing key #{key.inspect}"
         end
 
@@ -40,7 +43,7 @@ module Selenium
         def each
           return enum_for(:each) unless block_given?
 
-          keys.each do |k| # rubocop:disable Performance/HashEachMethods
+          keys.each do |k|
             yield k, self[k]
           end
         end

data/lib/selenium/webdriver/common/interactions/input_device.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -30,6 +32,7 @@ module Selenium
 
         def add_action(action)
           raise TypeError, "#{action.inspect} is not a valid action" unless action.class < Interaction
+
           @actions << action
         end
 

data/lib/selenium/webdriver/common/interactions/interaction.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -25,6 +27,7 @@ module Selenium
 
         def initialize(source)
           raise TypeError, "#{source.type} is not a valid input type" unless Interactions::SOURCE_TYPES.include? source.type
+
           @source = source
         end
       end

data/lib/selenium/webdriver/common/interactions/interactions.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -13,7 +15,7 @@
 # "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 # KIND, either express or implied.  See the License for the
 # specific language governing permissions and limitations
-# under the License
+# under the License.
 
 module Selenium
   module WebDriver

data/lib/selenium/webdriver/common/interactions/key_actions.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information

data/lib/selenium/webdriver/common/interactions/key_input.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -27,6 +29,7 @@ module Selenium
 
         def encode
           return nil if no_actions?
+
           {type: type, id: name, actions: @actions.map(&:encode)}
         end
 
@@ -49,6 +52,7 @@ module Selenium
 
           def assert_type(type)
             raise TypeError, "#{type.inspect} is not a valid key subtype" unless KeyInput::SUBTYPES.key? type
+
             KeyInput::SUBTYPES[type]
           end
 

data/lib/selenium/webdriver/common/interactions/none_input.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -25,6 +27,7 @@ module Selenium
 
         def encode
           return nil if no_actions?
+
           {type: type, id: name, actions: @actions.map(&:encode)}
         end
       end # NoneInput

data/lib/selenium/webdriver/common/interactions/pointer_actions.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information

data/lib/selenium/webdriver/common/interactions/pointer_input.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -34,6 +36,7 @@ module Selenium
 
         def encode
           return nil if no_actions?
+
           output = {type: type, id: name, actions: @actions.map(&:encode)}
           output[:parameters] = {pointerType: kind}
           output
@@ -41,6 +44,7 @@ module Selenium
 
         def assert_kind(pointer)
           raise TypeError, "#{pointer.inspect} is not a valid pointer type" unless KIND.key? pointer
+
           KIND[pointer]
         end
 
@@ -78,14 +82,17 @@ module Selenium
         def assert_button(button)
           if button.is_a? Symbol
             raise TypeError, "#{button.inspect} is not a valid button!" unless BUTTONS.key? button
+
             button = BUTTONS[button]
           end
           raise ArgumentError, 'Button number cannot be negative!' unless button >= 0
+
           button
         end
 
         def assert_direction(direction)
           raise TypeError, "#{direction.inspect} is not a valid button direction" unless DIRECTIONS.key? direction
+
           DIRECTIONS[direction]
         end
 

data/lib/selenium/webdriver/common/keyboard.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -56,10 +58,11 @@ module Selenium
 
       private
 
-      MODIFIERS = [:control, :shift, :alt, :command, :meta].freeze
+      MODIFIERS = %i[control shift alt command meta].freeze
 
       def assert_modifier(key)
         return if MODIFIERS.include? key
+
         raise ArgumentError, "#{key.inspect} is not a modifier key, expected one of #{MODIFIERS.inspect}"
       end
     end # Keyboard

data/lib/selenium/webdriver/common/keys.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -110,6 +112,7 @@ module Selenium
 
       def self.[](key)
         return KEYS[key] if KEYS[key]
+
         raise Error::UnsupportedOperationError, "no such key #{key.inspect}"
       end
 

data/lib/selenium/webdriver/common/log_entry.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -28,9 +30,9 @@ module Selenium
 
       def as_json(*)
         {
-          'level'     => level,
+          'level' => level,
           'timestamp' => timestamp,
-          'message'   => message
+          'message' => message
         }
       end
 

data/lib/selenium/webdriver/common/logger.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # Licensed to the Software Freedom Conservancy (SFC) under one
 # or more contributor license agreements.  See the NOTICE file
 # distributed with this work for additional information
@@ -33,54 +35,27 @@ module Selenium
     #
     class Logger
       extend Forwardable
-      include ::Logger::Severity
 
-      def_delegators :@logger, :debug, :debug?,
+      def_delegators :@logger,
+                     :close,
+                     :debug, :debug?,
                      :info, :info?,
                      :warn, :warn?,
                      :error, :error?,
                      :fatal, :fatal?,
-                     :level
+                     :level, :level=
 
       def initialize
         @logger = create_logger($stdout)
       end
 
-      def output=(io)
-        # `Logger#reopen` was added in Ruby 2.3
-        if @logger.respond_to?(:reopen)
-          @logger.reopen(io)
-        else
-          @logger = create_logger(io)
-        end
-      end
-
       #
-      # For Ruby < 2.3 compatibility
-      # Based on https://github.com/ruby/ruby/blob/ruby_2_3/lib/logger.rb#L250
+      # Changes logger output to a new IO.
       #
-
-      def level=(severity)
-        if severity.is_a?(Integer)
-          @logger.level = severity
-        else
-          case severity.to_s.downcase
-          when 'debug'.freeze
-            @logger.level = DEBUG
-          when 'info'.freeze
-            @logger.level = INFO
-          when 'warn'.freeze
-            @logger.level = WARN
-          when 'error'.freeze
-            @logger.level = ERROR
-          when 'fatal'.freeze
-            @logger.level = FATAL
-          when 'unknown'.freeze
-            @logger.level = UNKNOWN
-          else
-            raise ArgumentError, "invalid log level: #{severity}"
-          end
-        end
+      # @param [String] io
+      #
+      def output=(io)
+        @logger.reopen(io)
       end
 
       #
@@ -95,7 +70,7 @@ module Selenium
       # @api private
       #
       def io
-        @logger.instance_variable_get(:@logdev).instance_variable_get(:@dev)
+        @logger.instance_variable_get(:@logdev).dev
       end
 
       #
@@ -105,7 +80,7 @@ module Selenium
       # @param [String, nil] new
       #
       def deprecate(old, new = nil)
-        message = "[DEPRECATION] #{old} is deprecated"
+        message = +"[DEPRECATION] #{old} is deprecated"
         message << if new
                      ". Use #{new} instead."
                    else
@@ -130,9 +105,9 @@ module Selenium
 
       def default_level
         if $DEBUG || ENV.key?('DEBUG')
-          DEBUG
+          :debug
         else
-          WARN
+          :warn
         end
       end
     end # Logger