Add seeCurrentPathEquals method to ignore query strings (#5435)

* Add seeCurrentPathEquals method to ignore query strings

Adds new assertion method to check URL path equality while ignoring
query parameters and URL fragments.

- I.seeCurrentPathEquals('/info') passes for '/info?user=1', '/info#section'
- I.seeCurrentPathEquals('/') passes for '/', '/?user=ok', '/#top'

Implemented in Playwright, Puppeteer, and WebDriver helpers using native
URL class for pathname extraction.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add dontSeeCurrentPathEquals method for negative path assertions

Adds the negative counterpart to seeCurrentPathEquals for checking
that URL paths do not match, ignoring query strings and fragments.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Refactor WebDriver seeCurrentPathEquals to use equals().assert/negate pattern

Aligns WebDriver.js implementation with Playwright.js and Puppeteer.js
by using the consistent `equals('url path').assert()` and `.negate()`
pattern instead of custom assert.equal and manual error throwing.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Fix test router to handle query strings in URL paths

Changed glue.php router to strip query strings from REQUEST_URI before
matching route patterns. This fixes 500 errors when accessing URLs
like /info?user=test because the regex pattern ^/info/?$ didn't
match /info?user=test.

Changed from:
  $path = $_SERVER['REQUEST_URI'];
To:
  $path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: DavertMik <davert@testomat.io>
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: 3 people

docs/webapi/dontSeeCurrentPathEquals.mustache

@@ -0,0 +1,10 @@
+Checks that current URL path does NOT match the expected path.
+Query strings and URL fragments are ignored.
+
+```js
+I.dontSeeCurrentPathEquals('/form'); // fails for '/form', '/form?user=1', '/form#section'
+I.dontSeeCurrentPathEquals('/'); // fails for '/', '/?user=ok', '/#top'
+```
+
+@param {string} path value to check.
+@returns {void} automatically synchronized promise through #recorder

docs/webapi/seeCurrentPathEquals.mustache

@@ -0,0 +1,10 @@
+Checks that current URL path matches the expected path.
+Query strings and URL fragments are ignored.
+
+```js
+I.seeCurrentPathEquals('/info'); // passes for '/info', '/info?user=1', '/info#section'
+I.seeCurrentPathEquals('/'); // passes for '/', '/?user=ok', '/#top'
+```
+
+@param {string} path value to check.
+@returns {void} automatically synchronized promise through #recorder

lib/helper/Playwright.js

@@ -2405,6 +2405,26 @@ class Playwright extends Helper {
     urlEquals(this.options.url).negate(url, await this._getPageUrl())
   }
 
+  /**
+   * {{> seeCurrentPathEquals }}
+   */
+  async seeCurrentPathEquals(path) {
+    const currentUrl = await this._getPageUrl()
+    const baseUrl = this.options.url || 'http://localhost'
+    const actualPath = new URL(currentUrl, baseUrl).pathname
+    return equals('url path').assert(path, actualPath)
+  }
+
+  /**
+   * {{> dontSeeCurrentPathEquals }}
+   */
+  async dontSeeCurrentPathEquals(path) {
+    const currentUrl = await this._getPageUrl()
+    const baseUrl = this.options.url || 'http://localhost'
+    const actualPath = new URL(currentUrl, baseUrl).pathname
+    return equals('url path').negate(path, actualPath)
+  }
+
   /**
    * {{> see }}
    *

lib/helper/Puppeteer.js

@@ -1684,6 +1684,26 @@ class Puppeteer extends Helper {
     urlEquals(this.options.url).negate(url, await this._getPageUrl())
   }
 
+  /**
+   * {{> seeCurrentPathEquals }}
+   */
+  async seeCurrentPathEquals(path) {
+    const currentUrl = await this._getPageUrl()
+    const baseUrl = this.options.url || 'http://localhost'
+    const actualPath = new URL(currentUrl, baseUrl).pathname
+    return equals('url path').assert(path, actualPath)
+  }
+
+  /**
+   * {{> dontSeeCurrentPathEquals }}
+   */
+  async dontSeeCurrentPathEquals(path) {
+    const currentUrl = await this._getPageUrl()
+    const baseUrl = this.options.url || 'http://localhost'
+    const actualPath = new URL(currentUrl, baseUrl).pathname
+    return equals('url path').negate(path, actualPath)
+  }
+
   /**
    * {{> see }}
    *

lib/helper/WebDriver.js

@@ -1844,6 +1844,26 @@ class WebDriver extends Helper {
     return urlEquals(this.options.url).negate(url, decodeUrl(res))
   }
 
+  /**
+   * {{> seeCurrentPathEquals }}
+   */
+  async seeCurrentPathEquals(path) {
+    const currentUrl = await this.browser.getUrl()
+    const baseUrl = this.options.url || 'http://localhost'
+    const actualPath = new URL(currentUrl, baseUrl).pathname
+    return equals('url path').assert(path, actualPath)
+  }
+
+  /**
+   * {{> dontSeeCurrentPathEquals }}
+   */
+  async dontSeeCurrentPathEquals(path) {
+    const currentUrl = await this.browser.getUrl()
+    const baseUrl = this.options.url || 'http://localhost'
+    const actualPath = new URL(currentUrl, baseUrl).pathname
+    return equals('url path').negate(path, actualPath)
+  }
+
   /**
    * Wraps [execute](http://webdriver.io/api/protocol/execute.html) command.
    *

test/data/app/glue.php

@@ -44,7 +44,7 @@ class glue {
         static function stick ($urls) {
 
             $method = strtoupper($_SERVER['REQUEST_METHOD']);
-            $path = $_SERVER['REQUEST_URI'];
+            $path = parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH);
 
             $found = false;
 

test/helper/webapi.js

@@ -75,6 +75,45 @@ export function tests() {
       const url = await I.grabCurrentUrl()
       assert.equal(url, `${siteUrl}/info`)
     })
+
+    it('should check for equality with query strings', async () => {
+      await I.amOnPage('/info?user=test')
+      // Query strings matter for exact equality
+      await I.seeCurrentUrlEquals('/info?user=test')
+      await I.dontSeeCurrentUrlEquals('/info')
+      // But substring check works
+      await I.seeInCurrentUrl('/info')
+      await I.seeInCurrentUrl('user=test')
+    })
+
+    it('should handle root path with query strings', async () => {
+      await I.amOnPage('/?user=ok')
+      // Query strings matter - exact equality requires query string
+      await I.seeCurrentUrlEquals('/?user=ok')
+      await I.dontSeeCurrentUrlEquals('/')
+      // But substring check works for path fragment
+      await I.seeInCurrentUrl('/')
+    })
+
+    it('should check path equality ignoring query strings', async () => {
+      await I.amOnPage('/info?user=test')
+      // Path equality ignores query strings
+      await I.seeCurrentPathEquals('/info')
+      await I.dontSeeCurrentPathEquals('/form')
+      await I.dontSeeCurrentPathEquals('/info?user=test')
+    })
+
+    it('should check root path equality ignoring query strings', async () => {
+      await I.amOnPage('/?user=ok')
+      await I.seeCurrentPathEquals('/')
+      await I.dontSeeCurrentPathEquals('/info')
+    })
+
+    it('should check path equality ignoring hash fragments', async () => {
+      await I.amOnPage('/info#section')
+      await I.seeCurrentPathEquals('/info')
+      await I.dontSeeCurrentPathEquals('/info#section')
+    })
   })
 
   describe('#waitInUrl, #waitUrlEquals', () => {