Add assertDoesntExist method (#42)

Author: jackbayliss

README.md

@@ -193,12 +193,15 @@ $this->get('/some-route')
 ```
 
 
-For simple and quick checks, you can use `assertContainsElement`. 
-This method allows you to verify that a specific element exists on the page you can optionally include an array of expected attributes.
+For simple and quick checks, you can use  `assertContainsElement` or `assertDoesntExist` 
+These methods allow you to verify that a specific element exists on the page.
+
+`assertContainsElement` optionally allows an array of expected attributes
 ```
 $this->get('/some-route')
     ->assertContainsElement('#content')
-    ->assertContainsElement('div.banner', ['text' => 'Successfully deleted', 'data-status' => 'success']);
+    ->assertContainsElement('div.banner', ['text' => 'Successfully deleted', 'data-status' => 'success'])
+    ->assertDoesntExist('div.not-here');
 ```
 
 ### Testing forms

ide-helper.php

@@ -50,6 +50,12 @@ public function assertContainsElement($selector, array $attributes = [])
             /** @var \Illuminate\Testing\TestResponse $instance */
             return $instance;
         }
+
+        public function assertDoesntExist($selector)
+        {
+            /** @var \Illuminate\Testing\TestResponse $instance */
+            return $instance;
+        }
     }
 
     class TestView
@@ -101,6 +107,12 @@ public function assertContainsElement($selector, array $attributes = [])
             /** @var \Illuminate\Testing\TestView $instance */
             return $instance;
         }
+
+        public function assertDoesntExist($selector)
+        {
+            /** @var \Illuminate\Testing\TestView $instance */
+            return $instance;
+        }
     }
 
     class TestComponent
@@ -152,5 +164,11 @@ public function assertContainsElement($selector, array $attributes = [])
             /** @var \Illuminate\Testing\TestComponent $instance */
             return $instance;
         }
+
+        public function assertDoesntExist($selector)
+        {
+            /** @var \Illuminate\Testing\TestComponent $instance */
+            return $instance;
+        }
     }
 }

src/TestComponentMacros.php

@@ -157,6 +157,34 @@ public function assertContainsElement(): Closure
         };
     }
 
+    public function assertDoesntExist(): Closure
+    {
+        return function (string $selector): TestComponent {
+            /** @var TestComponent $this */
+            Assert::assertNotEmpty(
+                (string) $this,
+                'The component is empty!'
+            );
+
+            try {
+                if (! app()->has('dom-assertions.parser')) {
+                    app()->instance('dom-assertions.parser', DomParser::new((string) $this));
+                }
+            } catch (DOMException $exception) {
+                Assert::fail($exception->getMessage());
+            }
+
+            $element = app()->make('dom-assertions.parser')->query($selector);
+
+            Assert::assertNull(
+                $element,
+                sprintf('Expected no element with selector: %s, but one was found.', $selector)
+            );
+
+            return $this;
+        };
+    }
+
     public function assertForm(): Closure
     {
         return $this->assertFormExists();

src/TestResponseMacros.php

@@ -157,6 +157,34 @@ public function assertContainsElement(): Closure
         };
     }
 
+    public function assertDoesntExist(): Closure
+    {
+        return function (string $selector): TestResponse {
+            /** @var TestResponse $this */
+            Assert::assertNotEmpty(
+                (string) $this->getContent(),
+                'The view is empty!'
+            );
+
+            try {
+                if (! app()->has('dom-assertions.parser')) {
+                    app()->instance('dom-assertions.parser', DomParser::new($this->getContent()));
+                }
+            } catch (DOMException $exception) {
+                Assert::fail($exception->getMessage());
+            }
+
+            $element = app()->make('dom-assertions.parser')->query($selector);
+
+            Assert::assertNull(
+                $element,
+                sprintf('Expected no element with selector: %s, but one was found.', $selector)
+            );
+
+            return $this;
+        };
+    }
+
     public function assertForm(): Closure
     {
         return $this->assertFormExists();

src/TestViewMacros.php

@@ -158,6 +158,34 @@ public function assertContainsElement(): Closure
         };
     }
 
+    public function assertDoesntExist(): Closure
+    {
+        return function (string $selector): TestView {
+            /** @var TestView $this */
+            Assert::assertNotEmpty(
+                (string) $this,
+                'The view is empty!'
+            );
+
+            try {
+                if (! app()->has('dom-assertions.parser')) {
+                    app()->instance('dom-assertions.parser', DomParser::new((string) $this));
+                }
+            } catch (DOMException $exception) {
+                Assert::fail($exception->getMessage());
+            }
+
+            $element = app()->make('dom-assertions.parser')->query($selector);
+
+            Assert::assertNull(
+                $element,
+                sprintf('Expected no element with selector: %s, but one was found.', $selector)
+            );
+
+            return $this;
+        };
+    }
+
     public function assertForm(): Closure
     {
         return $this->assertFormExists();

tests/ComponentTest.php

@@ -26,7 +26,13 @@
         });
 });
 
-it('assertContainsElement works as expects', function () {
+it('assertDoesntExist works as expected', function () {
+    $this->component(NestedComponent::class)
+        ->assertDoesntExist('span.fake')
+        ->assertDoesntExist('nav.fake');
+});
+
+it('assertContainsElement works as expected', function () {
     $this->component(NestedComponent::class)
         ->assertContainsElement('span.foo', ['text' => 'Foo', 'class' => 'bar foo'])
         ->assertContainsElement('nav');

tests/DomTest.php

@@ -10,7 +10,13 @@
         });
 });
 
-it('assertContainsElement works as expects', function () {
+it('assertDoesntExist works as expected', function () {
+    $this->get('nesting')
+        ->assertDoesntExist('span.fake')
+        ->assertDoesntExist('nav.fake');
+});
+
+it('assertContainsElement works as expected', function () {
     $this->get('nesting')
         ->assertContainsElement('span.foo', ['text' => 'Foo', 'class' => 'bar foo'])
         ->assertContainsElement('nav');

tests/ViewTest.php

@@ -3,7 +3,13 @@
 use PHPUnit\Framework\AssertionFailedError;
 use Sinnbeck\DomAssertions\Asserts\AssertElement;
 
-it('assertContainsElement works as expects', function () {
+it('assertDoesntExist works as expected', function () {
+    $this->get('nesting')
+        ->assertDoesntExist('span.fake')
+        ->assertDoesntExist('nav.fake');
+});
+
+it('assertContainsElement works as expected', function () {
     $this->view('nesting')
         ->assertContainsElement('span.foo', ['text' => 'Foo'])
         ->assertContainsElement('nav');