[rb] Add backtrace locations and cause to errors

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

@@ -17,6 +17,7 @@
 # specific language governing permissions and limitations
 # under the License.
 
+require 'English'
 module Selenium
   module WebDriver
     module Error
@@ -45,11 +46,21 @@ def self.for_error(error)
       }.freeze
 
       class WebDriverError < StandardError
+        attr_writer :backtrace_locations, :cause
+
         def initialize(msg = '')
           # Remove this conditional when all the error pages have been documented
           super(URLS[class_name] ? "#{msg}; #{SUPPORT_MSG} #{URLS[class_name]}" : msg)
         end
 
+        def backtrace_locations
+          @backtrace_locations ||= Thread.current.backtrace_locations
+        end
+
+        def cause
+          @cause ||= $ERROR_INFO
+        end
+
         def class_name
           self.class.name&.split('::')&.last&.to_sym
         end
@@ -77,11 +88,7 @@ class UnknownCommandError < WebDriverError; end
       # A command failed because the referenced element is no longer attached to the DOM.
       #
 
-      class StaleElementReferenceError < WebDriverError
-        def initialize(msg = '')
-          super("#{msg}; #{SUPPORT_MSG} #{URLS[:StaleElementReferenceError]}")
-        end
-      end
+      class StaleElementReferenceError < WebDriverError; end
 
       #
       # A command failed because the referenced shadow root is no longer attached to the DOM.

rb/sig/lib/selenium/webdriver/common/error.rbs

@@ -10,6 +10,12 @@ module Selenium
       URLS: Hash[Symbol, String]
 
       class WebDriverError < StandardError
+        @backtrace_locations: Array[Thread::Backtrace::Location]?
+        @cause: Exception?
+
+        attr_writer backtrace_locations:  Array[Thread::Backtrace::Location]?
+        attr_writer cause: Exception?
+
         def class_name: -> Symbol?
       end
 

rb/spec/integration/selenium/webdriver/error_spec.rb

@@ -29,6 +29,18 @@ module WebDriver
           driver.find_element(id: 'nonexistent')
         }.to raise_error(WebDriver::Error::NoSuchElementError, /#no-such-element-exception/)
       end
+
+      it 'has backtrace locations' do
+        driver.find_element(id: 'nonexistent')
+      rescue WebDriver::Error::NoSuchElementError => e
+        expect(e.backtrace_locations).not_to be_empty
+      end
+
+      it 'has cause' do
+        driver.find_element(id: 'nonexistent')
+      rescue WebDriver::Error::NoSuchElementError => e
+        expect(e.cause).to be_a(WebDriver::Error::NoSuchElementError)
+      end
     end
   end # WebDriver
 end # Selenium