Document changes in cakephp/cakephp#17856

cakephp · Aug 22, 2024 · 504af6a · 504af6a
1 parent bd0d2c8
commit 504af6a
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 1 deletion.
diff --git a/en/appendices/5-1-migration-guide.rst b/en/appendices/5-1-migration-guide.rst
@@ -138,6 +138,7 @@ TestSuite
   its methods were updated to be static.
 - ``LogTestTrait`` was added. This new trait makes it easy to capture logs in
   your tests and make assertions on the presence or absence of log messages.
+- ``IntegrationTestTrait::replaceRequest()`` was added.
 
 Utility
 -------

diff --git a/en/development/testing.rst b/en/development/testing.rst
@@ -1098,13 +1098,22 @@ to configure the requests you will send to your application under test::
     // Set session data
     $this->session(['Auth.User.id' => 1]);
 
-    // Configure headers
+    // Configure headers and merge with the existing request
     $this->configRequest([
         'headers' => ['Accept' => 'application/json']
     ]);
 
+    // Replace the existing request. Added in 5.1.0
+    $this->replaceRequest([
+        'headers' => ['Accept' => 'application/json']
+    ]);
+
+
 The state set by these helper methods is reset in the ``tearDown()`` method.
 
+.. versionadded:: 5.1.0
+    ``replaceRequest()`` was added.
+
 Testing Actions Protected by CsrfComponent or SecurityComponent
 ---------------------------------------------------------------