Merge branch 'jmd/add-negatable-for-be-mergeable' into 'master'

[E2E] Add RSpec Matcher for be_mergeable

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/127064



Merged-by: Chloe Liu <yliu@gitlab.com>
Approved-by: Chloe Liu <yliu@gitlab.com>
Approved-by: Will Meek <wmeek@gitlab.com>
Reviewed-by: Chloe Liu <yliu@gitlab.com>
Co-authored-by: John McDonnell <jmcdonnell@gitlab.com>

qa/qa/page/merge_request/show.rb

@@ -310,13 +310,14 @@ def merged?
           end
         end
 
-        # Check if the MR is able to be merged
-        # Waits up 10 seconds and returns false if the MR can't be merged
-        def mergeable?
-          # The merge button is enabled via JS, but `has_element?` calls
-          # `wait_for_requests`, which should ensure the disabled/enabled
-          # state of the element is reliable
-          has_element?(:merge_button, disabled: false)
+        RSpec::Matchers.define :be_mergeable do
+          match do |page|
+            page.has_element?(:merge_button, disabled: false)
+          end
+
+          match_when_negated do |page|
+            page.has_no_element?(:merge_button, disabled: false)
+          end
         end
 
         # Waits up 10 seconds and returns false if the Revert button is not enabled