Raise Ransack::InvalidSearchError instead of ArgumentError on unknown conditions

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## Unreleased
 * Rails 8 compatibility
 * Drop Rails 6 and 7.0 compatibility
+* Raise Ransack::InvalidSearchError instead of ArgumentError on unknown conditions
 
 ## 4.2.1 - 2024-8-11
 

docs/docs/going-further/other-notes.md

@@ -263,15 +263,15 @@ end
 
 ```ruby
 Article.ransack(unknown_attr_eq: 'Ernie')
-# ArgumentError (Invalid search term unknown_attr_eq)
+# Ransack::InvalidSearchError (Invalid search term unknown_attr_eq)
 ```
 
 As an alternative to setting a global configuration option, the `.ransack!`
 class method also raises an error if passed an unknown condition:
 
 ```ruby
 Article.ransack!(unknown_attr_eq: 'Ernie')
-# ArgumentError: Invalid search term unknown_attr_eq
+# Ransack::InvalidSearchError: Invalid search term unknown_attr_eq
 ```
 
 This is equivalent to the `ignore_unknown_conditions` configuration option,

lib/ransack/invalid_search_error.rb

@@ -0,0 +1,3 @@
+module Ransack
+  class InvalidSearchError < ArgumentError; end
+end

lib/ransack/nodes/condition.rb

@@ -1,3 +1,5 @@
+require 'ransack/invalid_search_error'
+
 module Ransack
   module Nodes
     class Condition < Node
@@ -38,7 +40,7 @@ def extract_values_for_condition(key, context = nil)
             predicate = Predicate.named(name)
 
             unless predicate || Ransack.options[:ignore_unknown_conditions]
-              raise ArgumentError, "No valid predicate for #{key}"
+              raise InvalidSearchError, "No valid predicate for #{key}"
             end
 
             if context.present?

lib/ransack/search.rb

@@ -7,6 +7,7 @@
 require 'ransack/nodes/grouping'
 require 'ransack/context'
 require 'ransack/naming'
+require 'ransack/invalid_search_error'
 
 module Ransack
   class Search
@@ -53,7 +54,7 @@ def build(params)
         elsif base.attribute_method?(key)
           base.send("#{key}=", value)
         elsif !Ransack.options[:ignore_unknown_conditions] || !@ignore_unknown_conditions
-          raise ArgumentError, "Invalid search term #{key}"
+          raise InvalidSearchError, "Invalid search term #{key}"
         end
       end
       self
@@ -78,7 +79,7 @@ def sorts=(args)
       when String
         self.sorts = [args]
       else
-        raise ArgumentError,
+        raise InvalidSearchError,
         "Invalid argument (#{args.class}) supplied to sorts="
       end
     end

spec/ransack/adapters/active_record/base_spec.rb

@@ -131,10 +131,14 @@ module ActiveRecord
             expect { Person.ransack('') }.to_not raise_error
           end
 
-          it 'raises exception if ransack! called with unknown condition' do
+          it 'raises ArgumentError exception if ransack! called with unknown condition' do
             expect { Person.ransack!(unknown_attr_eq: 'Ernie') }.to raise_error(ArgumentError)
           end
 
+          it 'raises InvalidSearchError exception if ransack! called with unknown condition' do
+            expect { Person.ransack!(unknown_attr_eq: 'Ernie') }.to raise_error(InvalidSearchError)
+          end
+
           it 'does not modify the parameters' do
             params = { name_eq: '' }
             expect { Person.ransack(params) }.not_to change { params }

spec/ransack/nodes/condition_spec.rb

@@ -64,6 +64,7 @@ module Nodes
           end
 
           specify { expect { subject }.to raise_error ArgumentError }
+          specify { expect { subject }.to raise_error InvalidSearchError }
         end
 
         context "when ignore_unknown_conditions is true" do

spec/ransack/search_spec.rb

@@ -270,6 +270,7 @@ module Ransack
           end
 
           specify { expect { subject }.to raise_error ArgumentError }
+          specify { expect { subject }.to raise_error InvalidSearchError }
         end
 
         context 'when ignore_unknown_conditions configuration option is true' do
@@ -300,6 +301,7 @@ module Ransack
 
         context 'when ignore_unknown_conditions search parameter is false' do
           specify { expect { with_ignore_unknown_conditions_false }.to raise_error ArgumentError }
+          specify { expect { with_ignore_unknown_conditions_false }.to raise_error InvalidSearchError }
         end
 
         context 'when ignore_unknown_conditions search parameter is true' do
@@ -614,6 +616,18 @@ def remove_quotes_and_backticks(str)
         expect(@s.result.first.id).to eq 1
       end
 
+      it 'raises ArgumentError when an invalid argument is sent' do
+        expect do
+          @s.sorts = 1234
+        end.to raise_error(ArgumentError,  "Invalid argument (Integer) supplied to sorts=")
+      end
+
+      it 'raises InvalidSearchError when an invalid argument is sent' do
+        expect do
+          @s.sorts = 1234
+        end.to raise_error(Ransack::InvalidSearchError,  "Invalid argument (Integer) supplied to sorts=")
+      end
+
       it "PG's sort option", if: ::ActiveRecord::Base.connection.adapter_name == "PostgreSQL" do
         default = Ransack.options.clone