Add assertVisible and assertMissing assertions

README.md

@@ -70,6 +70,8 @@ Pause the test for the specified number of milliseconds.
 - [assertPresent](#assertpresent)
 - [assertNotPresent](#assertnotpresent)
 - [assertScript](#assertscript)
+- [assertVisible](#assertvisible)
+- [assertMissing](#assertmissing)
 
 #### assertAttribute
 
@@ -107,6 +109,31 @@ $this->visit($url)
     ->assertDontSee('we are a streaming service');
 ```
 
+#### assertVisible
+
+Assert that an element with the given selector is visible:
+
+```php
+test('assert visible', function () {
+    $url = 'https://laravel.com';
+
+    $this->visit($url)
+        ->assertVisible('h1:visible');
+});
+```
+
+#### assertMissing
+
+Assert that an element with the given selector is hidden:
+
+```php
+test('assert missing', function () {
+    $url = 'https://laravel.com';
+
+    $this->visit($url)
+        ->assertMissing('a.hidden');
+```
+
 #### assertQueryStringHas
 
 Assert that the given query string is present in the url:

src/Operations/AssertMissing.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pest\Browser\Operations;
+
+use Pest\Browser\Contracts\Operation;
+
+final class AssertMissing implements Operation
+{
+    /**
+     * Creates an operation instance.
+     */
+    public function __construct(
+        private string $selector,
+    ) {
+        //
+    }
+
+    /**
+     * Compile the operation.
+     */
+    public function compile(): string
+    {
+        $escapedSelector = str_replace("'", "\'", $this->selector);
+
+        return "await expect(page.locator('{$escapedSelector}')).toBeHidden();";
+    }
+}

src/Operations/AssertVisible.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pest\Browser\Operations;
+
+use Pest\Browser\Contracts\Operation;
+
+final class AssertVisible implements Operation
+{
+    /**
+     * Creates an operation instance.
+     */
+    public function __construct(
+        private string $selector,
+    ) {
+        //
+    }
+
+    /**
+     * Compile the operation.
+     */
+    public function compile(): string
+    {
+        $escapedSelector = str_replace("'", "\'", $this->selector);
+
+        return "await expect(page.locator('{$escapedSelector}')).toBeVisible();";
+    }
+}

src/PendingTest.php

@@ -241,7 +241,7 @@
     /**
      * Checks if the given script returns the expected value.
      */
     public function assertScript(string $expression, array|bool|float|int|null|string $expected): self
     {
         $this->operations[] = new Operations\AssertScript($expression, $expected);
 
@@ -274,6 +274,26 @@
         return $this;
     }
 
+    /**
+     * Checks if the given element is visible.
+     */
+    public function assertVisible(string $selector): self
+    {
+        $this->operations[] = new Operations\AssertVisible($selector);
+
+        return $this;
+    }
+
+    /**
+     * Checks if the given element is not visible.
+     */
+    public function assertMissing(string $selector): self
+    {
+        $this->operations[] = new Operations\AssertMissing($selector);
+
+        return $this;
+    }
+
     /**
      * Compile the JavaScript test file.
      */

tests/Browser/Operations/AssertMissingTest.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+use Symfony\Component\Process\Exception\ProcessFailedException;
+
+describe('assert missing', function () {
+    it('passes when the given element is not visible', function () {
+        $this->visit('https://laravel.com')
+            ->assertMissing('.DocSearch-Button-Keys');
+    });
+
+    it('fails when the given element is visible', function () {
+        $this->visit('https://laravel.com')
+            ->assertMissing('body');
+    })->throws(ProcessFailedException::class);
+});

tests/Browser/Operations/AssertVisibleTest.php

@@ -0,0 +1,17 @@
+<?php
+
+declare(strict_types=1);
+
+use Symfony\Component\Process\Exception\ProcessFailedException;
+
+describe('assert visible', function () {
+    it('passes when the given element is visible', function () {
+        $this->visit('https://laravel.com')
+            ->assertVisible('body');
+    });
+
+    it('fails when the given element is not visible', function () {
+        $this->visit('https://laravel.com')
+            ->assertVisible('.DocSearch-Button-Keys');
+    })->throws(ProcessFailedException::class);
+});