Exposed guessLocator via element function on Webpage class

src/Api/Webpage.php

@@ -95,6 +95,16 @@ public function value(string $selector): string
         return $this->guessLocator($selector)->inputValue();
     }
 
+    /**
+     * Get a locator for the given selector for use in custom assertions.
+     *
+     * When multiple elements match, use `->all()` to iterate or `->first()` / `->nth()` for one.
+     */
+    public function element(string $selector, ?string $value = null): Locator
+    {
+        return $this->guessLocator($selector, $value);
+    }
+
     /**
      * Gets the locator for the given selector.
      */

tests/Browser/Webpage/ElementTest.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+it('may assert text on all matching elements', function (): void {
+    Route::get('/', fn (): string => '
+        <a class="link">wow</a>
+        <a class="link">wow</a>
+        <a class="link">wow</a>
+    ');
+
+    $page = visit('/');
+
+    foreach ($page->element('.link')->all() as $element) {
+        expect($element->textContent())->toBe('wow');
+    }
+});
+
+it('may assert text on the first matching element', function (): void {
+    Route::get('/', fn (): string => '
+        <a class="link">wow</a>
+        <a class="link">other</a>
+    ');
+
+    $page = visit('/');
+
+    expect($page->element('.link')->first()->textContent())->toBe('wow');
+});