Add support for error matchers to RSpec/Dialect

Author: lovro-bikic

CHANGELOG.md

@@ -4,6 +4,7 @@
 
 - Mark `RSpec/IncludeExamples` as `SafeAutoCorrect: false`. ([@yujideveloper])
 - Fix a false positive for `RSpec/LeakyConstantDeclaration` when defining constants in explicit namespaces. ([@naveg])
+- Add support for error matchers (`raise_exception` and `raise_error`) to `RSpec/Dialect`. ([@lovro-bikic])
 
 ## 3.6.0 (2025-04-18)
 

config/default.yml

@@ -79,6 +79,9 @@ RSpec:
       - prepend_after
       - after
       - append_after
+    ErrorMatchers:
+      - raise_error
+      - raise_exception
     Includes:
       inherit_mode:
         merge:

lib/rubocop/cop/rspec/dialect.rb

@@ -21,6 +21,7 @@ module RSpec
       # - let, let!
       # - subject, subject!
       # - expect, is_expected, expect_any_instance_of
+      # - raise_error, raise_exception
       #
       # By default all of the RSpec methods and aliases are allowed. By setting
       # a config like:

lib/rubocop/rspec/language.rb

@@ -146,6 +146,12 @@ def self.all(element)
         end
       end
 
+      module ErrorMatchers # :nodoc:
+        def self.all(element)
+          Language.config['ErrorMatchers'].include?(element.to_s)
+        end
+      end
+
       module Includes # :nodoc:
         class << self
           def all(element)
@@ -201,13 +207,13 @@ def self.all(element)
       module ALL # :nodoc:
         def self.all(element)
           [ExampleGroups, Examples, Expectations, Helpers, Hooks, Includes,
-           Runners, SharedGroups, Subjects]
+           Runners, SharedGroups, Subjects, ErrorMatchers]
             .find { |concept| concept.all(element) }
         end
       end
 
       private_constant :ExampleGroups, :Examples, :Expectations, :Hooks,
-                       :Includes, :Runners, :SharedGroups, :ALL
+                       :Includes, :Runners, :SharedGroups, :ErrorMatchers, :ALL
     end
   end
 end

spec/rubocop/cop/rspec/dialect_spec.rb

@@ -73,4 +73,29 @@
       RUBY
     end
   end
+
+  context 'with error matchers config' do
+    let(:cop_config) do
+      {
+        'PreferredMethods' => {
+          'raise_exception' => 'raise_error'
+        }
+      }
+    end
+
+    it 'registers an offense for `raise_exception`' do
+      expect_offense(<<~RUBY)
+        it 'raises an error' do
+          expect { subject }.to raise_exception(StandardError)
+                                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Prefer `raise_error` over `raise_exception`.
+        end
+      RUBY
+
+      expect_correction(<<~RUBY)
+        it 'raises an error' do
+          expect { subject }.to raise_error(StandardError)
+        end
+      RUBY
+    end
+  end
 end