refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit - #5071

Closed
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf
Closed

refactor(router-core): defaultParseSearch,defaultStringifySearch better performance w/ early json exit#5071
Sheraff wants to merge 1 commit into
mainfrom
refactor-router-core-stringify-parse-search-json-perf

Conversation

@Sheraff

@SheraffSheraff commented Sep 2, 2025

Copy link
Copy Markdown
Collaborator

Improve performance of defaultParseSearch and defaultStringifySearch by skipping calling JSON.parse if we know from the 1 char that it cannot be a valid JSON string.

 ✓ @tanstack/router-core tests/searchParams.bench.ts > defaultStringifySearch 1209ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 10,257.92 0.0593 0.7257 0.0975 0.0795 0.3030 0.3619 0.5785 ±1.95% 5130 fastest
· old 7,636.79 0.0823 0.6418 0.1309 0.1065 0.3945 0.4503 0.5691 ±2.13% 3819
✓ @tanstack/router-core tests/searchParams.bench.ts > defaultParseSearch 1208ms
name hz min max mean p75 p99 p995 p999 rme samples
· new 9,709.41 0.0896 0.3881 0.1030 0.1000 0.2121 0.2446 0.2928 ±0.60% 4855 fastest
· old 7,832.70 0.1157 0.3793 0.1277 0.1280 0.2366 0.2919 0.3616 ±0.50% 3917
BENCH Summary
@tanstack/router-core new - tests/searchParams.bench.ts > defaultStringifySearch
1.34x faster than old
@tanstack/router-core new - tests/searchParams.bench.ts > defaultParseSearch
1.24x faster than old

Summary by CodeRabbit

  • Bug Fixes
    • Improved reliability of search parameter parsing and stringifying.
    • Only treats values as JSON when they appear JSON-like, preventing unintended parsing.
    • Preserves plain strings and reduces unexpected value transformations.
    • Lowers risk of errors or crashes when handling non-JSON values in URLs.
  • Refactor
    • Internal logic streamlined to safely apply parsers without altering public APIs.

@coderabbitai

coderabbitaiBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

Walkthrough

Updates search param parsing/stringifying to avoid unconditional JSON.parse. Introduces an internal looksLikeJson helper. parseSearchWith and stringifySearchWith now apply JSON.parse only to values that appear JSON-like; otherwise, values are passed through or to provided parsers. Public API remains unchanged.

Changes

Cohort / File(s)Summary
Search params JSON-guarding
packages/router-core/src/searchParams.ts
Added non-exported looksLikeJson helper; updated parseSearchWith/stringifySearchWith to conditionally use JSON.parse only for JSON-like strings; preserved existing public signatures.

Sequence Diagram(s)

sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: parseSearchWith flow (per value)
Caller->>SP: parseSearchWith(value, parser)
SP->>SP: isJsonParser = (parser === JSON.parse)
alt value is string
SP->>LLJ: looksLikeJson(value)
alt isJsonParser AND looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: parsed
SP-->>Caller: parsed
else isJsonParser AND NOT looksLikeJson
SP-->>Caller: value (string as-is)
else not JSON parser
SP->>SP: parser(value)
SP-->>Caller: result
end
else non-string
SP-->>Caller: value (unchanged)
end
Loading
sequenceDiagram
autonumber
actor Caller
participant SP as searchParams.ts
participant LLJ as looksLikeJson
participant JP as JSON.parse
Note over SP: stringifySearchWith flow (per value)
Caller->>SP: stringifySearchWith(value, parser)
alt parser exists
alt value is string
SP->>LLJ: looksLikeJson(value)
alt looksLikeJson
SP->>JP: JSON.parse(value)
JP-->>SP: obj
SP->>SP: parser(obj)
SP-->>Caller: string
else not JSON-like
SP-->>Caller: value (string as-is)
end
else non-string
SP->>SP: parser(value)
SP-->>Caller: string
end
else no parser
SP-->>Caller: default handling (unchanged)
end
Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested labels

package: router-core

Suggested reviewers

  • schiller-manuel
  • SeanCassiere

Poem

I sniff each query, whiskers twitch—
If strings look JSON, I flip the switch.
If not, I hop on, leaving plain text be,
Guarded parses set my data free.
Thump-thump! Safe paths I now traverse—
A bun who won’t let parsers curse. 🐇✨

✨ Finishing Touches
  • 📝 Generate Docstrings
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch refactor-router-core-stringify-parse-search-json-perf

🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR/Issue comments)

Type @coderabbitai help to get the list of available commands.

Other keywords and placeholders

  • Add @coderabbitai ignore or @coderabbit ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Status, Documentation and Community

  • Visit our Status Page to check the current availability of CodeRabbit.
  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@nx-cloud

nx-cloudBot commented Sep 2, 2025

Copy link
Copy Markdown
Contributor

View your CI Pipeline Execution ↗ for commit 2d473db

CommandStatusDurationResult
nx affected --targets=test:eslint,test:unit,tes...✅ Succeeded8m 46sView ↗
nx run-many --target=build --exclude=examples/*...✅ Succeeded1m 59sView ↗

☁️ Nx Cloud last updated this comment at 2026-05-03 23:14:54 UTC

@pkg-pr-new

pkg-pr-newBot commented Sep 2, 2025

Copy link
Copy Markdown
More templates

@tanstack/arktype-adapter

npm i https://pkg.pr.new/@tanstack/arktype-adapter@5071

@tanstack/eslint-plugin-router

npm i https://pkg.pr.new/@tanstack/eslint-plugin-router@5071

@tanstack/eslint-plugin-start

npm i https://pkg.pr.new/@tanstack/eslint-plugin-start@5071

@tanstack/history

npm i https://pkg.pr.new/@tanstack/history@5071

@tanstack/nitro-v2-vite-plugin

npm i https://pkg.pr.new/@tanstack/nitro-v2-vite-plugin@5071

@tanstack/react-router

npm i https://pkg.pr.new/@tanstack/react-router@5071

@tanstack/react-router-devtools

npm i https://pkg.pr.new/@tanstack/react-router-devtools@5071

@tanstack/react-router-ssr-query

npm i https://pkg.pr.new/@tanstack/react-router-ssr-query@5071

@tanstack/react-start

npm i https://pkg.pr.new/@tanstack/react-start@5071

@tanstack/react-start-client

npm i https://pkg.pr.new/@tanstack/react-start-client@5071

@tanstack/react-start-rsc

npm i https://pkg.pr.new/@tanstack/react-start-rsc@5071

@tanstack/react-start-server

npm i https://pkg.pr.new/@tanstack/react-start-server@5071

@tanstack/router-cli

npm i https://pkg.pr.new/@tanstack/router-cli@5071

@tanstack/router-core

npm i https://pkg.pr.new/@tanstack/router-core@5071

@tanstack/router-devtools

npm i https://pkg.pr.new/@tanstack/router-devtools@5071

@tanstack/router-devtools-core

npm i https://pkg.pr.new/@tanstack/router-devtools-core@5071

@tanstack/router-generator

npm i https://pkg.pr.new/@tanstack/router-generator@5071

@tanstack/router-plugin

npm i https://pkg.pr.new/@tanstack/router-plugin@5071

@tanstack/router-ssr-query-core

npm i https://pkg.pr.new/@tanstack/router-ssr-query-core@5071

@tanstack/router-utils

npm i https://pkg.pr.new/@tanstack/router-utils@5071

@tanstack/router-vite-plugin

npm i https://pkg.pr.new/@tanstack/router-vite-plugin@5071

@tanstack/solid-router

npm i https://pkg.pr.new/@tanstack/solid-router@5071

@tanstack/solid-router-devtools

npm i https://pkg.pr.new/@tanstack/solid-router-devtools@5071

@tanstack/solid-router-ssr-query

npm i https://pkg.pr.new/@tanstack/solid-router-ssr-query@5071

@tanstack/solid-start

npm i https://pkg.pr.new/@tanstack/solid-start@5071

@tanstack/solid-start-client

npm i https://pkg.pr.new/@tanstack/solid-start-client@5071

@tanstack/solid-start-server

npm i https://pkg.pr.new/@tanstack/solid-start-server@5071

@tanstack/start-client-core

npm i https://pkg.pr.new/@tanstack/start-client-core@5071

@tanstack/start-fn-stubs

npm i https://pkg.pr.new/@tanstack/start-fn-stubs@5071

@tanstack/start-plugin-core

npm i https://pkg.pr.new/@tanstack/start-plugin-core@5071

@tanstack/start-server-core

npm i https://pkg.pr.new/@tanstack/start-server-core@5071

@tanstack/start-static-server-functions

npm i https://pkg.pr.new/@tanstack/start-static-server-functions@5071

@tanstack/start-storage-context

npm i https://pkg.pr.new/@tanstack/start-storage-context@5071

@tanstack/valibot-adapter

npm i https://pkg.pr.new/@tanstack/valibot-adapter@5071

@tanstack/virtual-file-routes

npm i https://pkg.pr.new/@tanstack/virtual-file-routes@5071

@tanstack/vue-router

npm i https://pkg.pr.new/@tanstack/vue-router@5071

@tanstack/vue-router-devtools

npm i https://pkg.pr.new/@tanstack/vue-router-devtools@5071

@tanstack/vue-router-ssr-query

npm i https://pkg.pr.new/@tanstack/vue-router-ssr-query@5071

@tanstack/vue-start

npm i https://pkg.pr.new/@tanstack/vue-start@5071

@tanstack/vue-start-client

npm i https://pkg.pr.new/@tanstack/vue-start-client@5071

@tanstack/vue-start-server

npm i https://pkg.pr.new/@tanstack/vue-start-server@5071

@tanstack/zod-adapter

npm i https://pkg.pr.new/@tanstack/zod-adapter@5071

commit: 2d473db

@coderabbitaicoderabbitaiBot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (1)
packages/router-core/src/searchParams.ts (1)

51-63: Bug: stringify(val) double-quotes JSON-like strings and breaks round-trip typing.

When parser succeeds, you’re stringifying the original string instead of the parsed value. Example: "123" becomes ""123"" in the URL, and parses back to the string "123" instead of number 123. Same for "true"/"false". Use stringify(parser(val)).

Apply this diff:

 } else if (
hasParser &&
typeof val === 'string' &&
(!isJsonParser || looksLikeJson(val))
) {
try {
- // Check if it's a valid parseable string.- // If it is, then stringify it again.- parser(val)- return stringify(val)+ // If parseable, canonicalize by stringifying the parsed value.+ const parsed = parser!(val)+ return stringify(parsed)
} catch (_err) {
// silent
}
}
🧹 Nitpick comments (3)
packages/router-core/src/searchParams.ts (3)

22-25: Behavior change: strings with leading whitespace won’t be parsed.

looksLikeJson checks only the first char. Values like " 123", "\n[1]" are valid JSON for JSON.parse but will now be skipped and remain strings. Confirm this is acceptable, or trim leading whitespace in looksLikeJson (see suggestion below).


77-81: Doc fix: claim about “no false negatives” is inaccurate.

Leading whitespace produces false negatives with the current heuristic.

Apply this diff:

 /**
- * Fast check to see if the string is a likely to be a JSON value.- * It could return false positives (returned true but wasn't actually a json),- * but not false negatives (returned false but was actually a json).+ * Fast, conservative check to see if the string is likely a JSON value.+ * May return false positives (true but not actually JSON) and rare false negatives+ * (e.g. when the string starts with whitespace).
*/

82-95: Optional: skip leading whitespace in looksLikeJson to avoid false negatives.

Small loop; negligible cost, removes a class of surprises.

Apply this diff:

 function looksLikeJson(str: string): boolean {
- if (!str) return false- const c = str.charCodeAt(0)+ if (!str) return false+ // Skip leading whitespace: space(32), tab(9), lf(10), cr(13)+ let i = 0+ while (i < str.length) {+ const code = str.charCodeAt(i)+ if (code !== 32 && code !== 9 && code !== 10 && code !== 13) break+ i+++ }+ if (i >= str.length) return false+ const c = str.charCodeAt(i)
return (
c === 34 || // "
c === 123 || // {
c === 91 || // [
c === 45 || // -
(c >= 48 && c <= 57) || // 0-9
c === 116 || // t (true)
c === 102 || // f (false)
c === 110 // n (null)
)
}
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

💡 Knowledge Base configuration:

  • MCP integration is disabled by default for public repositories
  • Jira integration is disabled by default for public repositories
  • Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 3178314 and 5bbf768.

📒 Files selected for processing (1)
  • packages/router-core/src/searchParams.ts (4 hunks)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
  • GitHub Check: Preview
  • GitHub Check: Test
🔇 Additional comments (2)
packages/router-core/src/searchParams.ts (2)

11-11: LGTM: caching the JSON.parse identity.

Keeps the hot-path branch simple without re-checking inside the loop.


43-43: LGTM: parity with parse path.

Mirrors the parse side’s identity check and keeps the conditionals cheap.

@schiller-manuel
schiller-manuelforce-pushed the refactor-router-core-stringify-parse-search-json-perf branch from 5bbf768 to 2d473dbCompareMay 3, 2026 23:04
@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@github-actions

Copy link
Copy Markdown
Contributor

Bundle Size Benchmarks

  • Commit: ed3152af205e
  • Measured at: 2026-05-03T23:07:13.259Z
  • Baseline source: history:ed3152af205e
  • Dashboard: bundle-size history
ScenarioCurrent (gzip)Delta vs baselineRawBrotliTrend
react-router.minimal87.23 KiB+82 B (+0.09%)274.13 KiB75.91 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-router.full90.76 KiB+79 B (+0.09%)285.64 KiB78.83 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.minimal35.45 KiB+67 B (+0.18%)106.44 KiB31.89 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-router.full40.16 KiB+57 B (+0.14%)120.66 KiB36.14 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.minimal53.22 KiB+63 B (+0.12%)151.58 KiB47.81 KiB▁▁▁▁▁▁▁▁▁▁▁█
vue-router.full58.34 KiB+64 B (+0.11%)167.76 KiB52.24 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.minimal101.82 KiB+56 B (+0.05%)322.29 KiB88.06 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.full105.25 KiB+66 B (+0.06%)332.62 KiB90.99 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.minimal99.43 KiB+106 B (+0.10%)316.67 KiB85.54 KiB▁▁▁▁▁▁▁▁▁▁▁█
react-start.rsbuild.full102.73 KiB+98 B (+0.09%)327.11 KiB88.36 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.minimal49.47 KiB+77 B (+0.15%)152.27 KiB43.59 KiB▁▁▁▁▁▁▁▁▁▁▁█
solid-start.full55.25 KiB+51 B (+0.09%)169.18 KiB48.66 KiB▁▁▁▁▁▁▁▁▁▁▁█

Trend sparkline is historical gzip bytes ending with this PR measurement; lower is better.

@codspeed-hq

Copy link
Copy Markdown

Merging this PR will improve performance by 9.48%

⚠️Different runtime environments detected

Some benchmarks with significant performance changes were compared across different runtime environments,
which may affect the accuracy of the results.

Open the report in CodSpeed to investigate

⚡ 3 improved benchmarks
✅ 2 untouched benchmarks
⏩ 1 skipped benchmark1

Performance Changes

BenchmarkBASEHEADEfficiency
ssr request loop (vue)425.9 ms409.4 ms+4.01%
ssr request loop (solid)153.1 ms139.8 ms+9.48%
client-side navigation loop (react)55.5 ms52.2 ms+6.45%

Comparing refactor-router-core-stringify-parse-search-json-perf (2d473db) with main (ed3152a)

Open in CodSpeed

Footnotes

  1. 1 benchmark was skipped, so the baseline result was used instead. If it was deleted from the codebase, click here and archive it to remove it from the performance reports.

@LadyBluenotes

Copy link
Copy Markdown
Member

The JSON fast path is still useful, I think, but this branch misses valid JSON values with leading whitespace after URL decoding.

The updated implementation and regression coverage are now tracked in #7022, so I’m closing this older version as superseded :)

Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

@Sheraff@LadyBluenotes@brenelz