[2.x] Add ddContent method (#44)

Author: jackbayliss

README.md

@@ -204,6 +204,16 @@ $this->get('/some-route')
     ->assertDoesntExist('div.not-here');
 ```
 
+While using either `assertContainsElement` or `assertDoesntExist` you can use the `ddContent` method to dump the content of the page to aid with debugging
+```
+$this->blade('<x-some-blade>')
+    ->assertContainsElement('#content')
+    ->ddContent();`
+```
+
+> [!TIP]
+> Because this method is shared across the Test macros (response, view and component), it's technically available anywhere.
+
 ### Testing forms
 Testing forms allows using all the dom asserts from above, but has a few special helpers to help test for forms.
 Instead of using `->assertElementExists()` you can use `->assertFormExists()`, or the alias `assertForm()` on the test response.

ide-helper.php

@@ -56,6 +56,8 @@ public function assertDoesntExist($selector)
             /** @var \Illuminate\Testing\TestResponse $instance */
             return $instance;
         }
+
+        public function ddContent(): void {}
     }
 
     class TestView
@@ -113,6 +115,8 @@ public function assertDoesntExist($selector)
             /** @var \Illuminate\Testing\TestView $instance */
             return $instance;
         }
+
+        public function ddContent(): void {}
     }
 
     class TestComponent
@@ -170,5 +174,7 @@ public function assertDoesntExist($selector)
             /** @var \Illuminate\Testing\TestComponent $instance */
             return $instance;
         }
+
+        public function ddContent(): void {}
     }
 }

src/TestComponentMacros.php

@@ -280,4 +280,12 @@ public function assertSelectExists(): Closure
             return $this;
         };
     }
+
+    public function ddContent(): Closure
+    {
+        return function (): void {
+            /** @var TestComponent $this */
+            dd((string) $this);
+        };
+    }
 }

src/TestResponseMacros.php

@@ -280,4 +280,12 @@ public function assertSelectExists(): Closure
             return $this;
         };
     }
+
+    public function ddContent(): Closure
+    {
+        return function (): void {
+            /** @var TestResponse $this */
+            dd($this->getContent());
+        };
+    }
 }

src/TestViewMacros.php

@@ -281,4 +281,12 @@ public function assertSelectExists(): Closure
             return $this;
         };
     }
+
+    public function ddContent(): Closure
+    {
+        return function (): void {
+            /** @var TestView $this */
+            dd((string) $this);
+        };
+    }
 }