Merge pull request #22 from chaseconey/feat/empty-assertions

feat: add empty assertions

Author: SimoTod

README.md

@@ -67,6 +67,16 @@ $this->assertView('welcome')->in('title')->contains('Laravel');
 $this->assertView('welcome')->in('.content')->contains('Nova');
 ```
 
+### `empty`
+
+Asserts that the view has no text content.
+
+_Note: empty html nodes are not considered in this check._
+
+```php
+$this->assertView('empty')->in('.empty-div')->empty();
+```
+
 ### `first`
 
 Filters the view and returns only the first element matching the selector.

src/ViewAssertion.php

@@ -95,14 +95,32 @@ public function last(string $selector): ViewAssertion
     public function contains(string $text): ViewAssertion
     {
         Assert::assertStringContainsString(
-            (string) $text,
+            (string)$text,
             $this->html,
             "Failed asserting that the text `{$text}` exists within `{$this->html}`."
         );
 
         return $this;
     }
 
+    /**
+     * Asserts that the view, at given selector, has no content.
+     */
+    public function empty(): ViewAssertion
+    {
+        $content = "";
+        foreach ($this->crawler->getIterator() as $node) {
+            $content .= trim($node->textContent);
+        }
+
+        Assert::assertEmpty(
+            $content,
+            "Failed asserting that the text `{$content}` is empty."
+        );
+
+        return $this;
+    }
+
     /**
      * Asserts that the view, at the **root element**, contains the given attribute value.
      */

tests/AssertEmpty.php

@@ -0,0 +1,30 @@
+<?php
+
+
+namespace Tests;
+
+use NunoMaduro\LaravelMojito\InteractsWithViews;
+use PHPUnit\Framework\AssertionFailedError;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * @internal
+ */
+final class AssertEmpty extends TestCase
+{
+    use InteractsWithViews;
+
+    public function testEmpty(): void
+    {
+        $this->assertView('empty')->in('.empty-div')->empty();
+        $this->assertView('empty')->in('.empty-with-empty-nodes')->empty();
+        $this->assertView('empty')->in('.empty-with-space')->empty();
+    }
+
+    public function testNotEmpty(): void
+    {
+        $this->expectException(AssertionFailedError::class);
+
+        $this->assertView('empty')->in('.not-empty')->empty();
+    }
+}

tests/fixtures/empty.html

@@ -0,0 +1,14 @@
+<div>
+    <div class="empty-div"></div>
+    <div class="empty-with-space">
+
+    </div>
+    <div class="empty-with-empty-nodes">
+        <span></span>
+    </div>
+
+    <div class="not-empty-text">
+        <span></span>
+        Hello
+    </div>
+</div>