feat: accept many selectors in assertSeeIn() and assertNotSeeIn()

README.md

@@ -153,6 +153,10 @@ $browser
     ->assertNotSee('some text')
     ->assertSeeIn('h1', 'some text')
     ->assertNotSeeIn('h1', 'some text')
+
+    // pass many selectors to check the same text in each of them
+    ->assertSeeIn(['title', 'h1'], 'some text')
+    ->assertNotSeeIn(['title', 'h1'], 'some text')
     ->assertSeeElement('h1')
     ->assertNotSeeElement('h1')
     ->assertElementCount('ul li', 2)

src/Browser.php

@@ -149,21 +149,29 @@ final public function assertNotSee(string $expected): self
     }
 
     /**
+     * @param string|iterable<string> $selector One or many css selectors, all of which must contain the text
+     *
      * @return static
      */
-    final public function assertSeeIn(string $selector, string $expected): self
+    final public function assertSeeIn(string|iterable $selector, string $expected): self
     {
-        $this->session()->assert()->elementTextContains('css', $selector, $expected);
+        foreach (self::normalizeSelectors($selector) as $css) {
+            $this->session()->assert()->elementTextContains('css', $css, $expected);
+        }
 
         return $this;
     }
 
     /**
+     * @param string|iterable<string> $selector One or many css selectors, none of which may contain the text
+     *
      * @return static
      */
-    final public function assertNotSeeIn(string $selector, string $expected): self
+    final public function assertNotSeeIn(string|iterable $selector, string $expected): self
     {
-        $this->session()->assert()->elementTextNotContains('css', $selector, $expected);
+        foreach (self::normalizeSelectors($selector) as $css) {
+            $this->session()->assert()->elementTextNotContains('css', $css, $expected);
+        }
 
         return $this;
     }
@@ -879,4 +887,14 @@ private function securityToken(): ?TokenInterface
 
         return $container->get('security.token_storage')->getToken();
     }
+
+    /**
+     * @param string|iterable<string> $selector
+     *
+     * @return iterable<string>
+     */
+    private static function normalizeSelectors(string|iterable $selector): iterable
+    {
+        return \is_string($selector) ? [$selector] : $selector;
+    }
 }

tests/BrowserTests.php

@@ -934,6 +934,35 @@ public function html_assertions(): void
         ;
     }
 
+    /**
+     * @test
+     */
+    #[Test]
+    public function see_in_assertions_accept_many_selectors(): void
+    {
+        $this->browser()
+            ->visit('/page1')
+            ->assertSeeIn(['h1', 'body'], 'h1 title')
+            ->assertNotSeeIn(['h1', 'title'], 'invalid text')
+        ;
+
+        // every selector must match, so one that does not fails the assertion
+        Assert::that(function() {
+            $this->browser()
+                ->visit('/page1')
+                ->assertSeeIn(['h1', 'title'], 'h1 title')
+            ;
+        })->throws(AssertionFailedError::class);
+
+        // and none may match for the negative one
+        Assert::that(function() {
+            $this->browser()
+                ->visit('/page1')
+                ->assertNotSeeIn(['title', 'h1'], 'h1 title')
+            ;
+        })->throws(AssertionFailedError::class);
+    }
+
     /**
      * @test
      */