Repository navigation
Conversation
chargome
added this pull request to stack #25143
October 7, 2026 14:59
Member
Author
|
bugbot run |
Contributor
size-limit report 📦
|
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 7, 2026 15:19
217546f to
fa2f4e1
Compare
Member
Author
|
bugbot run |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 8, 2026 07:55
fa2f4e1 to
c617c75
Compare
Member
Author
|
bugbot run |
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 8, 2026 07:59
c617c75 to
ecb46df
Compare
Member
Author
|
bugbot run |
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 8, 2026 08:02
ecb46df to
8ead4b1
Compare
Member
Author
|
bugbot run |
Member
Author
|
bugbot run |
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 9, 2026 14:25
d3fd241 to
1ae9f0e
Compare
Member
Author
|
bugbot run |
Member
Author
|
bugbot run |
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 12, 2026 09:23
7c3abfc to
2358cdb
Compare
Member
Author
|
bugbot run |
There was a problem hiding this comment.
✅ Bugbot reviewed your changes and found no new issues!
Comment @cursor review or bugbot run to trigger another review on this PR
Reviewed by Cursor Bugbot for commit 2358cdb. Configure here.
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 12, 2026 09:55
2358cdb to
85c7756
Compare
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
4 times, most recently
from
October 12, 2026 11:59
426b7cb to
d62ddd3
Compare
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
5 times, most recently
from
October 12, 2026 14:27
669a79a to
e0b0cae
Compare
… the pageload A document that resumes a prerendered shell gets its sentry-trace tag with the resumed chunk, which lands in <body> after the SDK has usually already run. A pageload created at that point can only link the server trace. Continue whatever tag is in the document, last one wins, and when there is no tag, no Server-Timing trace and the document is still streaming, wait for the tag before creating the pageload span, bounded by DOMContentLoaded and a 10 second cap. The span's start is backdated to the time origin and its children come from the performance timeline, so it looks the same as before, only inside the server's trace. A client-side navigation during the wait starts the pageload with a fresh trace first, so the navigation is filed as its redirect instead of being the only record of the visit. Fixes #24944 Refs JS-3863 Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…a navigation A pageload that waits for its trace meta tag can be settled by a navigation, and a `popstate` has already changed the location by then. The browser SDK reads the location when the span starts, so the pageload got the URL of the navigation. Capture the document URL when the instrumentation sets up and put it on the span and the request data instead. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…ntions constants in the test Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
The Next.js routing instrumentation never flags a navigation as a redirect, so a navigation during the wait ends the pageload like any pageload it interrupts and starts its own trace, as it does today. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
…s on The wait exists for a document that resumes a prerendered shell, whose tag arrives with the resumed part. Without `cacheComponents` a tag is either in `<head>` from the start or never comes, so waiting only held the pageload back: fetches before the tag were not attached and the span ended earlier. The build now injects `_sentryCacheComponents`, and the client only waits when it is set. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
chargome
force-pushed
the
chargome/feat/nextjs-deferred-pageload-start
branch
from
October 13, 2026 08:49
9f0f16b to
c248cc5
Compare
chargome
commented
Oct 13, 2026
| * How long the pageload start may wait for the resumed part of a Cache Components document. The wait | ||
| * normally ends with `DOMContentLoaded`; the cap only matters for a response the server keeps open. | ||
| */ | ||
| const PAGELOAD_TRACE_META_TAG_TIMEOUT_MS = 10_000; |
Member
Author
There was a problem hiding this comment.
this one is arbitrarily chosen and should likely never be met in real world conditions
chargome
marked this pull request as ready for review
October 13, 2026 09:55
chargome
requested review from
nicohrubec and
s1gr1d
and removed request for
a team
October 13, 2026 09:55
s1gr1d
reviewed
Oct 13, 2026
Comment on lines
+49
to
+51
| if (instrumentPageLoad) { | ||
| client.on('startNavigationSpan', settlePendingPageloadWait); | ||
| } |
Member
There was a problem hiding this comment.
M: this hook is registered in afterAllSetup which runs later than setup (this is where the other browserTracingInstrumentation calls this hook).
Can we add an E2E test that clicks a link during a slow dynamic hole? I think that would catch it.
Because if we now have a navigation that starts during the waiting time (slow dynamic hole), we would get a navigation span before the pageload span. maybeEndActiveSpan() would probably cancel that. Definitely worth testing at least.
| const scope = getCurrentScope(); | ||
| const { normalizedRequest } = scope.getScopeData().sdkProcessingMetadata; | ||
| if (normalizedRequest) { | ||
| scope.setSDKProcessingMetadata({ normalizedRequest: { ...normalizedRequest, url: documentUrl } }); |
Member
There was a problem hiding this comment.
What do we get in the documentUrl? Does this need a check on dataCollection.urlQueryParams?
Member
Author
There was a problem hiding this comment.
I'll check again and guard it if needed
Comment on lines
+141
to
+147
| span.addLink({ | ||
| context: { | ||
| traceId: traceparent.traceId, | ||
| spanId: traceparent.parentSpanId, | ||
| traceFlags: traceparent.parentSampled ? TRACE_FLAG_SAMPLED : TRACE_FLAG_NONE, | ||
| }, | ||
| }); |
Member
There was a problem hiding this comment.
We should probably add a new link type for that. Maybe server_request?
Member
Author
There was a problem hiding this comment.
Adding the link is a very rare case do you think this is actually needed? What would we gain?
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Builds on #25141.
When a document resumes a prerendered shell, its
sentry-tracetag sits at the start of the resumed part, which arrives after the SDK has started. In a local demo six of seven visits found no tag at init, so the pageload could only link the server trace instead of joining it.The app router pageload now continues whatever tag is in the document, last one wins. In apps with
cacheComponentsenabled, if there is no tag, noServer-Timingtrace and the document is still streaming, it waits for the tag before creating the pageload span. Other apps keep the immediate start: withoutcacheComponentsa tag is either in<head>from the start or never comes, so waiting only held the pageload back. The wait ends atDOMContentLoadedor after 10 seconds. The span still starts at the time origin and gets its children from the performance timeline, so it looks the same as before, only inside the server's trace. No tag by the end of parsing means a fresh trace, which is the fully static case.A client-side navigation during the wait starts the pageload with a fresh trace first, so the navigation ends it like any pageload it interrupts, as today. Started later, the pageload would end the navigation span instead. The pageload keeps the URL the document was loaded with, even if the navigation already changed it.
Waiting was chosen over moving a started span to another trace. That needs core changes and does not work with span streaming once children are flushed. The cost: fetches, errors and clicks between SDK start and the resumed part are not attached to the pageload. The
Server-Timingfollow-ups (JS-3864, JS-3866) remove that window where the header can be set.Fixes #24944
🤖 Generated with Claude Code