feat: add empty assertions

Author: chaseconey

src/ViewAssertion.php

@@ -95,14 +95,40 @@ 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, is empty.
+     */
+    public function empty(): ViewAssertion
+    {
+        Assert::assertEmpty(
+            $this->crawler->html(),
+            "Failed asserting that the text `{$this->crawler->html()}` is empty."
+        );
+
+        return $this;
+    }
+
+    /**
+     * Asserts that the view, at given selector, is not empty.
+     */
+    public function notEmpty(): ViewAssertion
+    {
+        Assert::assertNotEmpty(
+            $this->crawler->html(),
+            "Failed asserting that the text `{$this->crawler->html()}` is not empty."
+        );
+
+        return $this;
+    }
+
     /**
      * Asserts that the view, at the **root element**, contains the given attribute value.
      */

tests/AssertEmpty.php

@@ -0,0 +1,28 @@
+<?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();
+    }
+
+    public function testNotEmpty(): void
+    {
+        $this->expectException(AssertionFailedError::class);
+
+        $this->assertView('button')->in('.btn')->empty();
+    }
+}

tests/AssertNotEmpty.php

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

tests/fixtures/empty.html

@@ -0,0 +1,3 @@
+<div>
+    <div class="empty-div"></div>
+</div>