BaseTestCase route helpers: web root paths, optional placeholders, no-app error

[lmajano]

Description

Follow-up to #708 from the release review of the browser testing route helpers.

• Web root paths. routeURL(), visitRoute() and assertRouteIs() included the app mapping (/root/users/5/) once a request had run, because the routing base URL uses appMapping when webMapping is empty. The appMapping is a mapping, not a web path, so the helpers now drop it. When an app is served from a sub folder, webMapping keeps the base path.
• Optional placeholders. With params, /posts/:id? resolved to the base route (findRouteByName keeps the last one) and dropped the param. The helpers now pick the longest variant the params fill. A root route gives /, not //.
• No app loaded. The helpers throw BaseTestCase.NoColdBoxApp with a clear message. A module that is not loaded throws InvalidArgumentException.
• assertRouteIs() rethrows unexpected errors unchanged and reports an invalid page URL as is. The docblocks are corrected.

Jira Issues

Follow-up to the bx-playwright browser testing ticket shipped with #708.

Type of change

• Bug Fix
• This change requires a documentation update (coldbox-docs PR Format detection from accepts header & redirect event on HTML events with multiple formats #301)

Checklist

• My code follows the style guidelines of this project cfformat
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

Tests, BoxLang 1.17 test server:

• tests.specs.browser: 20/20, including the in-browser specs. Before the fix, 4 of the new specs fail and 1 errors.
• tests.specs.integration: 97/97.
• tests.specs.web.routing: 168/168.

🤖 Generated with Claude Code

https://claude.ai/code/session_01UU9aLossoYUkQNwubnitBi

---

Generated by Claude Code

[github-actions]

Test Results

0 tests  ±0   0 ✅ ±0   0s ⏱️ ±0s
0 suites ±0   0 💤 ±0 
0 files   ±0   0 ❌ ±0 

Results for commit 9b80c26. ± Comparison against base commit 8dbc946.

[github-actions]

Test Results

0 tests  ±0   0 ✅ ±0   0s ⏱️ ±0s
0 suites ±0   0 💤 ±0 
0 files   ±0   0 ❌ ±0 

Results for commit 14b35b0. ± Comparison against base commit 8dbc946.

♻️ This comment has been updated with latest results.

[lmajano]

CI notes:

• Checks Source Code Formatting: fixed in 14b35b0 (wrapping of the new route helper calls and @throws alignment). It is green now.

• Adobe 2023 / 2025 test suites: they fail on one spec, ModuleServiceTest "Module Lifecycle: Still resolves a handler-only URL for a module with only a mandatory-action route" (test-module-conventions is not loaded). This is not this PR's:

  • this PR does not touch module loading;
  • development (8dbc946) fails the same way on Adobe 2023 (907 tests, 1 failed);
  • on 9b80c26, one workflow run passed both Adobe suites while the other failed.

  No fix exists yet; it is the known intermittent Module Lifecycle spec.

---

Generated by Claude Code