feat: add requestWith*URL utils and use for faster mounts

[pi0]

Summary

• Add requestWithURL(req, url) — creates a lightweight Proxy over a Request that overrides only the url property, avoiding new Request() allocation
• Add requestWithBaseURL(req, base) — strips a base path prefix from the request URL using requestWithURL
• Uses a shared ProxyHandler with a WeakMap for per-proxy URL storage to minimize allocations
• H3.mount() now uses requestWithBaseURL instead of new Request(url, event.req)
• Both utils are exported as public API

Test plan

• Unit tests for requestWithURL (url override, method/headers preserved, instanceof Request, clone())
• Unit tests for requestWithBaseURL (base stripping, root fallback, query string preservation)
• Existing mount.test.ts passes with the refactored implementation

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Added two new lightweight request utilities for URL manipulation: one for direct URL overrides and another for base path adjustments, both designed to avoid unnecessary request cloning.

• Documentation

  • Added documentation for the new request utilities.

• Tests

  • Added comprehensive unit tests covering the new request utilities.

[coderabbitai]

📝 Walkthrough

Walkthrough

This pull request introduces two new utility functions—requestWithURL and requestWithBaseURL—that create lightweight request proxies without cloning the original request object. The changes include the core implementation, integration into the h3 middleware routing, public API exports, comprehensive unit tests, and documentation.

Changes

Cohort / File(s)	Summary
Core Implementation src/utils/request.ts	Adds requestWithURL and requestWithBaseURL functions using a proxy-based mechanism to override request URLs without cloning; includes URL override map and proxy handler logic.
Integration & Exports src/h3.ts, src/index.ts	Refactors mounted middleware to use requestWithBaseURL instead of creating a new Request; exports both new functions from the main entry point.
Testing & Documentation test/unit/request.test.ts, test/unit/package.test.ts, docs/2.utils/1.request.md	Adds 77 lines of unit tests covering URL override behavior, pathname stripping, and proxy cloning; updates export snapshot; documents the new utilities.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 Two lightweight proxies hop into the fray,
No cloning needed—just URLs at play,
Base paths stripped with elegant grace,
Light as a carrot, quick as a race! 🥕✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Title check	✅ Passed	The title accurately describes the main change: adding two new request URL utilities (requestWithURL and requestWithBaseURL) and using them to optimize mounting logic.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feat/req-base

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/h3@1342

commit: 24b9271