From badca8a6188d601aa6006e85528074f7eff43890 Mon Sep 17 00:00:00 2001
From: Paul Holden <paulh@moodle.com>
Date: Thu, 11 Dec 2025 17:31:11 +0000
Subject: [PATCH] MDL-87443 behat: define new Toast message named selector.

---
 .upgradenotes/MDL-87443-2025121117305654.yml        | 7 +++++++
 public/lib/behat/classes/partial_named_selector.php | 4 ++++
 2 files changed, 11 insertions(+)
 create mode 100644 .upgradenotes/MDL-87443-2025121117305654.yml

diff --git a/.upgradenotes/MDL-87443-2025121117305654.yml b/.upgradenotes/MDL-87443-2025121117305654.yml
new file mode 100644
index 00000000000..0456305686b
--- /dev/null
+++ b/.upgradenotes/MDL-87443-2025121117305654.yml
@@ -0,0 +1,7 @@
+issueNumber: MDL-87443
+notes:
+  core:
+    - message: >-
+        There is a new Behat `toast_message` named selector to more easily
+        assert the presence of Toast messages on the page
+      type: improved
diff --git a/public/lib/behat/classes/partial_named_selector.php b/public/lib/behat/classes/partial_named_selector.php
index c4498928dbc..4095d5787e6 100644
--- a/public/lib/behat/classes/partial_named_selector.php
+++ b/public/lib/behat/classes/partial_named_selector.php
@@ -127,6 +127,7 @@ class behat_partial_named_selector extends \Behat\Mink\Selector\PartialNamedSele
         'table' => 'table',
         'table_row' => 'table_row',
         'text' => 'text',
+        'toast_message' => 'toast_message',
         'xpath_element' => 'xpath_element',
         'form_row' => 'form_row',
         'autocomplete_selection' => 'autocomplete_selection',
@@ -279,6 +280,9 @@ XPATH
 XPATH
         , 'text' => <<<XPATH
 .//*[contains(., %locator%) and not(.//*[contains(., %locator%)])]
+XPATH
+    , 'toast_message' => <<<XPATH
+        .//*[contains(concat(' ', normalize-space(@class), ' '), ' toast-message ') and %exactTagTextMatch%]
 XPATH
         , 'form_row' => <<<XPATH
 .//*[contains(concat(' ', @class, ' '), ' col-form-label ')]